New-AzRecoveryServicesBackupProtectionPolicy

Sintaxe

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>]

Description

O cmdlet New-AzRecoveryServicesBackupProtectionPolicy cria uma política de proteção de backup em um cofre. Uma política de proteção está associada a pelo menos uma política de retenção. A política de retenção define por quanto tempo um ponto de recuperação é mantido com o Backup do Azure. Você pode usar o cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject para obter a política de retenção padrão. E você pode usar o cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject para obter a política de agendamento padrão. Os objetos SchedulePolicy e RetentionPolicy são usados como entradas para o cmdlet New-AzRecoveryServicesBackupProtectionPolicy. Defina o contexto do cofre usando o cmdlet Set-AzRecoveryServicesVaultContext antes de usar o cmdlet atual.

Exemplos

Exemplo 1: Criar uma política de proteção de backup

$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

O primeiro comando obtém uma base SchedulePolicyObject e o armazena na variável $SchPol. O segundo comando remove todos os tempos de execução agendados da política de agendamento em $SchPol. O terceiro comando usa o cmdlet Get-Date para obter a data e a hora atuais. O quarto comando adiciona a data e a hora atuais em $Dt como o tempo de execução agendado à política de agendamento. O quinto comando obtém um objeto RetentionPolicy base e o armazena na variável $RetPol. O sexto comando define a política de duração de retenção como 365 dias. O comando final cria um objeto BackupProtectionPolicy com base nas políticas de agendamento e retenção criadas pelos comandos anteriores.

Exemplo 2: Criar uma política de compartilhamento de arquivos para vários backups por dia

$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

O primeiro comando obtém uma base por hora SchedulePolicyObject e o armazena na variável $schedulePolicy. O segundo e o terceiro comando busca o fuso horário e atualiza o fuso horário no $schedulePolicy. O quarto e quinto comando inicializa a hora de início da janela de agendamento e atualiza o $schedulePolicy. Observe que a hora de início deve estar em UTC mesmo que o fuso horário não seja UTC. O sexto e sétimo comando atualiza o intervalo (em horas) após o qual o backup será repetido no mesmo dia, duração (em horas) para o qual o agendamento será executado. O oitavo comando obtém uma base por hora objeto RetentionPolicy e o armazena na variável $retentionPolicy. O nono comando define a política de duração de retenção como 10 dias. O comando final cria um objeto BackupProtectionPolicy com base nas políticas de agendamento e retenção criadas pelos comandos anteriores.

Exemplo 3

Cria uma política de proteção de backup. (gerado automaticamente)

New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM

Exemplo 4: Criar uma nova política do AzureVM para habilitar a camada inteligente de Arquivo com TieringMode TierRecommended

$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended

Esse comando é usado para criar uma política para habilitar a camada inteligente de arquivo morto para o modo de camada TierRecommended, definimos -MoveToArchiveTier parâmetro como $true para habilitar a camada inteligente. Definimos TieringMode como TierRecommended para mover todos os pontos de recuperação recomendados para arquivamento. Observe que o modo de camada TierRecommended só tem suporte para o tipo de carga de trabalho AzureVM.

Exemplo 5: Criar uma nova política com camadas inteligentes de arquivos desabilitadas

$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID  -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false

Esse comando é usado para desabilitar a camada inteligente de arquivos ao criar uma política, definimos o parâmetro MoveToArchiveTier como $false para desabilitar a camada.

Exemplo 6: Criar uma política padrão de fuso horário não UTC para o MSSQL de 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

O primeiro comando obtém umSchedulePolicyObject e o armazena na variável $schedulePolicy. O segundo bloco de comando busca o fuso horário e o datetime (localtime marcado como UTC) e atualiza o fuso horário e a hora no $schedulePolicy. Observe que o datetime sempre deve ser marcado como UTC, pois o fuso horário é dado separadamente. Observe também que, para outros tipos de carga de trabalho, o fuso horário deve ser dado no atributo $schedulePolicy.ScheduleRunTimeZone. O terceiro bloco de comando atualiza a política de agendamento diferencial. Em seguida, obtemos o RetentionPolicyObject e atualizamos as configurações de retenção de backup diferenciais e completas. Por fim, criamos um objeto BackupProtectionPolicy com base nas políticas de agendamento e retenção criadas pelos comandos anteriores.

Parâmetros

-BackupManagementType

-BackupSnapshotResourceGroup

-BackupSnapshotResourceGroupSuffix

-Confirm

-DefaultProfile

-MoveToArchiveTier

-Name

-RetentionPolicy

-SchedulePolicy

-SnapshotConsistencyType

-TierAfterDuration

-TierAfterDurationType

-TieringMode

-VaultId

-WhatIf

-WorkloadType

Entradas

WorkloadType

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]]

RetentionPolicyBase

SchedulePolicyBase

String

Saídas

PolicyBase

Links Relacionados

• Enable-AzRecoveryServicesBackupProtection
• Get-AzRecoveryServicesBackupProtectionPolicy
• Get-AzRecoveryServicesBackupRetentionPolicyObject
• Get-AzRecoveryServicesBackupSchedulePolicyObject
• Remove-AzRecoveryServicesBackupProtectionPolicy
• Set-AzRecoveryServicesBackupProtectionPolicy