New-AzRecoveryServicesBackupProtectionPolicy
Создает политику защиты резервных копий.
Синтаксис
New-AzRecoveryServicesBackupProtectionPolicy
[-Name] <String>
[-WorkloadType] <WorkloadType>
[[-BackupManagementType] <BackupManagementType>]
[[-RetentionPolicy] <RetentionPolicyBase>]
[[-SchedulePolicy] <SchedulePolicyBase>]
[[-MoveToArchiveTier] <Boolean>]
[[-TieringMode] <TieringMode>]
[[-TierAfterDuration] <Int32>]
[[-TierAfterDurationType] <String>]
[-BackupSnapshotResourceGroup <String>]
[-BackupSnapshotResourceGroupSuffix <String>]
[-SnapshotConsistencyType <SnapshotConsistencyType>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-AzRecoveryServicesBackupProtectionPolicy создает политику защиты резервных копий в хранилище. Политика защиты связана по крайней мере с одной политикой хранения. Политика хранения определяет, сколько времени точка восстановления хранится в Azure Backup. Для получения политики хранения по умолчанию можно использовать командлет Get-AzRecoveryServicesBackupRetentionPolicyObject. И вы можете использовать командлет Get-AzRecoveryServicesBackupSchedulePolicyObject для получения политики расписания по умолчанию. Объекты SchedulePolicy и StoragePolicy используются в качестве входных данных для командлета New-AzRecoveryServicesBackupProtectionPolicy. Задайте контекст хранилища с помощью командлета Set-AzRecoveryServicesVaultContext перед использованием текущего командлета.
Примеры
Пример 1. Создание политики защиты резервных копий
$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM"
$SchPol.ScheduleRunTimes.Clear()
$Dt = Get-Date
$SchPol.ScheduleRunTimes.Add($Dt.ToUniversalTime())
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM"
$RetPol.DailySchedule.DurationCountInDays = 365
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol
Первая команда получает базовый SchedulePolicyObject, а затем сохраняет его в переменной $SchPol. Вторая команда удаляет все запланированное время выполнения из политики расписания в $SchPol. Третья команда использует командлет Get-Date для получения текущей даты и времени. Четвертая команда добавляет текущую дату и время в $Dt в качестве запланированного времени выполнения в политику расписания. Пятая команда получает базовый объект RetentionPolicy, а затем сохраняет его в переменной $RetPol. Шестая команда задает политику длительности хранения 365 дней. Последняя команда создает объект BackupProtectionPolicy на основе политик расписания и хранения, созданных предыдущими командами.
Пример 2. Создание политики общей папки для нескольких резервных копий в день
$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -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 = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy.DailySchedule.DurationCountInDays = 10
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy
Первая команда получает базовую почасовую SchedulePolicyObject, а затем сохраняет ее в переменной $schedulePolicy. Вторая и третья команда извлекает часовой пояс и обновляет часовой пояс в $schedulePolicy. Четвертая и пятая команда инициализирует время начала периода расписания и обновляет $schedulePolicy. Обратите внимание, что время начала должно находиться в формате UTC, даже если часовой пояс не указан в формате UTC. Шестая и седьмая команда обновляет интервал (в часах), после которого резервная копия будет извлечена в тот же день, длительность (в часах), для которой будет выполняться расписание. Восьмая команда получает базовый почасовой объект RetentionPolicy, а затем сохраняет его в переменной $retentionPolicy. Девятая команда задает политику длительности хранения 10 дней. Последняя команда создает объект BackupProtectionPolicy на основе политик расписания и хранения, созданных предыдущими командами.
Пример 3
Создает политику защиты резервных копий. (автоматическое создание)
New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM
Пример 4. Создание политики AzureVM для включения архивации интеллектуального уровня с помощью TieringMode TierRecommended
$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended
Эта команда используется для создания политики, чтобы включить архивацию смарт-уровней для режима многоуровневого режима TierRecommended, мы зададим параметру -MoveToArchiveTier значение $true для включения интеллектуального уровня. Мы установите для TieringMode значение TierRecommended, чтобы переместить все рекомендуемые точки восстановления в архив. Обратите внимание, что для типа рабочей нагрузки AzureVM поддерживается только режим многоуровневого режима.
Пример 5. Создание политики с отключенным архивацией интеллектуального уровня
$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false
Эта команда используется для отключения архивации смарт-уровней при создании политики, чтобы параметр MoveToArchiveTier был $false для отключения многоуровневого распределения.
Пример 6. Создание стандартной политики часового пояса UTC для MSSQL для workloadType
$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload -PolicySubType Standard
$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "Tokyo" }
$date= Get-Date -Hour 9 -Minute 0 -Second 0 -Year 2022 -Day 26 -Month 12 -Millisecond 0
$date = [DateTime]::SpecifyKind($date,[DateTimeKind]::Utc)
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunFrequency = "Weekly"
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimes[0] = $date
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimeZone = $timeZone[0].Id
$schedulePolicy.IsDifferentialBackupEnabled = $true
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunDays[0] = "Wednesday"
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunTimes[0] = $date.AddHours(1)
$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload
$retentionPolicy.DifferentialBackupRetentionPolicy.RetentionCount = 15
$retentionPolicy.FullBackupRetentionPolicy.IsDailyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.IsMonthlyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.WeeklySchedule.DurationCountInWeeks = 35
$retentionPolicy.FullBackupRetentionPolicy.YearlySchedule.DurationCountInYears = 2
New-AzRecoveryServicesBackupProtectionPolicy -Name "Tokyo-mssql-policy" -WorkloadType MSSQL -BackupManagementType AzureWorkload -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy -VaultId $vault.ID
Первая команда получает SchedulePolicyObject, а затем сохраняет ее в переменной $schedulePolicy. Второй блок команды извлекает часовой пояс и дату (localtime, помеченный как UTC) и обновляет часовой пояс и время в $schedulePolicy. Обратите внимание, что дата всегда должна быть помечена как UTC, так как часовой пояс предоставляется отдельно. Кроме того, обратите внимание, что для других типов рабочих нагрузок следует уделить часовой пояс в атрибуте $schedulePolicy.ScheduleRunTimeZone. Третий блок команд обновляет политику разностного расписания. Затем мы получаем RetentionPolicyObject и обновляем разностные и полные параметры хранения резервных копий. Наконец, мы создадим объект BackupProtectionPolicy на основе политик расписания и хранения, созданных предыдущими командами.
Параметры
-BackupManagementType
Класс защищаемых ресурсов. Допустимые значения для этого параметра:
- AzureVM
- AzureStorage
- AzureWorkload
Тип: | Nullable<T>[BackupManagementType] |
Допустимые значения: | AzureVM, AzureStorage, AzureWorkload |
Position: | 3 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | 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 |
-MoveToArchiveTier
Указывает, следует ли перемещать точки восстановления в архивный хранилище политикой или нет. Допустимые значения: $true, $false
Тип: | Nullable<T>[Boolean] |
Position: | 6 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Указывает имя политики.
Тип: | String |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RetentionPolicy
Указывает базовый объект RetentionPolicy. Командлет Get-AzRecoveryServicesBackupRetentionPolicyObject можно использовать для получения объекта RetentionPolicy.
Тип: | RetentionPolicyBase |
Position: | 4 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SchedulePolicy
Указывает базовый объект SchedulePolicy. Командлет Get-AzRecoveryServicesBackupSchedulePolicyObject можно использовать для получения объекта SchedulePolicy.
Тип: | SchedulePolicyBase |
Position: | 5 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SnapshotConsistencyType
Тип согласованности моментальных снимков, используемый для резервного копирования. Если задано значение OnlyCrashConsistent, все связанные элементы будут иметь сбой согласованного моментального снимка. Возможные значения: OnlyCrashConsistent, Default
Тип: | SnapshotConsistencyType |
Допустимые значения: | Default, OnlyCrashConsistent |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TierAfterDuration
Указывает длительность, после которой точки восстановления должны начать переход на архивный уровень, значение может находиться в днях или месяцах. Применимо только в том случае, если TieringMode — TierAllEligible
Тип: | Nullable<T>[Int32] |
Position: | 8 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TierAfterDurationType
Указывает, находится ли tierAfterDuration в днях или месяцах.
Тип: | String |
Допустимые значения: | Days, Months |
Position: | 9 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TieringMode
Указывает, следует ли перемещать рекомендуемые или все допустимые точки восстановления в архив
Тип: | TieringMode |
Допустимые значения: | TierRecommended, TierAllEligible |
Position: | 7 |
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 |
-WorkloadType
Тип рабочей нагрузки ресурса. Допустимые значения для этого параметра:
- AzureVM
- AzureFiles
- MSSQL
Тип: | WorkloadType |
Допустимые значения: | AzureVM, AzureFiles, MSSQL |
Position: | 2 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Входные данные
Nullable<T>[[Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.BackupManagementType, Microsoft.Azure.PowerShell.Cmdlets.RecoveryServices.Backup.Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]
Выходные данные
Связанные ссылки
Azure PowerShell