Udostępnij za pośrednictwem


Set-AzRecoveryServicesBackupProtectionPolicy

Modyfikuje zasady ochrony kopii zapasowych.

Składnia

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

Opis

Polecenie cmdlet Set-AzRecoveryServicesBackupProtectionPolicy modyfikuje istniejące zasady ochrony usługi Azure Backup. Możesz zmodyfikować składniki zasad harmonogram tworzenia kopii zapasowych i przechowywania. Wszelkie wprowadzone zmiany wpływają na tworzenie kopii zapasowych i przechowywanie elementów skojarzonych z zasadami. Ustaw kontekst magazynu przy użyciu polecenia cmdlet Set-AzRecoveryServicesVaultContext przed użyciem bieżącego polecenia cmdlet.

Przykłady

Przykład 1. Modyfikowanie zasad ochrony kopii zapasowych

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

Poniżej przedstawiono ogólny opis kroków, które należy wykonać w celu zmodyfikowania zasad ochrony:

  1. Pobierz podstawowy obiekt SchedulePolicyObject i podstawowy obiekt RetentionPolicyObject. Przechowuj je w jakiejś zmiennej.
  2. Ustaw różne parametry obiektu zasad harmonogramu i przechowywania zgodnie z wymaganiami. Na przykład — w powyższym przykładowym skrycie próbujemy ustawić tygodniowe zasady ochrony. W związku z tym zmieniliśmy częstotliwość harmonogramu na "Co tydzień", a także zaktualizowaliśmy czas wykonywania harmonogramu. W obiekcie zasad przechowywania zaktualizowaliśmy tygodniowy czas przechowywania i ustawiliśmy prawidłową flagę "włączony harmonogram tygodniowy". Jeśli chcesz ustawić zasady Codzienne, ustaw flagę "dzienny harmonogram włączony" na wartość true i przypisz odpowiednie wartości dla innych parametrów obiektu.
  3. Pobierz zasady ochrony kopii zapasowych, które chcesz zmodyfikować i zapisać w zmiennej. W powyższym przykładzie pobraliśmy zasady kopii zapasowej o nazwie "TestPolicy", którą chcieliśmy zmodyfikować.
  4. Zmodyfikuj zasady ochrony kopii zapasowych pobrane w kroku 3 przy użyciu zmodyfikowanego obiektu zasad harmonogramu i obiektu zasad przechowywania. Używamy parametru BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix w celu zaktualizowania nazwy grupy zasobów migawki dla błyskawicznych adresów IP.

Przykład 2. Modyfikowanie zasad udziału plików platformy Azure dla wielu kopii zapasowych dziennie

$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

Poniżej przedstawiono ogólny opis kroków, które należy wykonać w celu zmodyfikowania zasad udostępniania plików dla wielu kopii zapasowych dziennie:

  1. Uzyskaj co godzinę obiekt SchedulePolicyObject i podstawową godzinę RetentionPolicyObject. Przechowuj je w jakiejś zmiennej.
  2. Ustaw różne parametry obiektu zasad harmonogramu i przechowywania zgodnie z wymaganiami. Na przykład — w powyższym przykładowym skrypsie próbujemy ustawić $timeZone, w którym chcemy uruchomić harmonogram, ustawiamy godzinę rozpoczęcia harmonogramu godzinowego, ustawiając interwał godzinowy (w godzinach), po którym kopia zapasowa zostanie ponowiona w tym samym dniu, czas trwania (w godzinach), dla którego harmonogram zostanie uruchomiony. Następnie modyfikujemy ustawienie przechowywania dla codziennych punktów odzyskiwania.
  3. Pobierz zasady ochrony kopii zapasowych, które chcesz zmodyfikować i zapisać w zmiennej. W powyższym przykładzie pobraliśmy zasady kopii zapasowej o nazwie "TestPolicy", którą chcieliśmy zmodyfikować.
  4. Zmodyfikuj zasady ochrony kopii zapasowych pobrane w kroku 3 przy użyciu zmodyfikowanego obiektu zasad harmonogramu i obiektu zasad przechowywania.

