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

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

下列類型的使用者可以執行此命令。
+ 管理員 (COs)

## 要求
<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)