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.

# Utiliser la CLI CloudHSM
<a name="cloudhsm_cli-getting-started-use"></a>

Utilisez les commandes suivantes pour démarrer et utiliser la CLI CloudHSM.

1. Utilisez la commande suivante pour démarrer la CLI CloudHSM.

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

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

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

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

------

1. Utilisez la commande **login** pour vous connecter au cluster. Tous les utilisateurs peuvent utiliser cette commande.

   La commande de l'exemple suivant se connecte à *admin*, qui est le compte [admin](understanding-users.md) par défaut. Vous définissez le mot de passe de l'utilisateur lors de l'[activation du cluster](activate-cluster.md).

   ```
   aws-cloudhsm > login --username admin --role admin
   ```

   Le système vous invite à saisir votre mot de passe. Vous entrez le mot de passe, et le résultat indique que la commande a été exécutée avec succès.

   ```
   Enter password:
   {
     "error_code": 0,
     "data": {
       "username": "admin",
       "role": "admin"
     }
   }
   ```

1. Exécutez la commande **user list** pour répertorier tous les utilisateurs du cluster.

   ```
   aws-cloudhsm > user list
   {
     "error_code": 0,
     "data": {
       "users": [
         {
           "username": "admin",
           "role": "admin",
           "locked": "false",
           "mfa": [],
           "cluster-coverage": "full"
         },
         {
           "username": "app_user",
           "role": "internal(APPLIANCE_USER)",
           "locked": "false",
           "mfa": [],
           "cluster-coverage": "full"
         }
       ]
     }
   }
   ```

1.  Utilisez **user create** pour créer un utilisateur CU nommé **example\$1user**. 

   Vous pouvez créer CUs parce que, lors d'une étape précédente, vous vous êtes connecté en tant qu'utilisateur administrateur. Seuls les utilisateurs administrateur peuvent effectuer des tâches de gestion des utilisateurs, telles que la création et la suppression d'utilisateurs et la modification des mots de passe des autres utilisateurs. 

   ```
   aws-cloudhsm > user create --username example_user --role crypto-user     
   Enter password:
   Confirm password:
   {
    "error_code": 0,
    "data": {
      "username": "example_user",
      "role": "crypto-user"
    }
   }
   ```

1.  Utilisez **user list** pour répertorier tous les utilisateurs du cluster. 

   ```
   aws-cloudhsm > user list
   {
     "error_code": 0,
     "data": {
       "users": [
         {
           "username": "admin",
           "role": "admin",
           "locked": "false",
           "mfa": [],
           "cluster-coverage": "full"
         },
         {
           "username": "example_user",
           "role": "crypto_user",
           "locked": "false",
           "mfa": [],
           "cluster-coverage": "full"
         },
         {
           "username": "app_user",
           "role": "internal(APPLIANCE_USER)",
           "locked": "false",
           "mfa": [],
           "cluster-coverage": "full"
         }
       ]
     }
   }
   ```

1. Utilisez la **logout** commande pour vous déconnecter du AWS CloudHSM cluster.

   ```
   aws-cloudhsm > logout
   {
     "error_code": 0,
     "data": "Logout successful"
   }
   ```

1. Utilisez la CLI pour exécuter la commande **quit**.

   ```
   aws-cloudhsm > quit
   ```