New-AzKeyVaultManagedHsm

構文

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 コマンドレットは、指定されたリソース グループにマネージド HSM を作成します。 マネージド HSM でキーを追加、削除、または一覧表示するには、次の操作を行う必要があります。

1. 管理者にユーザー ID を追加してアクセス許可を付与する。
2. "Managed HSM Crypto User" などのユーザーにロールの割り当てを追加する。
3. 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

このコマンドは、myhsm という名前のマネージド HSM を eastus2euap という場所に作成します。 このコマンドは、myrg1 という名前のリソース グループにマネージド HSM を追加します。 コマンドは SKU パラメーターの値を指定しないため、Standard_B1マネージド HSM を作成します。

例 2: CustomB32 マネージド 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 を作成します。 ただし、CustomB32 マネージド HSM を作成するために、 SKU パラメーターに CustomB32 の値を指定します。

例 3: ユーザー割り当て ID を使用してマネージド 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

このコマンドは、ユーザー割り当て ID を持つマネージド HSM を作成します。

パラメーター

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

入力

String

String[]

Hashtable

出力

PSManagedHsm

関連リンク

• Get-AzKeyVaultManagedHsm
• Remove-AzKeyVaultManagedHsm
• Update-AzKeyVaultManagedHsm
• Undo-AzKeyVaultManagedHsmRemoval