Set-AzRecoveryServicesBackupProtectionPolicy
Modifie une stratégie de protection de sauvegarde.
Syntax
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 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SnapshotConsistencyType
Type de cohérence d’instantané à utiliser pour la sauvegarde. S’il est défini sur OnlyCrashConsistent, tous les éléments associés ont une cohérence de blocage instantané. Les valeurs possibles sont OnlyCrashConsistent, Default
| Type: | SnapshotConsistencyType |
| Accepted values: | Default, OnlyCrashConsistent |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TierAfterDurationType
Spécifie si le TierAfterDuration est en jours ou mois
| Type: | String |
| Accepted values: | Days, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Accepted values: | TierRecommended, TierAllEligible |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Token
Jeton d’accès auxiliaire pour l’authentification de l’opération critique à l’abonnement Resource Guard
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VaultId
ID ARM du coffre Recovery Services.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entrées
Sorties
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour