本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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>
```

要在上获取用户列表 HSMs，请输入**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"
    }
}
```