Przykład 3. Modyfikowanie zasad AzureWorkload w celu włączenia warstw inteligentnych Archiwum

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

To polecenie służy do modyfikowania zasad w celu włączenia archiwizacji warstw inteligentnych dla zasad $policy, ustawiamy parametr -MoveToArchiveTier na $true w celu włączenia obsługi warstw. Wybieramy warstwyMode jako WarstwaAllEligible, aby przenieść wszystkie kwalifikujące się punkty odzyskiwania do archiwum po określonym czasie trwania podanym przez parametry TierAfterDuration i TierAfterDurationType. Aby przenieść zalecane punkty odzyskiwania do warstwy Archiwum dla maszyny wirtualnej AzureVM, użyj warstwy TieringModeRecommended.

Przykład 4. Wyłączanie obsługi warstw inteligentnych w istniejących zasadach

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

To polecenie służy do wyłączania warstw inteligentnych archiwum dla $policy zasad, ustawiamy parametr -MoveToArchiveTier na $false. Należy pamiętać, że wyłączenie warstw inteligentnych archiwum może mieć wpływ na koszty.

Parametry

-BackupSnapshotResourceGroup

Niestandardowa nazwa grupy zasobów do przechowywania natychmiastowych punktów odzyskiwania zarządzanych maszyn wirtualnych. Jest to opcjonalne

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-BackupSnapshotResourceGroupSuffix

Niestandardowy sufiks nazwy grupy zasobów do przechowywania natychmiastowych punktów odzyskiwania zarządzanych maszyn wirtualnych. Jest to opcjonalne

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FixForInconsistentItems

Switch Parametr wskazujący, czy ponowić próbę aktualizacji zasad dla elementów, które zakończyły się niepowodzeniem.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MoveToArchiveTier

Określa, czy punkty odzyskiwania powinny być przenoszone do magazynu archiwum przez zasady, czy nie. Dozwolone wartości są $true, $false

Typ:Nullable<T>[Boolean]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Policy

Określa zasady ochrony kopii zapasowych, które modyfikuje to polecenie cmdlet. Aby uzyskać obiekt BackupProtectionPolicy , użyj polecenia cmdlet Get-AzRecoveryServicesBackupProtectionPolicy.

Typ:PolicyBase
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RetentionPolicy

Określa zasady przechowywania podstawowego. Aby uzyskać obiekt RetentionPolicy , użyj polecenia cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject.

Typ:RetentionPolicyBase
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SchedulePolicy

Określa podstawowy obiekt zasad harmonogramu. Aby uzyskać obiekt SchedulePolicy , użyj obiektu Get-AzRecoveryServicesBackupSchedulePolicyObject.

Typ:SchedulePolicyBase
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SnapshotConsistencyType

Typ spójności migawki do użycia na potrzeby tworzenia kopii zapasowej. Jeśli ustawiono wartość OnlyCrashConsistent, wszystkie skojarzone elementy będą miały spójną migawkę spójną na poziomie awarii. Możliwe wartości to OnlyCrashConsistent, Default

Typ:SnapshotConsistencyType
Dopuszczalne wartości:Default, OnlyCrashConsistent
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TierAfterDuration

Określa czas trwania, po którym punkty odzyskiwania powinny zacząć przechodzić do warstwy archiwum, wartość może być w dniach lub miesiącach. Dotyczy tylko wtedy, gdy tryb TieringMode to TierAllEligible

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TierAfterDurationType

Określa, czy właściwość TierAfterDuration jest wyrażona w dniach lub miesiącach

Typ:String
Dopuszczalne wartości:Days, Months
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TieringMode

Określa, czy przenieść zalecane, czy wszystkie kwalifikujące się punkty odzyskiwania do archiwum

Typ:TieringMode
Dopuszczalne wartości:TierRecommended, TierAllEligible
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Token

Pomocniczy token dostępu do uwierzytelniania krytycznej operacji w subskrypcji ochrony zasobów

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VaultId

Identyfikator ARM magazynu usługi Recovery Services.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PolicyBase

String

Dane wyjściowe

JobBase