Freigeben über

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 mit Azure Backup aufbewahrt wird. Sie können das Cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject verwenden, um die Standardaufbewahrungsrichtlinie abzurufen. Und Sie können 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 eine Basis-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 eine Basis-RetentionPolicy-Objekt ab und speichert ihn 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 stündlich SchedulePolicyObject-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 fünfte Befehl initialisiert die Startzeit des Zeitplanfensters und aktualisiert die $schedulePolicy. Bitte beachten Sie, dass die Startzeit in UTC sein muss, auch wenn die Zeitzone nicht UTC ist. Der sechste und siebte Befehl aktualisiert das Intervall (in Stunden), nach dem die Sicherung am selben Tag, dauer (in Stunden), für die der Zeitplan ausgeführt wird, erneut ausgelöst wird. Der achte Befehl ruft stündlich RetentionPolicy-Objekt ab und speichert ihn dann in der variablen $retentionPolicy. 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 -MoveToArchiveTier Parameter auf $true zum Aktivieren der intelligenten Leiste fest. 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 ihn 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. Die zulässigen Werte für diesen Parameter sind:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Typ:Nullable<T>[BackupManagementType]
Zulässige Werte:AzureVM, AzureStorage, AzureWorkload
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-BackupSnapshotResourceGroup

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BackupSnapshotResourceGroupSuffix

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MoveToArchiveTier

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

Typ:Nullable<T>[Boolean]
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der Richtlinie an.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RetentionPolicy

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

Typ:RetentionPolicyBase
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SchedulePolicy

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

Typ:SchedulePolicyBase
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SnapshotConsistencyType

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

Typ:SnapshotConsistencyType
Zulässige Werte:Default, OnlyCrashConsistent
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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

Typ:Nullable<T>[Int32]
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TierAfterDurationType

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

Typ:String
Zulässige Werte:Days, Months
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TieringMode

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

Typ:TieringMode
Zulässige Werte:TierRecommended, TierAllEligible
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VaultId

ARM-ID des Recovery Services Vault.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WorkloadType

Workloadtyp der Ressource. Die zulässigen Werte für diesen Parameter sind:

  • AzureVM
  • AzureFiles
  • MSSQL
Typ:WorkloadType
Zulässige Werte:AzureVM, AzureFiles, MSSQL
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

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

Ausgaben