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:
- Ottenere un oggetto SchedulePolicyObject di base e RetentionPolicyObject di base. Archiviarli in una variabile.
- 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.
- 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.
- 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 $retentionPolicyEcco la descrizione generale dei passaggi da seguire per modificare un criterio di condivisione file per più backup al giorno:
- Ottenere un Oggetto SchedulePolicyObject orario di base e un oggetto RetentionPolicyObject su base oraria. Archiviarli in una variabile.
- 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.
- 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.
- 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 DaysQuesto 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 $falseQuesto 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 |
