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

Update-AzDataProtectionBackupInstance

参考

模块:: Az.DataProtection

更新给定的备份实例

语法

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 策略的备份策略，该策略需要在备份实例中更新。第三个命令提取备份保管库中当前备份的保管库容器列表。第四个命令使用新的策略和新容器列表（当前是现有备份容器的子集）更新备份实例。第五个和第六个命令显示 backu 实例中更新的策略和容器列表。

示例 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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BackupInstanceName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoWait

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PolicyId

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

备份保管库的资源组

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGuardOperationRequest

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SecureToken

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

类型:	SecureString
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionId

保管库的订阅 ID

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Token

用于授权受跨租户资源防护保护的操作的参数。使用命令（Get-AzAccessToken -TenantId“xxxxxxxx-xxxx-xxxx-xxxx-xxx -AsSecureString”）。用于提取不同租户的安全授权令牌的令牌，然后使用 ConvertFrom-SecureString cmdlet 转换为字符串。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserAssignedIdentityArmId

用户分配的标识 ARM ID

类型:	String
别名:	AssignUserIdentity
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseSystemAssignedIdentity

使用系统分配的标识

类型:	Nullable<T>[Boolean]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VaultedBackupContainer

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VaultName

备份保管库的名称

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

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

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IBackupInstanceResource

通过