Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modes de commande dans la CLI CloudHSM
<a name="cloudhsm_cli-modes"></a>

Dans la CLI CloudHSM, vous pouvez exécuter des commandes de deux manières différentes : en mode commande unique et en mode interactif. Le mode interactif est conçu pour les utilisateurs et le mode commande unique est conçu pour les scripts.

**Note**  
Toutes les commandes fonctionnent en mode interactif et en mode commande unique.

## Mode interactif
<a name="cloudhsm_cli-mode-interactive"></a>

Utilisez les commandes suivantes pour démarrer le mode interactif de la CLI CloudHSM

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

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

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

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

------

Lorsque vous utilisez la CLI en mode interactif, vous pouvez vous connecter à un compte utilisateur à l'aide de la commande **login**.

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

Pour afficher toutes les commandes de la CLI CloudHSM, exécutez la commande suivante :

```
aws-cloudhsm > help
```

Pour obtenir la syntaxe d'une commande de la CLI CloudHSM, exécutez la commande suivante :

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

Pour obtenir la liste des utilisateurs du HSMs, entrez**user list**.

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

Pour terminer votre session dans la CLI CloudHSM, exécutez la commande suivante :

```
aws-cloudhsm > quit
```

## Mode commande unique
<a name="cloudhsm_cli-mode-single-command"></a>

**Note**  
Lorsque vous utilisez le mode commande unique, vous devez éviter tout caractère spécial dans les variables d'environnement et les arguments de ligne de commande susceptibles d'être interprétés par votre interpréteur de commandes.

Si vous exécutez la CLI CloudHSM en mode commande unique, vous devez définir deux variables d'environnement pour fournir des informations d'identification : CLOUDHSM\$1PIN et CLOUDHSM\$1ROLE :

```
$ export CLOUDHSM_ROLE=admin
```

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

Ensuite, vous pouvez exécuter des commandes à l'aide des informations d'identification stockées dans votre environnement.

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