New-AzRecoveryServicesBackupProtectionPolicy

  • Référence
Module:
Az.RecoveryServices

Crée une stratégie de protection de sauvegarde.

Syntax

New-AzRecoveryServicesBackupProtectionPolicy
   [-Name] <String>
   [-WorkloadType] <WorkloadType>
   [[-BackupManagementType] <BackupManagementType>]
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [[-MoveToArchiveTier] <Boolean>]
   [[-TieringMode] <TieringMode>]
   [[-TierAfterDuration] <Int32>]
   [[-TierAfterDurationType] <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande New-AzRecoveryServicesBackupProtectionPolicy crée une stratégie de protection de sauvegarde dans un coffre. Une stratégie de protection est associée à au moins une stratégie de rétention. La stratégie de rétention définit la durée de conservation d’un point de restauration avec Sauvegarde Azure. Vous pouvez utiliser l’applet de commande Get-AzRecoveryServicesBackupRetentionPolicyObject pour obtenir la stratégie de rétention par défaut. Vous pouvez également utiliser l’applet de commande Get-AzRecoveryServicesBackupSchedulePolicyObject pour obtenir la stratégie de planification par défaut. Les objets SchedulePolicy et RetentionPolicy sont utilisés comme entrées dans l’applet de commande New-AzRecoveryServicesBackupProtectionPolicy . 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 : Créer une stratégie de protection de sauvegarde

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM"
$SchPol.ScheduleRunTimes.Clear()
$Dt = Get-Date
$SchPol.ScheduleRunTimes.Add($Dt.ToUniversalTime())
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM"
$RetPol.DailySchedule.DurationCountInDays = 365
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

La première commande obtient un SchedulePolicyObject de base, puis le stocke dans la variable $SchPol. La deuxième commande supprime toutes les heures d’exécution planifiées de la stratégie de planification dans $SchPol. La troisième commande utilise l’applet de commande Get-Date pour obtenir la date et l’heure actuelles. La quatrième commande ajoute la date et l’heure actuelles dans $Dt comme heure d’exécution planifiée à la stratégie de planification. La cinquième commande obtient un objet RetentionPolicy de base, puis la stocke dans la variable $RetPol. La sixième commande définit la stratégie de durée de rétention sur 365 jours. La commande finale crée un objet BackupProtectionPolicy en fonction de la planification et des stratégies de rétention créées par les commandes précédentes.

Exemple 2 : Créer une stratégie de partage de fichiers pour plusieurs sauvegardes par jour

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -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 = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy.DailySchedule.DurationCountInDays = 10
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy

La première commande obtient un SchedulePolicyObject horaire de base, puis le stocke dans la variable $schedulePolicy. La deuxième et la troisième commande récupère le fuseau horaire et met à jour le fuseau horaire dans le $schedulePolicy. Les quatrième et cinquième commandes initialisent l'heure de début de la fenêtre de planification et mettent à jour $schedulePolicy. Notez que l’heure de début doit être au format UTC même si le fuseau horaire n’est pas UTC. Les sixième et septième commandes mettent à jour l'intervalle (en heures) dans lequel la sauvegarde sera à nouveau déclenchée le même jour, ainsi que la durée (en heures) pendant laquelle la planification s'exécutera. La huitième commande obtient un objet RetentionPolicy horaire de base, puis le stocke dans la variable $retentionPolicy. La neuvième commande définit la stratégie de durée de rétention sur 10 jours. La commande finale crée un objet BackupProtectionPolicy en fonction de la planification et des stratégies de rétention créées par les commandes précédentes.

Exemple 3

Crée une stratégie de protection de sauvegarde. (généré automatiquement)

New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM

Exemple 4 : Créer une stratégie AzureVM pour activer la hiérarchisation intelligente Archive avec TieringMode TierRecommended

$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended

Cette commande permet de créer une stratégie pour activer la hiérarchisation intelligente archive pour le mode hiérarchisation Hiérarchisé, nous définissons le paramètre -MoveToArchiveTier sur $true pour activer la hiérarchisation intelligente. Nous définissons TieringMode sur TierRecommended pour déplacer tous les points de récupération recommandés vers l’archive. Notez que le mode hiérarchisation TierRecommended est pris en charge uniquement pour le type de charge de travail AzureVM.

Exemple 5 : Créer une stratégie avec la hiérarchisation intelligente archive désactivée

$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID  -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false

Cette commande permet de désactiver la hiérarchisation intelligente archive lors de la création d’une stratégie, nous définissons le paramètre MoveToArchiveTier sur $false pour désactiver la hiérarchisation.

Exemple 6 : Créer une stratégie standard de fuseau horaire NON UTC pour workloadType MSSQL

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload -PolicySubType Standard

$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "Tokyo" } 
$date= Get-Date -Hour 9 -Minute 0 -Second 0 -Year 2022 -Day 26 -Month 12 -Millisecond 0
$date = [DateTime]::SpecifyKind($date,[DateTimeKind]::Utc)
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunFrequency = "Weekly"
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimes[0] = $date
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimeZone = $timeZone[0].Id

