你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzKeyVaultManagedHsm

参考

模块:: Az.KeyVault

获取托管 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>]

说明

Get-AzKeyVaultManagedHsm cmdlet 获取有关订阅中托管 HSM 的信息。可以查看订阅中的所有托管 HSM 实例，或按资源组或特定托管 HSM 筛选结果。请注意，尽管在获取单个托管 HSM 时指定资源组是可选的，但应该这样做以获得更好的性能。

示例

示例 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

此命令获取名为myg1的资源组中的所有托管 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

订阅 ID。默认情况下，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

通过