Condividi tramite


Set-AzRecoveryServicesBackupProtectionPolicy

Modifica un criterio di protezione backup.

Sintassi

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

Descrizione

Il cmdlet Set-AzRecoveryServicesBackupProtectionPolicy modifica un criterio di protezione Backup di Azure esistente. È possibile modificare i componenti dei criteri di pianificazione e conservazione dei backup. Eventuali modifiche apportate influiscono sul backup e sulla conservazione degli elementi associati al criterio. Impostare il contesto dell'insieme di credenziali usando il cmdlet Set-AzRecoveryServicesVaultContext prima di usare il cmdlet corrente.

Esempio

Esempio 1: Modificare un criterio di protezione di 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"

Ecco la descrizione generale dei passaggi da seguire per la modifica di un criterio di protezione:

  1. Ottenere un oggetto SchedulePolicyObject di base e RetentionPolicyObject di base. Archiviarli in una variabile.
  2. Impostare i diversi parametri dell'oggetto criteri di pianificazione e conservazione in base alle esigenze. Ad esempio, nello script di esempio precedente si sta tentando di impostare un criterio di protezione settimanale. Di conseguenza, la frequenza di pianificazione è stata modificata in "Settimanale" ed è stata aggiornata anche l'ora di esecuzione della pianificazione. Nell'oggetto criteri di conservazione è stata aggiornata la durata di conservazione settimanale e è stato impostato il flag corretto "Pianificazione settimanale abilitata". Se si desidera impostare un criterio Giornaliero, impostare il flag "daily schedule enabled" su true e assegnare valori appropriati per altri parametri oggetto.
  3. Ottenere i criteri di protezione dei backup da modificare e archiviarlo in una variabile. Nell'esempio precedente è stato recuperato il criterio di backup con il nome "TestPolicy" che si desidera modificare.
  4. Modificare i criteri di protezione dei backup recuperati nel passaggio 3 usando l'oggetto criteri di pianificazione modificato e l'oggetto criteri di conservazione. Il parametro BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix viene usato per aggiornare il nome del gruppo di risorse snapshot per gli indirizzi RP istantanei.

Esempio 2: Modificare i criteri di condivisione file di Azure per più backup al giorno

$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

Ecco la descrizione generale dei passaggi da seguire per modificare un criterio di condivisione file per più backup al giorno:

  1. Ottenere un Oggetto SchedulePolicyObject orario di base e un oggetto RetentionPolicyObject su base oraria. Archiviarli in una variabile.
  2. Impostare i diversi parametri dell'oggetto criteri di pianificazione e conservazione in base alle esigenze. Ad esempio, nello script di esempio precedente si sta tentando di impostare il $timeZone in cui si vuole eseguire la pianificazione che si sta impostando l'ora di inizio della pianificazione oraria, impostando l'intervallo orario (in ore), dopo il quale il backup verrà ritentato nello stesso giorno, durata (in ore) per cui verrà eseguita la pianificazione. Verrà quindi modificata l'impostazione di conservazione per i punti di ripristino giornalieri.
  3. Ottenere i criteri di protezione dei backup da modificare e archiviarlo in una variabile. Nell'esempio precedente è stato recuperato il criterio di backup con il nome "TestPolicy" che si desidera modificare.
  4. Modificare i criteri di protezione dei backup recuperati nel passaggio 3 usando l'oggetto criteri di pianificazione modificato e l'oggetto criteri di conservazione.

Esempio 3: Modificare i criteri di AzureWorkload per abilitare l'archiviazione intelligente della suddivisione in livelli

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

Questo comando viene usato per modificare i criteri per abilitare l'archiviazione della suddivisione in livelli intelligenti per il criterio $policy, il parametro -MoveToArchiveTier viene impostato su $true per abilitare la suddivisione in livelli. Si sceglie TieringMode come TierAllEligible per spostare tutti i punti di ripristino idonei nell'archivio dopo una determinata durata specificata dai parametri TierAfterDuration e TierAfterDurationType. Per spostare i punti di ripristino consigliati nell'archivio per AzureVM, usare TieringMode TierRecommended.

Esempio 4: Disabilitare la suddivisione in livelli intelligenti in un criterio esistente

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

Questo comando viene usato per disabilitare la suddivisione in livelli intelligente dell'archivio per il $policy dei criteri, il parametro -MoveToArchiveTier viene impostato su $false. Si noti che la disabilitazione della suddivisione in livelli intelligenti dell'archivio potrebbe avere implicazioni in termini di costi.

Parametri

-BackupSnapshotResourceGroup

Nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BackupSnapshotResourceGroupSuffix

Suffisso del nome del gruppo di risorse personalizzato per archiviare i punti di ripristino istantanei delle macchine virtuali gestite. Questa opzione è facoltativa

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FixForInconsistentItems

Opzione Parametro che indica se riprovare o meno l'aggiornamento dei criteri per gli elementi non riusciti.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MoveToArchiveTier

Specifica se i punti di ripristino devono essere spostati nell'archivio di archiviazione in base al criterio o meno. I valori consentiti sono $true, $false

Tipo:Nullable<T>[Boolean]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Policy

Specifica i criteri di protezione di Backup che questo cmdlet modifica. Per ottenere un oggetto BackupProtectionPolicy , usare il cmdlet Get-AzRecoveryServicesBackupProtectionPolicy.

Tipo:PolicyBase
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RetentionPolicy

Specifica i criteri di conservazione di base. Per ottenere un oggetto RetentionPolicy , usare il cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.

Tipo:RetentionPolicyBase
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SchedulePolicy

Specifica l'oggetto criteri di pianificazione di base. Per ottenere un oggetto SchedulePolicy , utilizzare l'oggetto Get-AzRecoveryServicesBackupSchedulePolicyObject.

Tipo:SchedulePolicyBase
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SnapshotConsistencyType

Tipo di coerenza dello snapshot da usare per il backup. Se impostato su OnlyCrashConsistent, tutti gli elementi associati avranno uno snapshot coerente con l'arresto anomalo del sistema. I valori possibili sono OnlyCrashConsistent, Default

Tipo:SnapshotConsistencyType
Valori accettati:Default, OnlyCrashConsistent
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TierAfterDuration

Specifica la durata dopo la quale i punti di ripristino devono iniziare a passare al livello archivio, il valore può essere espresso in giorni o mesi. Applicabile solo quando TieringMode è TierAllEligible

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TierAfterDurationType

Specifica se TierAfterDuration è espresso in giorni o mesi

Tipo:String
Valori accettati:Days, Months
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TieringMode

Specifica se spostare i punti di ripristino consigliati o tutti i punti di ripristino idonei all'archivio

Tipo:TieringMode
Valori accettati:TierRecommended, TierAllEligible
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Token

Token di accesso ausiliario per l'autenticazione dell'operazione critica per la sottoscrizione di Resource Guard

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VaultId

ID ARM dell'insieme di credenziali di Servizi di ripristino.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PolicyBase

String

Output

JobBase