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

New-AzKeyVaultManagedHsm

参考

模块:: Az.KeyVault

创建托管 HSM。

语法

New-AzKeyVaultManagedHsm
   [-Name] <String>
   [-ResourceGroupName] <String>
   [-Location] <String>
   [-Administrator] <String[]>
   [-Sku <String>]
   -SoftDeleteRetentionInDays <Int32>
   [-PublicNetworkAccess <String>]
   [-EnablePurgeProtection]
   [-UserAssignedIdentity <String[]>]
   [-Tag <Hashtable>]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [-SubscriptionId <String>]
   [<CommonParameters>]

说明

New-AzKeyVaultManagedHsm cmdlet 在指定的资源组中创建托管 HSM。若要在托管 HSM 中添加、删除或列出密钥，用户应：

通过向管理员添加用户 ID 授予权限;
为用户添加角色分配，例如“托管 HSM 加密用户”等;
使用 Export-AzKeyVaultSecurityDomain.. 备份托管 HSM 的安全域数据。

示例

示例 1：创建 StandardB1 托管 HSM

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -SoftDeleteRetentionInDays 70

Name  Resource Group Name Location    SKU
----  ------------------- --------    ---
myhsm myrg1               eastus2euap StandardB1

此命令在 location eastus2euap 中创建名为 myhsm 的托管 HSM。该命令将托管 HSM 添加到名为myg1的资源组。由于该命令未指定 SKU 参数的值，因此会创建Standard_B1托管 HSM。

示例 2：创建自定义B32 托管 HSM

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -Sku 'CustomB32' -SoftDeleteRetentionInDays 70

Name  Resource Group Name Location    SKU

----  ------------------- --------    ---
myhsm myrg1               eastus2euap CustomB32

此命令将创建托管 HSM，就像前面的示例一样。但是，它指定 SKU 参数的 CustomB32 值以创建 CustomB32 托管 HSM。

示例 3：使用用户分配的标识创建托管 HSM

New-AzKeyVaultManagedHsm -Name 'myhsm' -ResourceGroupName 'myrg1' -Location 'eastus2euap' -Administrator "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"-SoftDeleteRetentionInDays 70 -UserAssignedIdentity /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName | Format-List

Managed HSM Name                        : myhsm
Resource Group Name                     : myrg1
Location                                : eastus2euap
Resource ID                             : /subscriptions/0b1f6471-1bf0-4dda-aec3-cb9272f09590/resourceGroups/bez-rg/pro
                                          viders/Microsoft.KeyVault/managedHSMs/bezmhsm
HSM Pool URI                            :
Tenant ID                               : 00001111-aaaa-2222-bbbb-3333cccc4444
Initial Admin Object Ids                : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
SKU                                     : StandardB1
Soft Delete Enabled?                    : True
Enabled Purge Protection?               : False
Soft Delete Retention Period (days)     : 70
Public Network Access                   : Enabled
IdentityType                            : UserAssigned
UserAssignedIdentities                  : /subscriptions/xxxx/resourceGroups/xxxx/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName
Provisioning State                      : Succeeded
Status Message                          : The Managed HSM is provisioned and ready to use.
Security Domain ActivationStatus        : Active
Security Domain ActivationStatusMessage : Your HSM has been activated and can be used for cryptographic operations.
Regions                                 : 
Tags

此命令使用用户分配的标识创建托管 HSM。

参数

-Administrator

此托管 HSM 池的初始管理员对象 ID。

类型:	String[]
Position:	3
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-AsJob

在后台运行 cmdlet

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnablePurgeProtection

指定是否为此托管 HSM 池启用了针对清除的保护。仅当启用软删除时，此设置才有效。启用此功能不可逆。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Location

指定要在其中创建密钥保管库的 Azure 区域。将命令 Get-AzResourceProvider 与 ProviderNamespace 参数一起使用以查看你的选择。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Name

指定要创建的托管 HSM 的名称。名称可以是字母、数字或连字符的任意组合。名称必须以字母或数字开头和结尾。名称必须全局唯一。

类型:	String
别名:	HsmName
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-PublicNetworkAccess

在启用专用终结点时控制来自公用网络的数据平面流量的权限。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定要在其中创建密钥保管库的现有资源组的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Sku

指定托管 HSM 实例的 SKU。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-SoftDeleteRetentionInDays

指定已删除的托管 hsm 池的保留时间，以及删除状态的托管 hsm 池可以清除多长时间。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SubscriptionId

订阅 ID。默认情况下，cmdlet 在当前上下文中设置的订阅中执行。如果用户指定另一个订阅，则当前 cmdlet 在用户指定的订阅中执行。重写订阅仅在当前 cmdlet 的生命周期内生效。它不会更改上下文中的订阅，并且不会影响后续 cmdlet。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Tag

表示资源标记的哈希表。

类型:	Hashtable
别名:	Tags
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-UserAssignedIdentity

与托管 HSM 关联的用户分配标识集。其值为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

String[]

Hashtable

输出

PSManagedHsm

通过