Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Modos de comando en la CLI de CloudHSM
<a name="cloudhsm_cli-modes"></a>

En la CLI de CloudHSM, puede ejecutar comandos de dos maneras diferentes: en modo de comando único y en modo interactivo. El modo interactivo está diseñado para los usuarios y el modo de comando único está diseñado para los scripts.

**nota**  
Todos los comandos funcionan en modo interactivo y en modo de comando único.

## Modo interactivo
<a name="cloudhsm_cli-mode-interactive"></a>

Use los siguientes comandos para iniciar el modo interactivo de la CLI de CloudHSM.

------
#### [ Linux ]

```
$ /opt/cloudhsm/bin/cloudhsm-cli interactive
```

------
#### [ Windows ]

```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\bin\cloudhsm-cli.exe" interactive
```

------

Al utilizar la CLI en modo interactivo, puede iniciar sesión en una cuenta de usuario mediante el comando **login**.

```
aws-cloudhsm > login --username <USERNAME> --role ROLE>
```

Para mostrar una lista de todos los comandos de la CLI de CloudHSM, ejecute el comando siguiente:

```
aws-cloudhsm > help
```

Para obtener la sintaxis de un comando de la CLI de CloudHSM, ejecute el siguiente comando:

```
aws-cloudhsm >  help <command-name>
```

Para obtener una lista de los usuarios de HSMs, introduzca**user list**.

```
aws-cloudhsm > user list
```

Para finalizar la sesión de la CLI de CloudHSM, ejecute el comando siguiente:

```
aws-cloudhsm > quit
```

## Modo de comando único
<a name="cloudhsm_cli-mode-single-command"></a>

**nota**  
Cuando utilice el modo de comando único, debe evitar cualquier carácter especial de las variables de entorno y los argumentos de la línea de comandos que pueda interpretar el shell.

Si ejecuta la CLI de CloudHSM mediante el modo de comando único, debe configurar dos variables de entorno para proporcionar las credenciales: CLOUDHSM\$1PIN y CLOUDHSM\$1ROLE:

```
$ export CLOUDHSM_ROLE=admin
```

```
$ export CLOUDHSM_PIN=admin_username:admin_password
```

Después de hacer esto, puede ejecutar comandos con las credenciales almacenadas en su entorno.

```
$ cloudhsm-cli user change-password --username alice --role crypto-user
Enter password:
Confirm password:
{
    "error_code": 0,
    "data": {
      "username": "alice",
      "role": "crypto-user"
    }
}
```