Set-AzRecoveryServicesBackupProtectionPolicy

  • Riferimento
Modulo:
Az.RecoveryServices

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackupSnapshotResourceGroupSuffix

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FixForInconsistentItems

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Policy

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

Type:PolicyBase
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RetentionPolicy

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

Type:RetentionPolicyBase
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SchedulePolicy

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

Type:SchedulePolicyBase
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDurationType

Specifica se TierAfterDuration è espresso in giorni o mesi

Type:String
Accepted values:Days, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TieringMode

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

Type:TieringMode
Accepted values:TierRecommended, TierAllEligible
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Token

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PolicyBase

String

Output

JobBase