Set-AzRecoveryServicesBackupProtectionPolicy

Syntaxe

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

L’applet de commande Set-AzRecoveryServicesBackupProtectionPolicy modifie une stratégie de protection Sauvegarde Azure existante. Vous pouvez modifier les composants de la planification et de la stratégie de rétention de sauvegarde. Toutes les modifications que vous apportez affectent la sauvegarde et la rétention des éléments associés à la stratégie. Définissez le contexte du coffre à l’aide de l’applet de commande Set-AzRecoveryServicesVaultContext avant d’utiliser l’applet de commande actuelle.

Exemples

Exemple 1 : Modifier une stratégie de protection de sauvegarde

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

Voici la description générale des étapes à suivre pour modifier une stratégie de protection :

1. Obtenez une base SchedulePolicyObject et une base RetentionPolicyObject. Stockez-les dans une variable.
2. Définissez les différents paramètres de l’objet de stratégie de planification et de rétention en fonction de vos besoins. Par exemple- Dans l’exemple de script ci-dessus, nous essayons de définir une stratégie de protection hebdomadaire. Par conséquent, nous avons modifié la fréquence de planification en « Hebdomadaire » et avons également mis à jour l’heure d’exécution de la planification. Dans l’objet de stratégie de rétention, nous avons mis à jour la durée de rétention hebdomadaire et défini l’indicateur « Planification hebdomadaire activée » correcte. Si vous souhaitez définir une stratégie Quotidienne, définissez l’indicateur « Planification quotidienne activée » sur true et affectez les valeurs appropriées pour d’autres paramètres d’objet.
3. Obtenez la stratégie de protection de sauvegarde que vous souhaitez modifier et stocker dans une variable. Dans l’exemple ci-dessus, nous avons récupéré la stratégie de sauvegarde avec le nom « TestPolicy » que nous voulions modifier.
4. Modifiez la stratégie de protection de sauvegarde récupérée à l’étape 3 à l’aide de l’objet de stratégie de planification modifié et de l’objet de stratégie de rétention. Nous utilisons le paramètre BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix pour mettre à jour le nom du groupe de ressources d’instantané pour les adresses IP instantanées.

Exemple 2 : Modifier la stratégie de partage de fichiers Azure pour plusieurs sauvegardes par jour

$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

Voici la description générale des étapes à suivre pour modifier une stratégie de partage de fichiers pour plusieurs sauvegardes par jour :

1. Obtenez un SchedulePolicyObject horaire de base et un RetentionPolicyObject horaire de base. Stockez-les dans une variable.
2. Définissez les différents paramètres de l’objet de stratégie de planification et de rétention en fonction de vos besoins. Par exemple : Dans l’exemple de script ci-dessus, nous essayons de définir la $timeZone dans laquelle nous voulons exécuter la planification, nous définissons l’heure de début de la planification horaire, en définissant l’intervalle horaire (en heures), après quoi la sauvegarde sera retentée le même jour, la durée (en heures) pour laquelle la planification s’exécutera. Ensuite, nous modifions le paramètre de rétention pour les points de récupération quotidiens.
3. Obtenez la stratégie de protection de sauvegarde que vous souhaitez modifier et stocker dans une variable. Dans l’exemple ci-dessus, nous avons récupéré la stratégie de sauvegarde avec le nom « TestPolicy » que nous voulions modifier.
4. Modifiez la stratégie de protection de sauvegarde récupérée à l’étape 3 à l’aide de l’objet de stratégie de planification modifié et de l’objet de stratégie de rétention.

Exemple 3 : Modifier la stratégie AzureWorkload pour activer la hiérarchisation intelligente Archive

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

Cette commande permet de modifier la stratégie pour activer la hiérarchisation intelligente archive pour la stratégie $policy, nous définissons le paramètre -MoveToArchiveTier sur $true pour activer la hiérarchisation. Nous choisissons TieringMode pour qu’il soit TierAll Eligible pour déplacer tous les points de récupération éligibles vers l’archive après une certaine durée donnée par les paramètres TierAfterDuration et TierAfterDurationType. Pour déplacer les points de récupération recommandés vers Archive pour AzureVM, utilisez TieringMode TierRecommended.

Exemple 4 : Désactiver la hiérarchisation intelligente sur une stratégie existante

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

Cette commande permet de désactiver la hiérarchisation intelligente archive pour la stratégie $policy, nous définissons le paramètre -MoveToArchiveTier sur $false. Notez que la désactivation de la hiérarchisation intelligente archive peut avoir des conséquences sur les coûts.

Paramètres

-BackupSnapshotResourceGroup

-BackupSnapshotResourceGroupSuffix

-Confirm

-DefaultProfile

-FixForInconsistentItems

-MoveToArchiveTier

-Policy

-RetentionPolicy

-SchedulePolicy

-SnapshotConsistencyType

-TierAfterDuration

-TierAfterDurationType

-TieringMode

-Token

-VaultId

-WhatIf

Entrées

PolicyBase

String

Sorties

JobBase

Liens associés

• Get-AzRecoveryServicesBackupProtectionPolicy
• Get-AzRecoveryServicesBackupRetentionPolicyObject
• New-AzRecoveryServicesBackupProtectionPolicy
• Remove-AzRecoveryServicesBackupProtectionPolicy