New-AzRecoveryServicesBackupProtectionPolicy

  • Referenz
Modul:
Az.RecoveryServices

Erstellt eine Sicherungsschutzrichtlinie.

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>]

Beschreibung

Das Cmdlet New-AzRecoveryServicesBackupProtectionPolicy erstellt eine Sicherungsschutzrichtlinie in einem Tresor. Eine Schutzrichtlinie ist mindestens einer Aufbewahrungsrichtlinie zugeordnet. Die Aufbewahrungsrichtlinie definiert, wie lange ein Wiederherstellungspunkt in Azure Backup gespeichert wird. Sie können das Cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject verwenden, um die Standardaufbewahrungsrichtlinie abzurufen. Außerdem können Sie das Cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject verwenden, um die Standardzeitplanrichtlinie abzurufen. Die Objekte SchedulePolicy und RetentionPolicy werden als Eingaben für das Cmdlet New-AzRecoveryServicesBackupProtectionPolicy verwendet. Legen Sie den Tresorkontext mithilfe des Cmdlets Set-AzRecoveryServicesVaultContext fest, bevor Sie das aktuelle Cmdlet verwenden.

Beispiele

Beispiel 1: Erstellen einer Sicherungsschutzrichtlinie

$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

Der erste Befehl ruft ein grundlegendes SchedulePolicyObject ab und speichert ihn dann in der $SchPol Variablen. Mit dem zweiten Befehl werden alle geplanten Laufzeiten aus der Zeitplanrichtlinie in $SchPol entfernt. Der dritte Befehl verwendet das Cmdlet "Get-Date", um das aktuelle Datum und die aktuelle Uhrzeit abzurufen. Der vierte Befehl fügt der Zeitplanrichtlinie das aktuelle Datum und die aktuelle Uhrzeit in $Dt als geplante Laufzeit hinzu. Der fünfte Befehl ruft ein Basis-RetentionPolicy-Objekt ab und speichert es dann in der $RetPol Variablen. Der sechste Befehl legt die Aufbewahrungsdauerrichtlinie auf 365 Tage fest. Der letzte Befehl erstellt ein BackupProtectionPolicy -Objekt basierend auf den Zeitplan- und Aufbewahrungsrichtlinien, die von den vorherigen Befehlen erstellt wurden.

Beispiel 2: Erstellen einer Dateifreigaberichtlinie für mehrere Sicherungen pro Tag

$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

Der erste Befehl ruft ein stündliches SchedulePolicyObject-Basis ab und speichert ihn dann in der $schedulePolicy Variablen. Der zweite und dritte Befehl ruft die Zeitzone ab und aktualisiert die Zeitzone in der $schedulePolicy. Der vierte und der fünfte Befehl initialisieren die Startzeit des Zeitplanfensters und aktualisieren die $schedulePolicy. Bitte beachten Sie, dass die Startzeit in UTC sein muss, auch wenn die Zeitzone nicht UTC ist. Der sechste und der siebte Befehl aktualisieren das Intervall (in Stunden), nach dem die Sicherung am selben Tag erneut ausgelöst wird, und die Dauer (in Stunden) der Zeitplanausführung. Der achte Befehl ruft ein Stündliche RetentionPolicy-Basisobjekt ab und speichert ihn dann in der $retentionPolicy Variablen. Der neunte Befehl legt die Aufbewahrungsdauerrichtlinie auf 10 Tage fest. Der letzte Befehl erstellt ein BackupProtectionPolicy -Objekt basierend auf den Zeitplan- und Aufbewahrungsrichtlinien, die von den vorherigen Befehlen erstellt wurden.

Beispiel 3

Erstellt eine Sicherungsschutzrichtlinie. (automatisch generiert)

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

Beispiel 4: Erstellen einer neuen AzureVM-Richtlinie zum Aktivieren der intelligenten Archivebenen mit TieringMode TierRecommended

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

Dieser Befehl wird verwendet, um eine Richtlinie zum Aktivieren der intelligenten Leiste für den Tieringmodus TierRecommended zu erstellen, wir legen den Parameter "-MoveToArchiveTier" auf $true fest, um die intelligente Leiste zu aktivieren. Wir legen "TieringMode" auf "TierRecommended" fest, um alle empfohlenen Wiederherstellungspunkte in das Archiv zu verschieben. Bitte beachten Sie, dass tierRecommended nur für den Workloadtyp AzureVM unterstützt wird.

Beispiel 5: Erstellen einer neuen Richtlinie mit deaktivierter Smart Tiering-Archivierung

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

Dieser Befehl wird verwendet, um die intelligente Archivebene beim Erstellen einer Richtlinie zu deaktivieren, wir legen den Parameter "MoveToArchiveTier" auf $false fest, um die Leiste zu deaktivieren.

Beispiel 6: Erstellen einer Nicht UTC-Zeitzonenstandardrichtlinie für 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

Der erste Befehl ruft ein SchedulePolicyObject ab und speichert es dann in der $schedulePolicy Variablen. Der zweite Befehlsblock ruft die Zeitzone und datumstime (lokal als UTC markiert) ab und aktualisiert die Zeitzone und Uhrzeit in der $schedulePolicy. Bitte beachten Sie, dass die Datumszeit immer als UTC gekennzeichnet werden sollte, da die Zeitzone separat angegeben wird. Beachten Sie außerdem, dass für andere Workloadtypen Zeitzone im Attribut $schedulePolicy.ScheduleRunTimeZone angegeben werden sollte. Der dritte Befehlsblock aktualisiert die Differenzialplanrichtlinie. Anschließend erhalten wir das RetentionPolicyObject und aktualisieren differenzielle und vollständige Sicherungsaufbewahrungseinstellungen. Schließlich erstellen wir ein BackupProtectionPolicy -Objekt basierend auf den Zeitplan- und Aufbewahrungsrichtlinien, die von den vorherigen Befehlen erstellt wurden.

Parameter

-BackupManagementType

Die Klasse der Ressourcen, die geschützt werden. Zulässige Werte für diesen Parameter:

  • 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

Benutzerdefinierter Ressourcengruppenname zum Speichern der sofortigen Wiederherstellungspunkte von verwalteten virtuellen Computern. Dies ist optional.

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

-BackupSnapshotResourceGroupSuffix

Benutzerdefiniertes Ressourcengruppennamensuffix zum Speichern der sofortigen Wiederherstellungspunkte von verwalteten virtuellen Computern. Dies ist optional.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MoveToArchiveTier

Gibt an, ob Wiederherstellungspunkte von der Richtlinie in den Archivspeicher verschoben werden sollen. Zulässige Werte sind $true, $false

Type:Nullable<T>[Boolean]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen der Richtlinie an.

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

-RetentionPolicy

Gibt das Basis-RetentionPolicy -Objekt an. Sie können das Cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject verwenden, um ein RetentionPolicy-Objekt abzurufen.

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

-SchedulePolicy

Gibt das grundlegende SchedulePolicy -Objekt an. Sie können das Cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject verwenden, um ein SchedulePolicy-Objekt abzurufen.

Type:SchedulePolicyBase
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SnapshotConsistencyType

Snapshot-Konsistenztyp, der für die Sicherung verwendet werden soll. Wenn "OnlyCrashConsistent" festgelegt ist, sind alle zugehörigen Elemente Momentaufnahme absturzkonsistent. Mögliche Werte sind OnlyCrashConsistent, Default

Type:SnapshotConsistencyType
Accepted values:Default, OnlyCrashConsistent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDuration

Gibt die Dauer an, nach der Wiederherstellungspunkte mit dem Verschieben in die Archivebene beginnen sollen, kann der Wert in Tagen oder Monaten sein. Gilt nur, wenn "TieringMode" "TierAllEligible" ist

Type:Nullable<T>[Int32]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDurationType

Gibt an, ob die TierAfterDuration in Tagen oder Monaten liegt.

Type:String
Accepted values:Days, Months
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TieringMode

Gibt an, ob empfohlene oder alle berechtigten Wiederherstellungspunkte in das Archiv verschoben werden sollen.

Type:TieringMode
Accepted values:TierRecommended, TierAllEligible
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

ARM-ID des Recovery Services Vault.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkloadType

Workloadtyp der Ressource. Zulässige Werte für diesen Parameter:

  • 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

Eingaben

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

Ausgaben

PolicyBase