本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 CloudHSM CLI
<a name="cloudhsm_cli-getting-started-use"></a>

使用下列命令來啟動和使用 CloudHSM CLI。

1. 使用下列命令來啟動 CloudHSM CLI。

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

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

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

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

------

1. 使用 **login** 命令登入叢集。所有使用者都可以使用此命令。

   以下範例中的命令將 *admin* 登入，這是預設的[管理員](understanding-users.md)賬戶。您已在[啟用叢集](activate-cluster.md)時設定此使用者的密碼。

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

   系統會提示您輸入密碼。您輸入密碼，然後輸出顯示命令已成功。

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

1. 執行 **user list** 命令以列出叢集上的所有使用者。

   ```
   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.  用於 **user create** 建立名為 **example\$1user** 的 CU 使用者。

   您可以建立 CU，因為在上一個步驟中，您以系統管理員使用者身分登入。只有管理員使用者可以執行使用者管理工作，例如建立和刪除使用者，以及變更其他使用者的密碼。

   ```
   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.  用 **user list** 來列出叢集上的所有使用者。

   ```
   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. 使用 **logout**命令登出 AWS CloudHSM 叢集。

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

1. 使用 **quit** 命令停止 CLI。

   ```
   aws-cloudhsm > quit
   ```