

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CloudHSM CLI のコマンドモード
<a name="cloudhsm_cli-modes"></a>

CloudHSM CLI では、シングルコマンドモードおよびインタラクティブモードの 2 つの方法でコマンドを実行できます。インタラクティブモードはユーザー向けに設計され、シングルコマンドモードはスクリプト向けに設計されています。

**注記**  
すべてのコマンドはインタラクティブモードおよびシングルコマンドモードで動作します。

## インタラクティブモード
<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>

**注記**  
単一コマンドモードを使用する場合は、シェルによって解釈される可能性のある環境変数とコマンドライン引数の特殊文字をエスケープする必要があります。

シングルコマンドモードを使用して CloudHSM CLI を実行する場合、認証情報を提供するために CLOUDHSM\$1PIN と CLOUDHSM\$1ROLE という 2 つの環境変数を設定する必要があります。

```
$ 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"
    }
}
```