New-AzDataProtectionBackupVault

リファレンス

モジュール:: Az.DataProtection

リソースグループに属する BackupVault リソースを作成または更新します。

構文

New-AzDataProtectionBackupVault
   -ResourceGroupName <String>
   -VaultName <String>
   -Location <String>
   -StorageSetting <IStorageSetting[]>
   [-SubscriptionId <String>]
   [-ETag <String>]
   [-IdentityType <String>]
   [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
   [-ImmutabilityState <ImmutabilityState>]
   [-CrossRegionRestoreState <CrossRegionRestoreState>]
   [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
   [-SoftDeleteRetentionDurationInDay <Double>]
   [-SoftDeleteState <SoftDeleteState>]
   [-Tag <Hashtable>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-CmkEncryptionState <EncryptionState>]
   [-CmkInfrastructureEncryption <InfrastructureEncryptionState>]
   [-CmkIdentityType <IdentityType>]
   [-CmkUserAssignedIdentityId <String>]
   [-CmkEncryptionKeyUri <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

リソースグループに属する BackupVault リソースを作成または更新します。

例

例 1: 新しいバックアップコンテナーを作成する

$sub = "xxxx-xxxx-xxxxx"
$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
New-AzDataProtectionBackupVault -SubscriptionId $sub -ResourceGroupName sarath-rg -VaultName "MyVault" -StorageSetting $storagesetting -Location westus

ETag IdentityPrincipalId IdentityTenantId IdentityType Location Name    Type
---- ------------------- ---------------- ------------ -------- ----    ----
                                                       westus   MyVault Microsoft.DataProtection/backupVaults

このコマンドを実行すると、新しいバックアップコンテナーが作成されます。

例 2: ImmutabilityState、CrossSubscriptionRestoreState、論理的な削除設定を使用して新しいバックアップコンテナーを作成する

$sub = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
New-AzDataProtectionBackupVault -SubscriptionId $sub -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -Location westus -StorageSetting $storagesetting -CrossSubscriptionRestoreState Enabled -ImmutabilityState Unlocked -SoftDeleteRetentionDurationInDay 100 -SoftDeleteState On

ETag IdentityPrincipalId IdentityTenantId IdentityType Location Name    Type
---- ------------------- ---------------- ------------ -------- ----    ----
                                                       westus   MyVault Microsoft.DataProtection/backupVaults

このコマンドは、不変状態、サブスクリプション間の復元状態、作成時のコンテナーの論理的な削除設定を設定しながら、新しいバックアップコンテナーを作成します。

例 3: CMK を使用してバックアップコンテナーを作成する

$storagesetting = New-AzDataProtectionBackupVaultStorageSettingObject -DataStoreType VaultStore -Type LocallyRedundant
$userAssignedIdentity = @{
    "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami" = @{
        clientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        principalId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
    "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami2" = @{
        clientId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        principalId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    }
}

$cmkIdentityId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"

$cmkKeyUri = "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1"

New-AzDataProtectionBackupVault -SubscriptionId xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -Location "location" -StorageSetting $storagesetting -IdentityType UserAssigned -UserAssignedIdentity $userAssignedIdentity -CmkEncryptionState Enabled -CmkIdentityType UserAssigned -CmkUserAssignedIdentityId $cmkIdentityId -CmkEncryptionKeyUri $cmkKeyUri -CmkInfrastructureEncryption Enabled

Name      Location   IdentityType
--------  --------   ------------
vaultName location   UserAssigned

このコマンドにより、CMK 暗号化が有効なバックアップコンテナーが作成されます

パラメーター

-AsJob

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AzureMonitorAlertsForAllJobFailure

ジョブの失敗に関する組み込みの Azure Monitor アラートを有効または無効にするパラメーター。セキュリティアラートを無効にすることはできません。

型:	AlertsState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CmkEncryptionKeyUri

暗号化に使用する CMK キーのキー URI。キーの自動ローテーションを有効にするには、キー URI からバージョンコンポーネントを除外します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CmkEncryptionState

Backup Vault の CMK 暗号化状態を有効にします。

型:	EncryptionState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CmkIdentityType

CMK 暗号化に使用する ID の種類 ( SystemAssigned または UserAssigned ID)。

型:	IdentityType
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CmkInfrastructureEncryption

このコンテナーで CMK を使用してインフラストラクチャ暗号化を有効にします。インフラストラクチャの暗号化は、コンテナーの作成時にのみ構成する必要があります。

型:	InfrastructureEncryptionState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CmkUserAssignedIdentityId

ID の種類が UserAssigned の場合は、このパラメーターが必要です。 Key Vault へのアクセス許可を持つ、使用するユーザー割り当てマネージド ID を追加します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CrossRegionRestoreState

コンテナーのリージョン間の復元状態。使用できる値は無効、有効です。

型:	CrossRegionRestoreState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CrossSubscriptionRestoreState

コンテナーのサブスクリプション間の復元状態。使用できる値は Disabled、Enabled、PermanentlyDisabled です。

型:	CrossSubscriptionRestoreState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

型:	PSObject
Aliases:	AzureRMContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ETag

省略可能な ETag。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IdentityType

identityType は、"SystemAssigned"、"UserAssigned"、"SystemAssigned、UserAssigned"、"None" の値を受け取ることができます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IdentityUserAssignedIdentity

ユーザー割り当て ID を取得または設定します。

型:	Hashtable
Aliases:	UserAssignedIdentity
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ImmutabilityState

コンテナーの不変状態。使用できる値は Disabled、Unlocked、Locked です。

型:	ImmutabilityState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Location

リソースの場所。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NoWait

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ResourceGroupName

バックアップコンテナーのリソースグループ名

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SoftDeleteRetentionDurationInDay

論理的な削除の保持期間 (日数)

型:	Double
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SoftDeleteState

コンテナーの論理的な削除状態。使用できる値は Off、On、AlwaysOn です

型:	SoftDeleteState
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageSetting

コンテナーのストレージ設定。 New-AzDataProtectionBackupVaultStorageSetting コマンドレットを使用して作成します。構築するには、STORAGESETTING プロパティの NOTES セクションを参照し、ハッシュテーブルを作成します。

型:	IStorageSetting[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

コンテナーのサブスクリプション ID

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Tag

リソースタグ。

型:	Hashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VaultName

バックアップコンテナーの名前

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

PSObject

次の方法で共有

New-AzDataProtectionBackupVault

構文

説明

例

例 1: 新しいバックアップコンテナーを作成する

例 2: ImmutabilityState、CrossSubscriptionRestoreState、論理的な削除設定を使用して新しいバックアップコンテナーを作成する

例 3: CMK を使用してバックアップコンテナーを作成する

パラメーター

-AsJob

-AzureMonitorAlertsForAllJobFailure

-CmkEncryptionKeyUri

-CmkEncryptionState

-CmkIdentityType

-CmkInfrastructureEncryption

-CmkUserAssignedIdentityId

-Confirm

-CrossRegionRestoreState

-CrossSubscriptionRestoreState

-DefaultProfile

-ETag

-IdentityType

-IdentityUserAssignedIdentity

-ImmutabilityState

-Location

-NoWait

-ResourceGroupName

-SoftDeleteRetentionDurationInDay

-SoftDeleteState

-StorageSetting

-SubscriptionId

-Tag

-VaultName

-WhatIf

出力

その他のリソース

次の方法で共有

New-AzDataProtectionBackupVault

構文

説明

例

例 1: 新しいバックアップ コンテナーを作成する

例 2: ImmutabilityState、CrossSubscriptionRestoreState、論理的な削除設定を使用して新しいバックアップ コンテナーを作成する

例 3: CMK を使用してバックアップ コンテナーを作成する

パラメーター

-AsJob

-AzureMonitorAlertsForAllJobFailure

-CmkEncryptionKeyUri

-CmkEncryptionState

-CmkIdentityType

-CmkInfrastructureEncryption

-CmkUserAssignedIdentityId

-Confirm

-CrossRegionRestoreState

-CrossSubscriptionRestoreState

-DefaultProfile

-ETag

-IdentityType

-IdentityUserAssignedIdentity

-ImmutabilityState

-Location

-NoWait

-ResourceGroupName

-SoftDeleteRetentionDurationInDay

-SoftDeleteState

-StorageSetting

-SubscriptionId

-Tag

-VaultName

-WhatIf

出力

その他のリソース

例 1: 新しいバックアップコンテナーを作成する

例 2: ImmutabilityState、CrossSubscriptionRestoreState、論理的な削除設定を使用して新しいバックアップコンテナーを作成する

例 3: CMK を使用してバックアップコンテナーを作成する