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:
- Obtenha um SchedulePolicyObject base e um RetentionPolicyObject base. Armazene-os em alguma variável.
- 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.
- 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.
- 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 $retentionPolicyAqui 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:
- Obtenha um SchedulePolicyObject de hora base e um RetentionPolicyObject de hora de base. Armazene-os em alguma variável.
- 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.
- 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.
- 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 DaysEste 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 $falseEste 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 |