기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

**참고**  
단일 명령 모드를 사용하는 경우 쉘에서 해석할 수 있는 환경 변수 및 명령줄 인수의 특수 문자를 이스케이프 처리해야 합니다.

단일 명령 모드를 사용하여 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"
    }
}
```