Set-AzRecoveryServicesBackupProtectionPolicy
Modifica uma política de proteção de backup.
Syntax
Set-AzRecoveryServicesBackupProtectionPolicy
[-Policy] <PolicyBase>
[[-RetentionPolicy] <RetentionPolicyBase>]
[[-SchedulePolicy] <SchedulePolicyBase>]
[-MoveToArchiveTier <Boolean>]
[-TieringMode <TieringMode>]
[-TierAfterDuration <Int32>]
[-TierAfterDurationType <String>]
[-BackupSnapshotResourceGroup <String>]
[-BackupSnapshotResourceGroupSuffix <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzRecoveryServicesBackupProtectionPolicy
[-Policy] <PolicyBase>
[-FixForInconsistentItems]
[-BackupSnapshotResourceGroup <String>]
[-BackupSnapshotResourceGroupSuffix <String>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Set-AzRecoveryServicesBackupProtectionPolicy modifica uma política de proteção do Backup do Azure existente. Você pode modificar os componentes Agendamento de backup e 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 do cronograma 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 "agenda diária habilitada" como true e atribua valores apropriados para outros parâmetros de 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 $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:
- Obtenha um SchedulePolicyObject de hora base e RetentionPolicyObject de hora em hora. 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 o $timeZone no qual queremos executar a agenda, estamos definindo a hora de início da agenda por hora, 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 do AzureWorkload para habilitar a hierarquização inteligente de arquivamento
$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 hierarquização 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 arquivamento após determinada duração dada pelos parâmetros TierAfterDuration e TierAfterDurationType. Para mover os pontos de recuperação recomendados para o Archive for AzureVM, use TieringMode, TierRecommended.
Exemplo 4: Desabilitar a hierarquização inteligente em uma política existente
$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false
Esse comando é usado para desabilitar a hierarquização inteligente de arquivamento para a política $policy, definimos o parâmetro -MoveToArchiveTier como $false. Observe que desabilitar a hierarquização 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
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 |
-FixForInconsistentItems
Parâmetro de Opção que indica se a Atualização de Política deve ou não ser repetida para itens com falha.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PolicyBase |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionPolicy
Especifica a política de retenção base. Para obter um objeto RetentionPolicy , use o cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.
Type: | RetentionPolicyBase |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SchedulePolicy
Especifica o objeto de política de agendamento base. Para obter um objeto SchedulePolicy , use o objeto Get-AzRecoveryServicesBackupSchedulePolicyObject.
Type: | SchedulePolicyBase |
Position: | 3 |
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: | Named |
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: | Named |
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Token
Token de acesso auxiliar para autenticar operações críticas para a assinatura do resource guard
Type: | String |
Position: | Named |
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 |