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

Update-AzDataProtectionBackupInstance

模块:: Az.DataProtection Module

更新给定的备份实例

语法

Default (默认值)

Update-AzDataProtectionBackupInstance
    -ResourceGroupName <String>
    -VaultName <String>
    -BackupInstanceName <String>
    [-SubscriptionId <String>]
    [-PolicyId <String>]
    [-UseSystemAssignedIdentity <Boolean>]
    [-UserAssignedIdentityArmId <String>]
    [-VaultedBackupContainer <String[]>]
    [-ResourceGuardOperationRequest <String[]>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新给定的备份实例

示例

示例 1：更新 Blob 备份实例保管库策略和容器列表

$instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription $subscriptionId -ResourceGroup $resourceGroupName -Vault $vaultName -DatasourceType AzureBlob
$updatePolicy = Get-AzDataProtectionBackupPolicy -SubscriptionId $subscriptionId -VaultName $vaultName -ResourceGroupName $resourceGroupName| Where-Object { $_.name -eq "vaulted-policy" }
$backedUpContainers = $instance.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList
$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName $resourceGroupName -VaultName $vaultName -BackupInstanceName $instance.Name -SubscriptionId $subscriptionId -PolicyId $updatePolicy.Id -VaultedBackupContainer $backedUpContainers[0,2,4]
$updateBI.Property.PolicyInfo.PolicyId
$updateBI.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList

/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rgName/providers/Microsoft.DataProtection/backupVaults/vaultName/backupPolicies/vaulted-policy
updatedContainer1
updatedContainer2
updatedContainer3

第一个命令提取需要更新的备份实例。第二个命令获取名为 Vaulted 策略的备份策略，该策略需要在备份实例中更新。第三个命令提取备份保管库中当前备份的保管库容器列表。第四个命令使用新的策略和新容器列表（当前是现有备份容器的子集）更新备份实例。第五个和第六个命令显示备份实例中更新的策略和容器列表。

示例 2：更新备份实例中的 UAMI

$bi = Get-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -BackupInstanceName $bi.Name -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -UserAssignedIdentityArmId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUami" -UseSystemAssignedIdentity $false

Name                                                   BackupInstanceName
----                                                   ------------------
psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027 psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027

第一个命令提取需要更新的备份实例。第二个命令使用新的用户分配的托管标识（UAMI）更新备份实例，并禁用使用系统分配的标识。

参数

-AsJob

更新给定的备份实例

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BackupInstanceName

受保护备份实例的唯一名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

更新给定的备份实例

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NoWait

更新给定的备份实例

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PolicyId

要与备份实例关联的策略的 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

备份保管库的资源组

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGuardOperationRequest

资源防护作请求的格式类似于 <ResourceGuard-ARMID>/dppModifyPolicy/default。当作受 MUA 保护时，请使用此参数。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SecureToken

用于授权受跨租户资源防护保护的作的参数。使用命令（Get-AzAccessToken -TenantId“xxxxxxxx-xxxx-xxxx-xxxx-xxx -AsSecureString”）。用于获取不同租户的授权令牌的令牌。

参数属性

类型:	SecureString
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SubscriptionId

保管库的订阅 ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Token

参数已弃用。请改用 SecureToken。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserAssignedIdentityArmId

用户分配的标识 ARM ID

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	AssignUserIdentity

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UseSystemAssignedIdentity

使用系统分配的标识

参数属性

类型:	Nullable<T>[Boolean]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-VaultedBackupContainer

要备份到 VaultStore 中的容器列表。将此参数用于 DatasourceType AzureBlob 和 AzureDataLakeStorage。

参数属性

类型:	String[]
默认值:	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。

输出

IBackupInstanceResource

反馈

此页面是否有帮助？

通过

Update-AzDataProtectionBackupInstance

语法

Default (默认值)

说明

示例

示例 1：更新 Blob 备份实例保管库策略和容器列表

示例 2：更新备份实例中的 UAMI

参数

-AsJob

参数属性

参数集

-BackupInstanceName

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-NoWait

参数属性

参数集

-PolicyId

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-ResourceGuardOperationRequest

参数属性

参数集

-SecureToken

参数属性

参数集

-SubscriptionId

参数属性

参数集

-Token

参数属性

参数集

-UserAssignedIdentityArmId

参数属性

参数集

-UseSystemAssignedIdentity

参数属性

参数集

-VaultedBackupContainer

参数属性

参数集

-VaultName

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输出

IBackupInstanceResource

反馈