Freigeben über

Set-AzRecoveryServicesBackupProtectionPolicy

  • Referenz
Modul:
Az.RecoveryServices

Ändert eine Sicherungsschutzrichtlinie.

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

Beschreibung

Das cmdlet Set-AzRecoveryServicesBackupProtectionPolicy ändert eine vorhandene Azure Backup-Schutzrichtlinie. Sie können die Komponenten des Sicherungszeitplans und der Aufbewahrungsrichtlinie ändern. Alle Änderungen, die Sie vornehmen, wirken sich auf die Sicherung und Aufbewahrung der Elemente aus, die der Richtlinie zugeordnet sind. Legen Sie den Tresorkontext mithilfe des Cmdlets Set-AzRecoveryServicesVaultContext fest, bevor Sie das aktuelle Cmdlet verwenden.

Beispiele

Beispiel 1: Ändern einer Sicherungsschutzrichtlinie

$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"

Hier ist die allgemeine Beschreibung der Schritte, die zum Ändern einer Schutzrichtlinie befolgt werden sollen:

  1. Rufen Sie ein base SchedulePolicyObject und base RetentionPolicyObject ab. Speichern Sie sie in einer Variablen.
  2. Legen Sie die verschiedenen Parameter des Zeitplan- und Aufbewahrungsrichtlinienobjekts gemäß Ihrer Anforderung fest. Beispiel: Im obigen Beispielskript versuchen wir, eine wöchentliche Schutzrichtlinie festzulegen. Daher haben wir die Zeitplanhäufigkeit in "Wöchentlich" geändert und auch die Laufzeit des Zeitplans aktualisiert. Im Aufbewahrungsrichtlinienobjekt haben wir die wöchentliche Aufbewahrungsdauer aktualisiert und das richtige Flag "Wöchentlicher Zeitplan aktiviert" festgelegt. Wenn Sie eine tägliche Richtlinie festlegen möchten, legen Sie das Kennzeichen "Tageszeitplan aktiviert" auf "true" fest, und weisen Sie den anderen Objektparametern entsprechende Werte zu.
  3. Rufen Sie die Sicherungsschutzrichtlinie ab, die Sie ändern und in einer Variablen speichern möchten. Im obigen Beispiel haben wir die Sicherungsrichtlinie mit dem Namen "TestPolicy" abgerufen, den wir ändern wollten.
  4. Ändern Sie die in Schritt 3 abgerufene Sicherungsschutzrichtlinie mithilfe des geänderten Zeitplanrichtlinienobjekts und des Aufbewahrungsrichtlinienobjekts. Wir verwenden BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix-Parameter, um den Snapshot-Ressourcengruppennamen für Sofort-RPs zu aktualisieren.

Beispiel 2: Ändern der Azure-Dateifreigaberichtlinie für mehrere Sicherungen pro Tag

$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 $retentionPolicy

Hier ist die allgemeine Beschreibung der Schritte, die zum Ändern einer Dateifreigaberichtlinie für mehrere Sicherungen pro Tag befolgt werden sollen:

  1. Rufen Sie ein stündliches SchedulePolicyObject-Basisobjekt und eine stündliche Basisaufbewahrungsrichtlinie ab. Speichern Sie sie in einer Variablen.
  2. Legen Sie die verschiedenen Parameter des Zeitplan- und Aufbewahrungsrichtlinienobjekts gemäß Ihrer Anforderung fest. Im obigen Beispielskript versuchen wir beispielsweise, die $timeZone festzulegen, in der wir den Zeitplan ausführen möchten, in dem wir die Startzeit des Stundenplans festlegen, das Stundenintervall (in Stunden), nach dem die Sicherung am selben Tag, dauer (in Stunden), für die der Zeitplan ausgeführt wird, erneut ausgelöst wird. Als Nächstes ändern wir die Aufbewahrungseinstellung für tägliche Wiederherstellungspunkte.
  3. Rufen Sie die Sicherungsschutzrichtlinie ab, die Sie ändern und in einer Variablen speichern möchten. Im obigen Beispiel haben wir die Sicherungsrichtlinie mit dem Namen "TestPolicy" abgerufen, den wir ändern wollten.
  4. Ändern Sie die in Schritt 3 abgerufene Sicherungsschutzrichtlinie mithilfe des geänderten Zeitplanrichtlinienobjekts und des Aufbewahrungsrichtlinienobjekts.

Beispiel 3: Ändern der AzureWorkload-Richtlinie zum Aktivieren der intelligenten Archivebenen

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days

Dieser Befehl wird verwendet, um die Richtlinie so zu ändern, dass die Archivierung der intelligenten Leiste für die Richtlinie $policy aktiviert wird, wir legen -MoveToArchiveTier Parameter auf $true fest, um die Leiste zu aktivieren. Wir wählen "TieringMode" als "TierAllEligible" aus, um alle berechtigten Wiederherstellungspunkte nach einer bestimmten Dauer zu archivieren, die von den Parametern "TierAfterDuration" und "TierAfterDurationType" angegeben wurde. Um empfohlene Wiederherstellungspunkte in "Archive" für AzureVM zu verschieben, verwenden Sie TierRecommended tierrecommended.

Beispiel 4: Deaktivieren der intelligenten Leiste für eine vorhandene Richtlinie

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false

Dieser Befehl wird verwendet, um das Archiv smart tiering für die Richtlinie $policy zu deaktivieren, wir legen -MoveToArchiveTier Parameter auf $false fest. Bitte beachten Sie, dass das Deaktivieren der intelligenten Archivebenen kostenauswirkungen kann.

Parameter

-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

-FixForInconsistentItems

Switch-Parameter, der angibt, ob das Richtlinienupdate für fehlgeschlagene Elemente erneut versucht werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
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:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Policy

Gibt die Sicherungsschutzrichtlinie an, die dieses Cmdlet ändert. Verwenden Sie das cmdlet Get-AzRecoveryServicesBackupProtectionPolicy, um ein BackupProtectionPolicy--Objekt abzurufen.

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

-RetentionPolicy

Gibt die Basisaufbewahrungsrichtlinie an. Verwenden Sie das Cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject, um ein RetentionPolicy--Objekt abzurufen.

Typ:RetentionPolicyBase
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SchedulePolicy

Gibt das Basisplanrichtlinienobjekt an. Um ein SchedulePolicy-Objekt abzurufen, verwenden Sie das Get-AzRecoveryServicesBackupSchedulePolicyObject-Objekt.

Typ:SchedulePolicyBase
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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:Named
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:Named
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:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Token

Zusätzliches Zugriffstoken für die Authentifizierung kritischer Vorgänge für das Resource Guard-Abonnement

Typ:String
Position:Named
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

Eingaben

PolicyBase

String

Ausgaben

JobBase