Partager via

New-AzRecoveryServicesBackupProtectionPolicy

  • Référence
Module:
Az.RecoveryServices

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

Syntaxe

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 pendant laquelle un point de récupération est conservé 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 une base SchedulePolicyObject, puis la 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 une base 'objet RetentionPolicy, 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 une base horaire SchedulePolicyObject, puis la 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. La quatrième et la cinquième commande initialise l’heure de début de la fenêtre de planification et met à jour le $schedulePolicy. Notez que l’heure de début doit être au format UTC même si le fuseau horaire n’est pas UTC. La sixième et la septième commande met à jour l’intervalle (en heures) après lequel la sauvegarde sera retentée le même jour, durée (en heures) pour laquelle la planification s’exécutera. La huitième commande obtient une base objet RetentionPolicy, puis la 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 -MoveToArchiveTier paramètre 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 une 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 les 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 acceptables pour ce paramètre sont les suivantes :

  • AzureVM
  • AzureStorage
  • AzureWorkload
Type:Nullable<T>[BackupManagementType]
Valeurs acceptées:AzureVM, AzureStorage, AzureWorkload
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
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 invite à confirmer 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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom de la stratégie.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RetentionPolicy

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

Type:RetentionPolicyBase
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SchedulePolicy

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

Type:SchedulePolicyBase
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:8
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:9
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:7
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

Affiche ce qui se passerait si l’applet de commande s’exécute.

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

-WorkloadType

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

  • AzureVM
  • AzureFiles
  • MSSQL
Type:WorkloadType
Valeurs acceptées:AzureVM, AzureFiles, MSSQL
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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