$schedulePolicy.IsDifferentialBackupEnabled = $true
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunDays[0] = "Wednesday"
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunTimes[0] = $date.AddHours(1)

$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload

$retentionPolicy.DifferentialBackupRetentionPolicy.RetentionCount = 15

$retentionPolicy.FullBackupRetentionPolicy.IsDailyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.IsMonthlyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.WeeklySchedule.DurationCountInWeeks = 35
$retentionPolicy.FullBackupRetentionPolicy.YearlySchedule.DurationCountInYears = 2

New-AzRecoveryServicesBackupProtectionPolicy -Name "Tokyo-mssql-policy" -WorkloadType MSSQL -BackupManagementType AzureWorkload -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy -VaultId $vault.ID

La première commande obtient un SchedulePolicyObject, puis la stocke dans la variable $schedulePolicy. Le deuxième bloc de commande extrait le fuseau horaire et l’heure de date (heure locale marquée comme UTC) et met à jour le fuseau horaire et l’heure dans le $schedulePolicy. Notez que l’heure de date doit toujours être marquée comme UTC, car le fuseau horaire est donné séparément. Notez également que pour d’autres types de charge de travail, le fuseau horaire doit être donné dans l’attribut $schedulePolicy.ScheduleRunTimeZone. Le troisième bloc de commandes met à jour la stratégie de planification différentielle. Ensuite, nous obtenons le RetentionPolicyObject et mettons à jour les paramètres de rétention différentielles et complètes de sauvegarde. Enfin, nous créons un objet BackupProtectionPolicy en fonction de la planification et des stratégies de rétention créées par les commandes précédentes.

Paramètres

-BackupManagementType

Classe de ressources protégées. Les valeurs valides pour ce paramètre sont :

  • AzureVM
  • AzureStorage
  • AzureWorkload
Type:Nullable<T>[BackupManagementType]
Accepted values:AzureVM, AzureStorage, AzureWorkload
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-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

-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:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom de la stratégie.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetentionPolicy

Spécifie l’objet RetentionPolicy de base. Vous pouvez utiliser l’applet de commande Get-AzRecoveryServicesBackupRetentionPolicyObject pour obtenir un objet RetentionPolicy .

Type:RetentionPolicyBase
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SchedulePolicy

Spécifie l’objet SchedulePolicy de base. Vous pouvez utiliser l’applet de commande Get-AzRecoveryServicesBackupSchedulePolicyObject pour obtenir un objet SchedulePolicy .

Type:SchedulePolicyBase
Position:5
Default value:None
Required:False
Accept pipeline input:True
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:8
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:9
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:7
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

-WorkloadType

Type de charge de travail de la ressource. Les valeurs valides pour ce paramètre sont :

  • AzureVM
  • AzureFiles
  • MSSQL
Type:WorkloadType
Accepted values:AzureVM, AzureFiles, MSSQL
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

WorkloadType

Nullable<T>[[Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.BackupManagementType, Microsoft.Azure.PowerShell.Cmdlets.RecoveryServices.Backup.Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

RetentionPolicyBase

SchedulePolicyBase

String

Sorties

PolicyBase