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 изменяет существующую политику защиты azure Backup. Вы можете изменить расписание резервного копирования и компоненты политики хранения. Все внесенные изменения влияют на резервное копирование и хранение элементов, связанных с политикой. Задайте контекст хранилища с помощью командлета Set-AzRecoveryServicesVaultContext перед использованием текущего командлета.
Примеры
Пример 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 и base RetentionPolicyObject. Сохраните их в некоторых переменных.
- Задайте различные параметры объекта расписания и политики хранения в соответствии с вашим требованием. Например, в приведенном выше примере сценария мы пытаемся задать еженедельную политику защиты. Поэтому мы изменили частоту расписания на "Еженедельно", а также обновили время выполнения расписания. В объекте политики хранения мы обновили еженедельную длительность хранения и задайте правильный флаг "еженедельное расписание включено". Если вы хотите задать политику Daily, задайте для флага "Ежедневное расписание включено" значение true и назначьте соответствующие значения для других параметров объекта.
- Получите политику защиты резервных копий, которую вы хотите изменить и сохранить в переменной. В приведенном выше примере мы извлекли политику резервного копирования с именем TestPolicy, который мы хотели изменить.
- Измените политику защиты резервных копий, полученную на шаге 3, используя измененный объект политики расписания и объект политики хранения. Мы используем параметр BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix, чтобы обновить имя группы ресурсов моментальных снимков для мгновенных запросов.
Пример 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
Имя настраиваемой группы ресурсов для хранения мгновенных точек восстановления управляемых виртуальных машин. Это необязательно
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-BackupSnapshotResourceGroupSuffix
Суффикс имени настраиваемой группы ресурсов для хранения моментально точек восстановления управляемых виртуальных машин. Это необязательно
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.
Тип: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-FixForInconsistentItems
Параметр переключателя, указывающий, следует ли повторить обновление политики для элементов сбоем.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MoveToArchiveTier
Указывает, следует ли перемещать точки восстановления в архивный хранилище политикой или нет. Допустимые значения: $true, $false
Тип: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Policy
Указывает политику защиты резервных копий, которая изменяет этот командлет. Чтобы получить объект BackupProtectionPolicy, используйте командлет Get-AzRecoveryServicesBackupProtectionPolicy.
Тип: | PolicyBase |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-RetentionPolicy
Указывает базовую политику хранения. Чтобы получить объект RetentionPolicy, используйте командлет Get-AzRecoveryServicesBackupRetentionPolicyObject.
Тип: | RetentionPolicyBase |
Position: | 2 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SchedulePolicy
Указывает объект политики базового расписания.
Чтобы получить объект SchedulePolicy
Тип: | SchedulePolicyBase |
Position: | 3 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SnapshotConsistencyType
Тип согласованности моментальных снимков, используемый для резервного копирования. Если задано значение OnlyCrashConsistent, все связанные элементы будут иметь сбой согласованного моментального снимка. Возможные значения: OnlyCrashConsistent, Default
Тип: | SnapshotConsistencyType |
Допустимые значения: | Default, OnlyCrashConsistent |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TierAfterDuration
Указывает длительность, после которой точки восстановления должны начать переход на архивный уровень, значение может находиться в днях или месяцах. Применимо только в том случае, если TieringMode — TierAllEligible
Тип: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TierAfterDurationType
Указывает, находится ли tierAfterDuration в днях или месяцах.
Тип: | String |
Допустимые значения: | Days, Months |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TieringMode
Указывает, следует ли перемещать рекомендуемые или все допустимые точки восстановления в архив
Тип: | TieringMode |
Допустимые значения: | TierRecommended, TierAllEligible |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Token
Вспомогательный маркер доступа для проверки подлинности критической операции в подписке resource guard
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VaultId
Идентификатор ARM хранилища служб восстановления.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Связанные ссылки
Azure PowerShell