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

# CloudHSM CLI 中的命令模式
<a name="cloudhsm_cli-modes"></a>

在 CloudHSM CLI 中，您可以使用兩種不同的方式執行命令，分別是：單一命令模式和互動式模式。互動式模式專為使用者設計，而單一命令模式則是專為指令碼設計。

**注意**  
所有命令均在互動式模式和單一命令模式下工作。

## 互動式模式
<a name="cloudhsm_cli-mode-interactive"></a>

使用以下命令來啟動 CloudHSM CLI 互動式模式。

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

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

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

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

------

在互動式模式下使用 CLI 時，您可使用 **login** 命令登入使用者帳戶。

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

若要列出所有 CloudHSM CLI 命令，請執行以下命令：

```
aws-cloudhsm > help
```

若要取得某一 CloudHSM CLI 命令的語法，請執行以下命令：

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

若要取得 HSM 上的使用者清單，請輸入 **user list**。

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

若要結束 CloudHSM CLI 工作階段，請執行以下命令：

```
aws-cloudhsm > quit
```

## 單一命令模式
<a name="cloudhsm_cli-mode-single-command"></a>

**注意**  
使用單一命令模式時，您必須逸出環境變數中的任何特殊字元，以及可能由 shell 解譯的命令列引數。

如要在單一命令模式下執行 CloudHSM CLI，則需設定兩個環境變數以提供憑證：CLOUDHSM\$1PIN 和 CLOUDHSM\$1ROLE：

```
$ export CLOUDHSM_ROLE=admin
```

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

環境變數設定完成後，您可使用儲存在環境中的憑證來執行命令。

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