通过

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

Set-AzRecoveryServicesBackupProtectionPolicy

  • 参考
模块:
Az.RecoveryServices

修改备份保护策略。

语法

Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [-MoveToArchiveTier <Boolean>]
   [-TieringMode <TieringMode>]
   [-TierAfterDuration <Int32>]
   [-TierAfterDurationType <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [-FixForInconsistentItems]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-AzRecoveryServicesBackupProtectionPolicy cmdlet 修改现有的 Azure 备份保护策略。 可以修改备份计划和保留策略组件。 所做的任何更改都会影响与策略关联的项的备份和保留。 使用当前 cmdlet 之前，使用 Set-AzRecoveryServicesVaultContext cmdlet 设置保管库上下文。

示例

示例 1：修改备份保护策略

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM" 
$SchPol.ScheduleRunTimes.Clear()
$Time = Get-Date
$Time1 = Get-Date -Year $Time.Year -Month $Time.Month -Day $Time.Day -Hour $Time.Hour -Minute 0 -Second 0 -Millisecond 0
$Time1 = $Time1.ToUniversalTime()
$SchPol.ScheduleRunTimes.Add($Time1)
$SchPol.ScheduleRunFrequency.Clear
$SchPol.ScheduleRunDays.Add("Monday")
$SchPol.ScheduleRunFrequency="Weekly"
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM" 
$RetPol.IsDailyScheduleEnabled=$false
$RetPol.DailySchedule.DurationCountInDays = 0
$RetPol.IsWeeklyScheduleEnabled=$true 
$RetPol.WeeklySchedule.DaysOfTheWeek.Add("Monday")
$RetPol.WeeklySchedule.DurationCountInWeeks = 365
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "azurefiles" -Name "azurefilesvault"
$Pol= Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
$Pol.SnapshotRetentionInDays=5
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $Pol -SchedulePolicy $SchPol -RetentionPolicy $RetPol -BackupSnapshotResourceGroup "snapshotResourceGroupPrefix" -BackupSnapshotResourceGroupSuffix "snapshotResourceGroupSuffix"

下面是修改保护策略时要遵循的步骤的高级说明：

  1. 获取基本 SchedulePolicyObject 和基本 RetentionPolicyObject。 将它们存储在一些变量中。
  2. 根据要求设置计划和保留策略对象的不同参数。 例如- 在上面的示例脚本中，我们尝试设置每周保护策略。 因此，我们将计划频率更改为“每周”，并更新了计划运行时。 在保留策略对象中，我们更新了每周保留期，并设置正确的“已启用每周计划”标志。 如果要设置每日策略，请将“每日计划启用”标志设置为 true，并为其他对象参数分配适当的值。
  3. 获取要修改并将其存储在变量中的备份保护策略。 在上面的示例中，我们检索了名为“TestPolicy”的备份策略，我们希望对其进行修改。
  4. 使用修改后的计划策略对象和保留策略对象修改在步骤 3 中检索的备份保护策略。 我们使用 BackupSnapshotResourceGroup、BackupSnapshotResourceGroupSuffix 参数更新即时 IP 的快照资源组名称。

示例 2：每天修改多个备份的 Azure 文件共享策略

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$timeZone = Get-TimeZone
$schedulePolicy.ScheduleRunTimeZone = $timeZone.Id
$startTime = Get-Date -Date "2021-12-22T06:00:00.00+00:00"
$schedulePolicy.ScheduleWindowStartTime = $startTime.ToUniversalTime()
$schedulePolicy.ScheduleInterval = 6
$schedulePolicy.ScheduleWindowDuration = 14
$retentionPolicy.DailySchedule.DurationCountInDays = 6
$policy = Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $policy -VaultId $vault.ID -SchedulePolicy $schedulePolicy -RetentionPolicy $retentionPolicy

下面是为每天修改多个备份的文件共享策略所要遵循的步骤的高级说明：

  1. 获取基本每小时 SchedulePolicyObject 和基本每小时 RetentionPolicyObject。 将它们存储在一些变量中。
  2. 根据要求设置计划和保留策略对象的不同参数。 例如- 在上面的示例脚本中，我们尝试设置要在其中运行计划的$timeZone，我们将设置每小时计划的开始时间，设置每小时间隔（以小时为单位），之后，备份将在运行计划的同一天（以小时为单位）重试。 接下来，我们将修改每日恢复点的保留设置。
  3. 获取要修改并将其存储在变量中的备份保护策略。 在上面的示例中，我们检索了名为“TestPolicy”的备份策略，我们希望对其进行修改。
  4. 使用修改后的计划策略对象和保留策略对象修改在步骤 3 中检索的备份保护策略。

示例 3：修改 AzureWorkload 策略以启用存档智能分层

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days

此命令用于修改策略以启用策略$policy的存档智能分层，我们将 -MoveToArchiveTier 参数设置为$true以启用分层。 我们选择 TieringMode 为 TierAllEligible，在 TierAfterDuration 和 TierAfterDurationType 参数给出的特定持续时间后将所有符合条件的恢复点移动到存档。 若要将建议的恢复点移动到 AzureVM 的存档，请使用 TieringMode TierRecommended。

示例 4：在现有策略上禁用智能分层

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false

此命令用于禁用策略$policy的存档智能分层，我们将 -MoveToArchiveTier 参数设置为$false。 请注意，禁用存档智能分层可能会产生成本影响。

参数

-BackupSnapshotResourceGroup

自定义资源组名称，用于存储托管虚拟机的即时恢复点。 这是可选的

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

-BackupSnapshotResourceGroupSuffix

自定义资源组名称后缀，用于存储托管虚拟机的即时恢复点。 这是可选的

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

-Confirm

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

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-FixForInconsistentItems

切换参数，指示是否重试失败项的策略更新。

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

-MoveToArchiveTier

指定是否应按策略将恢复点移动到存档存储。 允许的值是$true，$false

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

-Policy

指定此 cmdlet 修改的备份保护策略。 若要获取 BackupProtectionPolicy 对象，请使用 Get-AzRecoveryServicesBackupProtectionPolicy cmdlet。

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

-RetentionPolicy

指定基本保留策略。 若要获取 RetentionPolicy 对象，请使用 Get-AzRecoveryServicesBackupRetentionPolicyObject cmdlet。

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

-SchedulePolicy

指定基本计划策略对象。 若要获取 SchedulePolicy 对象，请使用 Get-AzRecoveryServicesBackupSchedulePolicyObject 对象。

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

-SnapshotConsistencyType

要用于备份的快照一致性类型。 如果设置为 OnlyCrashConsistent，则所有关联的项都将具有崩溃一致的快照。 可能的值是 OnlyCrashConsistent，默认值

类型:SnapshotConsistencyType
接受的值:Default, OnlyCrashConsistent
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TierAfterDuration

指定恢复点开始移动到存档层之后的持续时间，值可以是几天或几个月。 仅适用于 TieringMode 为 TierAllEligible

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

-TierAfterDurationType

指定 TierAfterDuration 是天数还是月份

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

-TieringMode

指定是将推荐恢复点还是所有符合条件的恢复点移动到存档

类型:TieringMode
接受的值:TierRecommended, TierAllEligible
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Token

用于对资源防护订阅的关键操作进行身份验证的辅助访问令牌

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

-VaultId

恢复服务保管库的 ARM ID。

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

-WhatIf

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

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

输入

PolicyBase

String

输出

JobBase