你当前正在访问 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"
下面是修改保护策略时要遵循的步骤的高级说明:
- 获取基本 SchedulePolicyObject 和基本 RetentionPolicyObject。 将它们存储在一些变量中。
- 根据要求设置计划和保留策略对象的不同参数。 例如- 在上面的示例脚本中,我们尝试设置每周保护策略。 因此,我们将计划频率更改为“每周”,并更新了计划运行时。 在保留策略对象中,我们更新了每周保留期,并设置正确的“已启用每周计划”标志。 如果要设置每日策略,请将“每日计划启用”标志设置为 true,并为其他对象参数分配适当的值。
- 获取要修改并将其存储在变量中的备份保护策略。 在上面的示例中,我们检索了名为“TestPolicy”的备份策略,我们希望对其进行修改。
- 使用修改后的计划策略对象和保留策略对象修改在步骤 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
下面是为每天修改多个备份的文件共享策略所要遵循的步骤的高级说明:
- 获取基本每小时 SchedulePolicyObject 和基本每小时 RetentionPolicyObject。 将它们存储在一些变量中。
- 根据要求设置计划和保留策略对象的不同参数。 例如- 在上面的示例脚本中,我们尝试设置要在其中运行计划的$timeZone,我们将设置每小时计划的开始时间,设置每小时间隔(以小时为单位),之后,备份将在运行计划的同一天(以小时为单位)重试。 接下来,我们将修改每日恢复点的保留设置。
- 获取要修改并将其存储在变量中的备份保护策略。 在上面的示例中,我们检索了名为“TestPolicy”的备份策略,我们希望对其进行修改。
- 使用修改后的计划策略对象和保留策略对象修改在步骤 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 |
输入
输出
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