Set-AzRecoveryServicesBackupProtectionPolicy
Ä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:
- Rufen Sie ein base SchedulePolicyObject und base RetentionPolicyObject ab. Speichern Sie sie in einer Variablen.
- 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.
- 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.
- Ändern Sie die in Schritt 3 abgerufene Sicherungsschutzrichtlinie mithilfe des geänderten Zeitplanrichtlinienobjekts und des Aufbewahrungsrichtlinienobjekts. Wir verwenden BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix-Parameter, um den Namen der Momentaufnahme Ressourcengruppe 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:
- Rufen Sie ein stündliches SchedulePolicyObject-Basisobjekt und eine stündliche Basisaufbewahrungsrichtlinie ab. Speichern Sie sie in einer Variablen.
- 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.
- 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.
- Ä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 zu ändern, um die archivierungsbasierte Leiste für die Richtlinie $policy zu aktivieren, wir legen den Parameter "-MoveToArchiveTier" 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 den Parameter "-MoveToArchiveTier" 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.
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 |
-FixForInconsistentItems
Switch-Parameter, der angibt, ob das Richtlinienupdate für fehlgeschlagene Elemente erneut versucht werden soll.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Policy
Gibt die Sicherungsschutzrichtlinie an, die dieses Cmdlet ändert. Verwenden Sie das Cmdlet Get-AzRecoveryServicesBackupProtectionPolicy, um ein BackupProtectionPolicy-Objekt abzurufen.
Type: | PolicyBase |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionPolicy
Gibt die Basisaufbewahrungsrichtlinie an. Verwenden Sie zum Abrufen eines RetentionPolicy-Objekts das Cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.
Type: | RetentionPolicyBase |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SchedulePolicy
Gibt das Basisplanrichtlinienobjekt an. Verwenden Sie zum Abrufen eines SchedulePolicy-Objekts das Get-AzRecoveryServicesBackupSchedulePolicyObject-Objekt.
Type: | SchedulePolicyBase |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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: | Named |
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: | Named |
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: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Token
Zusätzliches Zugriffstoken für die Authentifizierung kritischer Vorgänge für das Resource Guard-Abonnement
Type: | String |
Position: | Named |
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 |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für