Set-AzRecoveryServicesBackupProtectionPolicy

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>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-AzRecoveryServicesBackupProtectionPolicy
    [-Policy] <PolicyBase>
    [-FixForInconsistentItems]
    [-BackupSnapshotResourceGroup <String>]
    [-BackupSnapshotResourceGroupSuffix <String>]
    [-SnapshotConsistencyType <SnapshotConsistencyType>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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.

$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.

$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.

$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.

$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.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.