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

管理istrator にユーザー ID を追加してアクセス許可を付与する。
"Managed HSM Crypto User" などのユーザーにロールの割り当てを追加する。
を使用して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 を作成します。ただし、SKU パラメーターに CustomB32 の値を指定して、CustomB32 マネージド HSM を作成します。

例 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                               : 54826b22-38d6-4fb2-bad9-b7b93a3e9c5a
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

このマネージド HSM プールの初期管理者オブジェクト ID。

Type:	String[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

バックグラウンドでコマンドレットを実行する

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnablePurgeProtection

このマネージド HSM プールに対して消去に対する保護を有効にするかどうかを指定します。この設定は、論理的な削除も有効になっている場合にのみ有効です。この機能を有効にすることは元に戻すことはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

キーコンテナーを作成する Azure リージョンを指定します。選択内容を確認するには、ProviderNamespace パラメーターを指定して Get-AzResourceProvider コマンドを使用します。

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

作成するマネージド HSM の名前を指定します。名前は、文字、数字、またはハイフンの任意の組み合わせにすることができます。名前の先頭と末尾は文字または数字にする必要があります。名前は汎用一意である必要があります。

Type:	String
Aliases:	HsmName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicNetworkAccess

プライベートエンドポイントが有効になっている間にパブリックネットワークから送信されるデータプレーントラフィックのアクセス許可を制御します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

キーコンテナーを作成する既存のリソースグループの名前を指定します。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Sku

マネージド HSM インスタンスの SKU を指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SoftDeleteRetentionInDays

削除されたマネージド HSM プールを保持する期間と、削除された状態のマネージド HSM プールを消去できる期間を指定します。

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

サブスクリプションの ID です。既定では、コマンドレットは現在のコンテキストで設定されているサブスクリプションで実行されます。ユーザーが別のサブスクリプションを指定した場合、現在のコマンドレットはユーザーが指定したサブスクリプションで実行されます。サブスクリプションのオーバーライドは、現在のコマンドレットのライフサイクル中にのみ有効になります。コンテキスト内のサブスクリプションは変更されず、後続のコマンドレットには影響しません。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

リソースタグを表すハッシュテーブル。

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UserAssignedIdentity

マネージド HSM に関連付けられているユーザー割り当て ID のセット。その値は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

String

String[]

Hashtable

出力

PSManagedHsm

New-AzKeyVaultManagedHsm

構文

説明

例

例 1: StandardB1 マネージド HSM を作成する

例 2: CustomB32 マネージド HSM を作成する

例 3: ユーザー割り当て ID を使用してマネージド HSM を作成する

パラメーター

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

入力

出力

フィードバック

その他のリソース

New-AzKeyVaultManagedHsm

構文

説明

例

例 1: StandardB1 マネージド HSM を作成する

例 2: CustomB32 マネージド HSM を作成する

例 3: ユーザー割り当て ID を使用してマネージド HSM を作成する

パラメーター

-Administrator

-AsJob

-Confirm

-DefaultProfile

-EnablePurgeProtection

-Location

-Name

-PublicNetworkAccess

-ResourceGroupName

-Sku

-SoftDeleteRetentionInDays

-SubscriptionId

-Tag

-UserAssignedIdentity

-WhatIf

入力

出力

関連リンク

フィードバック

その他のリソース