Set-AzRecoveryServicesBackupProtectionPolicy

  • Referência
Módulo:
Az.RecoveryServices

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

Sintaxe

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

Description

O cmdlet Set-AzRecoveryServicesBackupProtectionPolicy modifica uma política de proteção de Backup do Azure existente. Você pode modificar os componentes da política de agendamento e retenção de backup. Todas as alterações feitas afetam o backup e a retenção dos itens associados à política. Defina o contexto do cofre usando o cmdlet Set-AzRecoveryServicesVaultContext antes de usar o cmdlet atual.

Exemplos

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

$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"

Aqui está a descrição de alto nível das etapas a serem seguidas para modificar uma política de proteção:

  1. Obtenha um SchedulePolicyObject base e um RetentionPolicyObject base. Armazene-os em alguma variável.
  2. Defina os diferentes parâmetros do agendamento e do objeto de política de retenção de acordo com sua necessidade. Por exemplo- No script de exemplo acima, estamos tentando definir uma política de proteção semanal. Portanto, alteramos a frequência do agendamento para "Semanal" e também atualizamos o tempo de execução do cronograma. No objeto de política de retenção, atualizamos a duração da retenção semanal e definimos o sinalizador correto "agendamento semanal habilitado". Caso você queira definir uma política diária, defina o sinalizador "programação diária habilitada" como true e atribua valores apropriados para outros parâmetros do objeto.
  3. Obtenha a política de proteção de backup que você deseja modificar e armazene-a em uma variável. No exemplo acima, recuperamos a política de backup com o nome "TestPolicy" que queríamos modificar.
  4. Modifique a política de proteção de backup recuperada na etapa 3 usando o objeto de política de agendamento modificado e o objeto de política de retenção. Usamos o parâmetro BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix para atualizar o nome do grupo de recursos de instantâneo para RPs instantâneos.

Exemplo 2: Modificar a política de compartilhamento de arquivos do Azure para vários backups por dia

$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

Aqui está a descrição de alto nível das etapas a serem seguidas para modificar uma política de compartilhamento de arquivos para vários backups por dia:

  1. Obtenha um SchedulePolicyObject por hora base e um RetentionPolicyPolicyObject por hora base. Armazene-os em alguma variável.
  2. Defina os diferentes parâmetros do agendamento e do objeto de política de retenção de acordo com sua necessidade. Por exemplo- No script de exemplo acima, estamos tentando definir o $timeZone em que queremos executar o agendamento, estamos definindo a hora de início do agendamento por hora, definindo o intervalo de hora em hora (em horas), após o qual o backup será acionado novamente no mesmo dia, duração (em horas) para a qual o agendamento será executado. Em seguida, estamos modificando a configuração de retenção para pontos de recuperação diários.
  3. Obtenha a política de proteção de backup que você deseja modificar e armazene-a em uma variável. No exemplo acima, recuperamos a política de backup com o nome "TestPolicy" que queríamos modificar.
  4. Modifique a política de proteção de backup recuperada na etapa 3 usando o objeto de política de agendamento modificado e o objeto de política de retenção.

Exemplo 3: modificar a política AzureWorkload para habilitar a camada inteligente de arquivo

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days

Esse comando é usado para modificar a política para habilitar a camada inteligente de arquivamento para a política $policy, definimos o parâmetro -MoveToArchiveTier como $true para habilitar a hierarquização. Escolhemos TieringMode para ser TierAllEligible para mover todos os pontos de recuperação qualificados para o arquivo morto após determinada duração fornecida pelos parâmetros TierAfterDuration e TierAfterDurationType. Para mover os pontos de recuperação recomendados para o Arquivo para AzureVM, use TieringMode TierRecommended.

Exemplo 4: Desabilitar a camada inteligente em uma política existente

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false

Esse comando é usado para desabilitar a camada inteligente de arquivamento para a política $policy, definimos o parâmetro -MoveToArchiveTier como $false. Observe que desabilitar a camada inteligente de arquivamento pode ter implicações de custo.

Parâmetros

-BackupSnapshotResourceGroup

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FixForInconsistentItems

Parâmetro Switch que indica se a atualização de política deve ou não ser repetida para itens com falha.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MoveToArchiveTier

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

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Policy

Especifica a política de proteção de backup que esse cmdlet modifica. Para obter um objeto BackupProtectionPolicy , use o cmdlet Get-AzRecoveryServicesBackupProtectionPolicy.

Tipo:PolicyBase
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RetentionPolicy

Especifica a política de retenção de base. Para obter um objeto RetentionPolicy , use o cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.

Tipo:RetentionPolicyBase
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SchedulePolicy

Especifica o objeto de política de agendamento base. Para obter um objeto SchedulePolicy , use o objeto Get-AzRecoveryServicesBackupSchedulePolicyObject.

Tipo:SchedulePolicyBase
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SnapshotConsistencyType

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

Tipo:SnapshotConsistencyType
Valores aceitos:Default, OnlyCrashConsistent
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 arquivo, o valor pode ser em dias ou meses. Aplicável somente quando TieringMode é TierAllEligible

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TierAfterDurationType

Especifica se o TierAfterDuration está em Dias ou Meses

Tipo:String
Valores aceitos:Days, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TieringMode

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

Tipo:TieringMode
Valores aceitos:TierRecommended, TierAllEligible
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Token

Token de acesso auxiliar para autenticar operações críticas para assinatura do Resource Guard

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VaultId

ID do ARM do cofre dos Serviços de Recuperação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PolicyBase

String

Saídas

JobBase