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:
- Pobierz podstawowy obiekt SchedulePolicyObject i podstawowy obiekt RetentionPolicyObject. Przechowuj je w jakiejś zmiennej.
- 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.
- 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ć.
- 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:
- Uzyskaj co godzinę obiekt SchedulePolicyObject i podstawową godzinę RetentionPolicyObject. Przechowuj je w jakiejś zmiennej.
- 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.
- 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ć.
- 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 |