Partilhar via


Set-AzRecoveryServicesBackupProtectionPolicy

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 o agendamento de backup e os componentes da política de retenção. Quaisquer 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 de agendamento e 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. Assim, alteramos a frequência da programação para "Semanal" e também atualizamos o tempo de execução da programação. No objeto de política de retenção, atualizamos a duração da retenção semanal e definimos o sinalizador "agendamento semanal habilitado" correto. Caso você queira definir uma política diária, defina o sinalizador "agenda 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 de hora base e um RetentionPolicyObject de hora de base. Armazene-os em alguma variável.
  2. Defina os diferentes parâmetros de agendamento e objeto de política de retenção de acordo com sua necessidade. Por exemplo- No script de exemplo acima, estamos tentando definir a $timeZone em que queremos executar a agenda, estamos definindo a hora de início da programação horária, definindo o intervalo horário (em horas), após o qual o backup será reacionado no mesmo dia, duração (em horas) para a qual a agenda será executada. 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 hierarquização inteligente do Arquivo

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

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

Exemplo 4: Desativar a hierarquização inteligente em uma política existente

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

Este comando é usado para desativar a hierarquização inteligente de arquivamento para a política $policy, definimos o parâmetro -MoveToArchiveTier como $false. Observe que a desativação da hierarquização inteligente do 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. Isto é opcional

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackupSnapshotResourceGroupSuffix

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FixForInconsistentItems

Parâmetro de alternância que indica se deve ou não repetir a Atualização de Política para itens com falha.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MoveToArchiveTier

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

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Policy

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

Tipo:PolicyBase
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RetentionPolicy

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

Tipo:RetentionPolicyBase
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SchedulePolicy

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

Tipo:SchedulePolicyBase
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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

Tipo:SnapshotConsistencyType
Valores aceites:Default, OnlyCrashConsistent
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TierAfterDurationType

Especifica se o TierAfterDuration está em Dias ou Meses

Tipo:String
Valores aceites:Days, Months
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TieringMode

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

Tipo:TieringMode
Valores aceites:TierRecommended, TierAllEligible
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Token

Token de acesso auxiliar para autenticar operações críticas para a assinatura do resource guard

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VaultId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PolicyBase

String

Saídas

JobBase