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

# CloudHSM CLI를 사용하여 사용자 복제
<a name="cloudhsm_cli-user-replicate"></a>

CloudHSM CLI의 **user replicate** 명령을 사용하여 소스 AWS CloudHSM 클러스터에서 대상 AWS CloudHSM 클러스터로 사용자를 복제합니다.

## 사용자 유형
<a name="chsm-cli-user-replicate-user-type"></a>

다음 사용자 유형이 이 명령을 실행할 수 있습니다.
+ 관리자(CO)

## 요구 사항
<a name="cloudhsm_cli-user-replicate-requirements"></a>
+ 소스 및 대상 클러스터는 복제본이어야 합니다. 즉, 하나는 다른 백업에서 생성되었거나 둘 다 공통 백업에서 생성되었다는 의미입니다. 자세한 정보는 [백업에서 클러스터 생성](create-cluster-from-backup.md)을 참조하세요.
+ 이 명령을 실행하려면 소스 클러스터와 대상 클러스터 모두에서 관리자로 로그인해야 합니다.
  +  단일 명령 모드에서 명령은 CLOUDHSM\$1PIN 및 CLOUDHSM\$1ROLE 환경 변수를 사용하여 소스 클러스터에서 인증합니다. 자세한 정보는 [단일 명령 모드](cloudhsm_cli-modes.md#cloudhsm_cli-mode-single-command)을 참조하세요. 대상 클러스터에 대한 자격 증명을 제공하려면 DESTINATION\$1CLOUDHSM\$1PIN 및 DESTINATION\$1CLOUDHSM\$1ROLE이라는 두 가지 추가 환경 변수를 설정해야 합니다.

    ```
    $ export DESTINATION_CLOUDHSM_ROLE=<role>
    ```

    ```
    $ export DESTINATION_CLOUDHSM_PIN=<username:password>
    ```
  +  대화형 모드에서 사용자는 소스 클러스터와 대상 클러스터 모두에 명시적으로 로그인해야 합니다.

## 구문
<a name="chsm-cli-user-replicate-syntax"></a>

```
aws-cloudhsm > help user replicate
Replicate a user from a source to a destination cluster

Usage: user replicate --username <USERNAME> --role <ROLE> --source-cluster-id <SOURCE_CLUSTER_ID> --destination-cluster-id <DESTINATION_CLUSTER_ID>

Options:
      --username <USERNAME>
          Username of the user to replicate

      --role <ROLE>
          Role the user has in the cluster

          Possible values:
          - crypto-user: A CryptoUser has the ability to manage and use keys
          - admin:       An Admin has the ability to manage user accounts

      --source-cluster-id <SOURCE_CLUSTER_ID>
          Source cluster ID

      --destination-cluster-id <DESTINATION_CLUSTER_ID>
          Destination cluster ID

  -h, --help
          Print help (see a summary with '-h')
```

## 예제
<a name="chsm-cli-user-replicate-examples"></a>

**Example 예: 사용자 복제**  
이 명령은 소스 클러스터에서 복제된 대상 클러스터로 사용자를 복제합니다. 아래 예제는 두 클러스터 모두에서 관리자로 로그인했을 때의 출력을 보여줍니다.  

```
admin-user@cluster-1234abcdefg > user replicate \
      --username example-admin \
      --role admin \
      --source-cluster-id cluster-1234abcdefg \
      --destination-cluster-id cluster-2345bcdefgh
{
  "error_code": 0,
  "data": {
    "user": {
      "username": "example-admin",
      "role": "admin",
      "locked": "false",
      "mfa": [],
      "quorum": [],
      "cluster-coverage": "full"
    },
    "message": "Successfully replicated user"
  }
}
```

## 인수
<a name="user-replicate-arguments"></a>

***<USERNAME>***  
소스 클러스터에 복제할 사용자의 사용자 이름을 지정합니다.  
필수: 예

***<ROLE>***  
이 사용자에게 할당된 역할을 지정합니다. 이 파라미터는 필수 사항입니다. 유효값은 **admin**, **crypto-user**입니다.  
사용자 역할을 가져오려면 **user list** 명령을 사용합니다. HSM에서의 사용자 유형에 대한 자세한 내용은 [HSM 사용자 이해](manage-hsm-users.md)를 참조하십시오.  
필수 항목 여부: 예

***<SOURCE\$1CLUSTER\$1ID>***  
소스 클러스터 ID.  
필수 항목 여부: 예

***<DESTINATION\$1CLUSTER\$1ID>***  
대상 클러스터 ID.  
필수: 예

## 관련 주제
<a name="chsm-user-replicate-seealso"></a>
+ [CloudHSM CLI를 사용하여 여러 클러스터에 연결](cloudhsm_cli-configs-multi-cluster.md)