共用方式為


Get-AzKeyVaultManagedHsm

取得受控 HSM。

語法

Get-AzKeyVaultManagedHsm
   [[-Name] <String>]
   [[-ResourceGroupName] <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-Name] <String>
   [-Location] <String>
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]
Get-AzKeyVaultManagedHsm
   [-InRemovedState]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SubscriptionId <String>]
   [<CommonParameters>]

Description

Get-AzKeyVaultManagedHsm Cmdlet 會取得訂用帳戶中受控 HSM 的相關信息。 您可以檢視訂用帳戶中的所有受控 HSM 實例,或依資源群組或特定受控 HSM 篩選結果。 請注意,雖然當您取得單一受控 HSM 時,指定此 Cmdlet 的資源群組是選擇性的,但您應該這麼做以獲得更好的效能。

範例

範例 1:取得您目前訂用帳戶中的所有受控 HSM

Get-AzKeyVaultManagedHsm

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

此命令會取得您目前訂用帳戶中的所有受控 HSM。

範例 2:取得特定的受控 HSM

Get-AzKeyVaultManagedHsm -Name 'myhsm'

Name    Resource Group Name Location SKU        ProvisioningState Security Domain ActivationStatus
----    ------------------- -------- ---        ----------------- --------------------------------
myhsm   test-rg              eastus   StandardB1 Succeeded         Active

此命令會取得目前訂用帳戶中名為 myhsm 的受控 HSM。

範例 3:取得資源群組中的受控 HSM

Get-AzKeyVaultManagedHsm -ResourceGroupName 'myrg1'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

此命令會取得資源群組中名為 rmg1 的所有受控 HSM。

範例 4:使用篩選取得受控 HSM

Get-AzKeyVaultManagedHsm -Name 'myhsm*'

Name  Resource Group Name Location    SKU        ProvisioningState Security Domain ActivationStatus
----  ------------------- --------    ---        ----------------- --------------------------------
myhsm myrg1               eastus2euap StandardB1 Succeeded         Active

此命令會取得以 「myhsm」 開頭之訂用帳戶中的所有受控 HSM。

範例 5:列出已刪除的受控 HSM

Get-AzKeyVaultManagedHsm -InRemovedState

Name                     Location      DeletionDate           ScheduledPurgeDate    Purge Protection Enabled?
----                     --------      ------------           ------------------    -------------------------
xxxxxxxx-mhsm-4op2n2g4xe eastus2       12/30/2021 2:29:00 AM  3/30/2022 2:29:00 AM  True
xxxxxxx-mhsm-ertopo7tnxa westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM True
xxxxxxx-mhsm-gg66fgctz67 westus        12/29/2021 11:48:42 PM 3/29/2022 11:48:42 PM False
xxxxxxx-mhsm-2m5jiop6mfo westcentralus 12/30/2021 12:26:14 AM 3/30/2022 12:26:14 AM True

此命令會取得目前訂用帳戶中所有已刪除的受控 HSM。

參數

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InRemovedState

指定是否要在輸出中顯示先前已刪除的受控 HSM 集區。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Location

已刪除受控 HSM 集區的位置。

類型:String
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

HSM 名稱。 Cmdlet 會根據名稱和目前選取的環境建構 HSM 的 FQDN。

類型:String
別名:HsmName
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

-ResourceGroupName

指定與所查詢受控 HSM 相關聯的資源組名。

類型:String
Position:1
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:True

-SubscriptionId

訂用帳戶的識別碼。 根據預設,Cmdlet 會在目前內容中設定的訂用帳戶中執行。 如果使用者指定另一個訂用帳戶,則會在使用者指定的訂用帳戶中執行目前的 Cmdlet。 覆寫訂閱只會在目前 Cmdlet 的生命週期內生效。 它不會變更內容中的訂用帳戶,而且不會影響後續的 Cmdlet。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Tag

指定指定標籤的索引鍵和選擇性值,以篩選受管理的 HSM 清單。

類型:Hashtable
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

String

Hashtable

輸出

PSManagedHsm

PSDeletedManagedHsm

PSKeyVaultIdentityItem