As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Na CLI do CloudHSM, você pode executar comandos de duas maneiras diferentes: no modo de comando único e no modo interativo. O modo interativo foi projetado para usuários e o modo de comando único foi projetado para scripts.

**nota**  
Todos os comandos funcionam no modo interativo e no modo de comando único.

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

Use os comandos a seguir para iniciar o modo interativo da CLI do CloudHSM.

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

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

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

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

------

Ao usar a CLI no modo interativo, você pode fazer login em uma conta de usuário usando o comando do **login**.

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

Para listar todos os comandos da CLI do CloudHSM, execute o seguinte comando:

```
aws-cloudhsm > help
```

Para obter a sintaxe de um comando da CLI do CloudHSM, execute o seguinte comando:

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

Para obter uma lista de usuários no HSMs, digite**user list**.

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

Para encerrar sua sessão da CLI do CloudHSM, execute o seguinte comando:

```
aws-cloudhsm > quit
```

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

**nota**  
Ao usar o modo de comando único, você deve escapar de quaisquer caracteres especiais em variáveis de ambiente e argumentos de linha de comando que possam ser interpretados pelo seu shell.

Se você executar a CLI do CloudHSM usando o modo de comando único, precisará definir duas variáveis de ambiente para fornecer credenciais: CLOUDHSM\$1PIN e CLOUDHSM\$1ROLE:

```
$ export CLOUDHSM_ROLE=admin
```

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

Depois de fazer isso, você pode executar comandos usando as credenciais armazenadas em seu ambiente.

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