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
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"Esta é 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 retentionPolicyObject base. Armazene-os em alguma variável.
- Defina os diferentes parâmetros do objeto de política de agendamento e retenção de acordo com suas necessidades. Por exemplo, no script de exemplo acima, estamos tentando definir uma política de proteção semanal. Portanto, alteramos a frequência de agendamento para "Semanal" e também atualizamos o tempo de execução do agendamento. 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 deseje 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 armazená-la 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 agenda 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 $retentionPolicyEsta é 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 base por hora e base por hora RetentionPolicyObject. Armazene-os em alguma variável.
- Defina os diferentes parâmetros do objeto de política de agendamento e retenção de acordo com suas necessidades. 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 da agenda por hora, definindo o intervalo por hora (em horas), após o qual o backup será repetido no mesmo dia, duração (em horas) para o qual o agendamento será executado. 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 armazená-la 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 agenda modificado e o objeto de política de retenção.
Exemplo 3: Modificar a política do AzureWorkload para habilitar a camada inteligente arquivar
$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType DaysEsse comando é usado para modificar a política para habilitar a camada inteligente de arquivo morto para o $policy de política, definimos -MoveToArchiveTier parâmetro para $true para habilitar a camada. Escolhemos TieringMode para ser TierAllEligible para mover todos os pontos de recuperação qualificados para arquivamento após determinada duração fornecida pelos parâmetros TierAfterDuration e TierAfterDurationType. Para mover os pontos de recuperação recomendados para o Arquivo Morto 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 $falseEsse comando é usado para desabilitar a camada inteligente de arquivos para o $policy de política, definimos -MoveToArchiveTier parâmetro como $false. Observe que desabilitar a camada inteligente de arquivos 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 a 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 de alternância 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 este cmdlet modifica.
Para obter um objeto
| 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 base.
Para obter um objeto
| 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 morto, o valor pode ser em dias ou meses. Aplicável somente quando TieringMode for 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 a 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 é necessário mover os pontos de recuperação recomendados ou todos os pontos de recuperação qualificados 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 a operação crítica na 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
Saídas
Links Relacionados
Azure PowerShell