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

Set-AzRecoveryServicesBackupProtectionPolicy

修改备份保护策略。

语法

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackupSnapshotResourceGroupSuffix

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FixForInconsistentItems

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MoveToArchiveTier

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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

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

Type:PolicyBase
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RetentionPolicy

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

Type:RetentionPolicyBase
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SchedulePolicy

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

Type:SchedulePolicyBase
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotConsistencyType

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

Type:SnapshotConsistencyType
Accepted values:Default, OnlyCrashConsistent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDuration

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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDurationType

指定 TierAfterDuration 是天数还是月份

Type:String
Accepted values:Days, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TieringMode

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

Type:TieringMode
Accepted values:TierRecommended, TierAllEligible
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Token

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

恢复服务保管库的 ARM ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PolicyBase

String

输出

JobBase