Set-AzRecoveryServicesBackupProtectionPolicy
Modifie une stratégie de protection de sauvegarde.
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 :
- Obtenez une base SchedulePolicyObject et une base RetentionPolicyObject. Stockez-les dans une variable.
- 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.
- 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.
- 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 $retentionPolicyVoici la description générale des étapes à suivre pour modifier une stratégie de partage de fichiers pour plusieurs sauvegardes par jour :
- Obtenez un SchedulePolicyObject horaire de base et un RetentionPolicyObject horaire de base. Stockez-les dans une variable.
- 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.
- 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.
- 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 DaysCette 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 $falseCette 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
Nom du groupe de ressources personnalisé pour stocker les points de récupération instantanés des machines virtuelles managées. Il s’agit d’une option facultative
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-BackupSnapshotResourceGroupSuffix
Suffixe de nom de groupe de ressources personnalisé pour stocker les points de récupération instantanés des machines virtuelles gérées. Il s’agit d’une option facultative
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FixForInconsistentItems
Paramètre de commutateur indiquant s’il faut réessayer ou non la mise à jour de stratégie pour les éléments ayant échoué.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MoveToArchiveTier
Spécifie si les points de récupération doivent être déplacés vers le stockage d’archivage par la stratégie ou non. Les valeurs autorisées sont $true, $false
| Type: | Nullable<T>[Boolean] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Policy
Spécifie la stratégie de protection de sauvegarde que cette applet de commande modifie. Pour obtenir un objet BackupProtectionPolicy , utilisez l’applet de commande Get-AzRecoveryServicesBackupProtectionPolicy.
| Type: | PolicyBase |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-RetentionPolicy
Spécifie la stratégie de rétention de base. Pour obtenir un objet RetentionPolicy , utilisez l’applet de commande Get-AzRecoveryServicesBackupRetentionPolicyObject.
| Type: | RetentionPolicyBase |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SchedulePolicy
Spécifie l’objet de stratégie de planification de base. Pour obtenir un objet SchedulePolicy , utilisez l’objet Get-AzRecoveryServicesBackupSchedulePolicyObject.
| Type: | SchedulePolicyBase |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SnapshotConsistencyType
Type de cohérence d’instantané à utiliser pour la sauvegarde. Si la valeur est OnlyCrashConsistent, tous les éléments associés ont un instantané cohérent en cas d’incident. Les valeurs possibles sont OnlyCrashConsistent, Default
| Type: | SnapshotConsistencyType |
| Valeurs acceptées: | Default, OnlyCrashConsistent |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TierAfterDuration
Spécifie la durée après laquelle les points de récupération doivent commencer à passer au niveau archive, la valeur peut être en jours ou mois. Applicable uniquement lorsque TieringMode est TierAll Eligible
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TierAfterDurationType
Spécifie si le TierAfterDuration est en jours ou mois
| Type: | String |
| Valeurs acceptées: | Days, Months |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TieringMode
Spécifie s’il faut déplacer les points de récupération recommandés ou tous les points de récupération éligibles à archiver
| Type: | TieringMode |
| Valeurs acceptées: | TierRecommended, TierAllEligible |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Token
Jeton d’accès auxiliaire pour l’authentification de l’opération critique à l’abonnement Resource Guard
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VaultId
ID ARM du coffre Recovery Services.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de la commande cmdlet.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
