通过

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

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
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureMonitorAlertsForAllJobFailure

用于启用或禁用内置 Azure Monitor 警报的参数，说明作业失败。 无法禁用安全警报。

类型:AlertsState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CmkEncryptionKeyUri

要用于加密的 CMK 密钥的密钥 URI。 若要启用密钥的自动轮换，请从密钥 URI 中排除版本组件。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CmkEncryptionState

为备份保管库启用 CMK 加密状态。

类型:EncryptionState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CmkIdentityType

用于 CMK 加密的标识类型 - SystemAssigned 或 UserAssigned Identity。

类型:IdentityType
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CmkInfrastructureEncryption

在此保管库上使用 CMK 启用基础结构加密。 仅当创建保管库时，才必须配置基础结构加密。

类型:InfrastructureEncryptionState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CmkUserAssignedIdentityId

如果标识类型为 UserAssigned，则此参数是必需的。 添加用户分配的托管标识 ID，用于对密钥库具有访问权限。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

类型:SwitchParameter
Aliases:cf
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CrossRegionRestoreState

保管库的跨区域还原状态。 允许的值为 Disabled、Enabled。

类型:CrossRegionRestoreState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-CrossSubscriptionRestoreState

保管库的跨订阅还原状态。 允许的值为 Disabled、Enabled、PermanentlyDisabled。

类型:CrossSubscriptionRestoreState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

类型:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ETag

可选 ETag。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityType

identityType 可以接受值 -“SystemAssigned”、“UserAssigned”、“SystemAssigned、UserAssigned”、“None”。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityUserAssignedIdentity

获取或设置用户分配的标识。

类型:Hashtable
Aliases:UserAssignedIdentity
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutabilityState

保管库的不可变状态。 允许的值为 Disabled、Unlocked、Locked。

类型:ImmutabilityState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

资源位置。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

类型:SwitchParameter
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

备份保管库的资源组名称

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftDeleteRetentionDurationInDay

软删除保留期（以天为单位）

类型:Double
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftDeleteState

保管库的软删除状态。 允许的值为 Off、On、AlwaysOn

类型:SoftDeleteState
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageSetting

保管库存储 设置。 使用 New-AzDataProtectionBackupVault存储Setting Cmdlet 创建。 若要构造，请参阅 STORAGE标准版TTING 属性并创建哈希表的 NOTES 部分。

类型:IStorageSetting[]
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

保管库的订阅 ID

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

资源标记。

类型:Hashtable
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultName

备份保管库的名称

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

类型:SwitchParameter
Aliases:wi
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

输出

PSObject