New-AzDataProtectionBackupVault

模組:: Az.DataProtection Module

建立或更新屬於資源群組的BackupVault資源。

語法

Default (預設值)

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>]

Description

建立或更新屬於資源群組的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

建立或更新屬於資源群組的BackupVault資源。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AzureMonitorAlertsForAllJobFailure

啟用或停用作業失敗內建 Azure 監視器警示的參數。無法停用安全性警示。

參數屬性

類型:	AlertsState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CmkEncryptionKeyUri

要用於加密之 CMK 金鑰的金鑰 URI。若要啟用金鑰的自動輪替，請從金鑰 URI 中排除版本元件。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CmkEncryptionState

啟用備份保存庫的 CMK 加密狀態。

參數屬性

類型:	EncryptionState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CmkIdentityType

要用於 CMK 加密的身分識別類型 - SystemAssigned 或 UserAssigned Identity。

參數屬性

類型:	IdentityType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CmkInfrastructureEncryption

在此保存庫上使用 CMK 啟用基礎結構加密。只有在建立保存庫時，才能設定基礎結構加密。

參數屬性

類型:	InfrastructureEncryptionState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CmkUserAssignedIdentityId

如果身分識別類型為UserAssigned，則需要此參數。新增使用者指派的受控識別標識碼，以用來具有 Key Vault 訪問許可權。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CrossRegionRestoreState

跨區域還原保存庫的狀態。允許的值為 Disabled、Enabled。

參數屬性

類型:	CrossRegionRestoreState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CrossSubscriptionRestoreState

保存庫的跨訂閱還原狀態。允許的值為 Disabled、Enabled、PermanentlyDisabled。

參數屬性

類型:	CrossSubscriptionRestoreState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

建立或更新屬於資源群組的BackupVault資源。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzureRMContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ETag

選擇性 ETag。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityType

identityType 可以採用值 - “SystemAssigned”、“UserAssigned”、“SystemAssigned、UserAssigned”、“None”。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IdentityUserAssignedIdentity

取得或設定使用者指派的身分識別。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	UserAssignedIdentity, 指派使用者身分識別

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ImmutabilityState

保存庫的不變性狀態。允許的值為 Disabled、Unlocked、Locked。

參數屬性

類型:	ImmutabilityState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Location

資源位置。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoWait

建立或更新屬於資源群組的BackupVault資源。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ResourceGroupName

備份保存庫的資源群組名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SoftDeleteRetentionDurationInDay

虛刪除保留持續時間（以天為單位）

參數屬性

類型:	Double
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SoftDeleteState

保存庫的虛刪除狀態。允許的值為 Off、On、AlwaysOn

參數屬性

類型:	SoftDeleteState
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-StorageSetting

儲存庫的儲存設定。使用 New-AzDataProtectionBackupVaultStorageSetting Cmdlet 來建立。若要建構，請參閱 NOTES 一節，以取得 STORAGESETTING 屬性，並建立雜湊表。

參數屬性

類型:	IStorageSetting[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SubscriptionId

保存庫的訂閱標識碼

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tag

資源標籤。

參數屬性

類型:	Hashtable
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-VaultName

備份保存庫的名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

PSObject

意見反應

此頁面對您有幫助嗎？

共用方式為

New-AzDataProtectionBackupVault

語法

Default (預設值)

Description

範例

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