Share via

New-AzRecoveryServicesBackupProtectionPolicy

  • Referência
Módulo:
Az.RecoveryServices

Cria uma política de proteção de backup.

Syntax

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 quanto tempo um ponto de recuperação é mantido pelo 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 um SchedulePolicyObject base e, em seguida, armazena-o na variável $SchPol. O segundo comando remove todos os horários de execução agendados da diretiva de agendamento no $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 horário de execução agendado à diretiva de agendamento. O quinto comando obtém um objeto base RetentionPolicy 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 um SchedulePolicyObject de hora base por hora e, em seguida, armazena-o na variável $schedulePolicy. O segundo e o terceiro comando buscam o fuso horário e atualizam 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 ser 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 um objeto RetentionPolicy baseado por hora 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 nova política do AzureVM para habilitar a hierarquização inteligente de Arquivamento com a Camada TieringRecommended

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

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

Exemplo 5: Criar nova política com a hierarquização inteligente de arquivamento desabilitada

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

Este comando é usado para desabilitar a hierarquização inteligente de arquivamento ao criar uma política, definimos o parâmetro MoveToArchiveTier como $false desabilitar a hierarquização.

Exemplo 6: Criar uma política padrão de fuso horário não UTC para workloadType MSSQL

$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 um SchedulePolicyObject e, em seguida, armazena-o na variável $schedulePolicy. O segundo bloco de comando busca o fuso horário e a data/hora (localtime marcado como UTC) e atualiza o fuso horário e a hora no $schedulePolicy. Por favor, note que a data/hora deve ser sempre marcada 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 fornecido no atributo $schedulePolicy.ScheduleRunTimeZone. O terceiro bloco de comandos atualiza a política de agendamento diferencial. Em seguida, obtemos o RetentionPolicyObject e atualizamos as configurações de retenção de backup completo e diferencial. Finalmente, criamos um objeto BackupProtectionPolicy com base nas políticas de agendamento e retenção criadas pelos comandos anteriores.

Parâmetros

-BackupManagementType

A classe de recursos que está sendo protegida. Os valores aceitáveis para esse parâmetro são:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Type:Nullable<T>[BackupManagementType]
Accepted values:AzureVM, AzureStorage, AzureWorkload
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BackupSnapshotResourceGroup

Nome do grupo de recursos personalizado para armazenar os pontos de recuperação instantânea de máquinas virtuais gerenciadas. Isso é opcional

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

-BackupSnapshotResourceGroupSuffix

Sufixo de nome de grupo de recursos personalizado para armazenar os pontos de recuperação instantânea de máquinas virtuais gerenciadas. Isso é opcional

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

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

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

-MoveToArchiveTier

Especifica se os pontos de recuperação devem ser movidos para o armazenamento de arquivamento pela política ou não. Os valores permitidos são $true, $false

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

-Name

Especifica o nome da política.

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

-RetentionPolicy

Especifica o objeto base RetentionPolicy . Você pode usar o cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject para obter um objeto RetentionPolicy .

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

-SchedulePolicy

Especifica o objeto base SchedulePolicy . Você pode usar o cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject para obter um objeto SchedulePolicy .

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

-SnapshotConsistencyType

Tipo de consistência de snapshot a ser usado para backup. Se definido como OnlyCrashConsistent, todos os itens associados terão instantâneo consistente com falhas. Os valores possíveis são OnlyCrashConsistent, Default

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

-TierAfterDuration

Especifica a duração após a qual os pontos de recuperação devem começar a ser movidos para a camada de arquivamento, o valor pode ser em dias ou meses. Aplicável somente quando TieringMode é TierAllEligible

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

-TierAfterDurationType

Especifica se o TierAfterDuration está em Dias ou Meses

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

-TieringMode

Especifica se os pontos de recuperação recomendados ou qualificados devem ser movidos para arquivamento

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

-VaultId

ID do ARM do Cofre de Serviços de Recuperação.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado.

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

-WorkloadType

Tipo de carga de trabalho do recurso. Os valores aceitáveis para esse parâmetro são:

  • AzureVM
  • AzureFiles
  • MSSQL
Type:WorkloadType
Accepted values:AzureVM, AzureFiles, MSSQL
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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