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

# 列出使用 KMU 的 AWS CloudHSM 所有使用者
<a name="key_mgmt_util-listUsers"></a>

使用 AWS CloudHSM key\_mgmt\_util 中的 **listUsers**命令，取得硬體安全模組 (HSM) 中的使用者及其使用者類型和其他屬性。

在 key\_mgmt\_util 中，listUsers 會傳回輸出，其代表叢集內的所有 HSM (即使不一致)。若要取得每個 HSM 中之使用者的相關資訊，請使用 cloudhsm\_mgmt\_util 中的 [listUsers](#key_mgmt_util-listUsers) 命令。

key\_mgmt\_util 中的使用者命令、**listUsers** 和 [getKeyInfo](key_mgmt_util-getKeyInfo.md) 是唯讀命令，加密使用者 (CU) 有權執行該命令。剩餘的使用者管理命令是 cloudhsm\_mgmt\_util 的一部分。由具有使用者管理許可的加密主管 (CO) 執行。

執行任何 key\_mgmt\_util 命令之前，您必須先[啟動 key\_mgmt\_util](key_mgmt_util-setup.md#key_mgmt_util-start) 並以加密使用者 (CU) 的身分[登入](key_mgmt_util-log-in.md) HSM。

## 語法
<a name="listUsers-syntax"></a>

```
listUsers 

listUsers -h
```

## 範例
<a name="listUsers-examples"></a>

此命令列出叢集內的 HSM 使用者及其屬性。您可以在其他命令中 (例如 [findKey](key_mgmt_util-findKey.md)、[getAttribut](key_mgmt_util-getAttribute.md) 和 [getKeyInfo](key_mgmt_util-getKeyInfo.md)) 使用 `User ID` 屬性來識別使用者。

```
Command:  listUsers

        Number Of Users found 4

        Index       User ID     User Type       User Name           MofnPubKey    LoginFailureCnt         2FA
        1                1      PCO             admin                     NO               0               NO
        2                2      AU              app_user                  NO               0               NO
        3                3      CU              alice                     YES              0               NO
        4                4      CU              bob                       NO               0               NO
        5                5      CU              trent                     YES              0               NO

        Cfm3ListUsers returned: 0x00 : HSM Return: SUCCESS
```

輸出包含下列使用者屬性：
+ **使用者 ID**：在 key\_mgmt\_util 和 [cloudhsm\_mgmt\_util](cloudhsm_mgmt_util.md) 命令中識別使用者。
+ [使用者類型](understanding-users-cmu.md)：決定使用者在 HSM 上可執行的操作。
+ **使用者名稱**：顯示使用者定義的使用者易記名稱。
+ **MofnPubKey**：指出使用者是否已註冊金鑰對來簽署[仲裁身分驗證權杖](quorum-authentication.md)。
+ **LoginFailureCnt**：表示使用者登入失敗的次數。
+ **2FA**：指出使用者已啟用多重要素驗證。

## Parameters
<a name="listUsers-parameters"></a>

**-h**  
顯示命令的說明。  
必要：是

## 相關主題
<a name="listUsers-seealso"></a>
+ cloudhsm\_mgmt\_util 中的 [listUsers](#key_mgmt_util-listUsers)
+ [findKey](key_mgmt_util-findKey.md)
+ [getAttribute](key_mgmt_util-getAttribute.md)
+ [getKeyInfo](key_mgmt_util-getKeyInfo.md)