Set-AzRecoveryServicesBackupProtectionPolicy
Ändrar en princip för säkerhetskopieringsskydd.
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>]
Description
Cmdleten Set-AzRecoveryServicesBackupProtectionPolicy ändrar en befintlig Azure Backup-skyddsprincip. Du kan ändra komponenterna säkerhetskopieringsschema och kvarhållningsprincip. Alla ändringar som du gör påverkar säkerhetskopieringen och kvarhållningen av de objekt som är associerade med principen. Ange valvkontexten med hjälp av cmdleten Set-AzRecoveryServicesVaultContext innan du använder den aktuella cmdleten.
Exempel
Exempel 1: Ändra en princip för säkerhetskopieringsskydd
$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"
Här är den övergripande beskrivningen av de steg som ska följas för att ändra en skyddsprincip:
- Hämta en grundläggande SchedulePolicyObject och grundläggande RetentionPolicyObject. Lagra dem i någon variabel.
- Ange de olika parametrarna för schema- och kvarhållningsprincipobjekt enligt dina behov. I exempelskriptet ovan försöker vi till exempel ange en skyddsprincip varje vecka. Därför ändrade vi schemafrekvensen till "Weekly" och uppdaterade även schemakörningstiden. I objektet för kvarhållningsprincip uppdaterade vi varaktigheten för veckovis kvarhållning och anger rätt flagga för "veckoschema aktiverat". Om du vill ange en daglig princip anger du flaggan "dagligt schema aktiverat" till true och tilldelar lämpliga värden för andra objektparametrar.
- Hämta den princip för säkerhetskopieringsskydd som du vill ändra och lagra den i en variabel. I exemplet ovan hämtade vi säkerhetskopieringsprincipen med namnet "TestPolicy" som vi ville ändra.
- Ändra säkerhetskopieringsskyddsprincipen som hämtades i steg 3 med hjälp av det ändrade schemaprincipobjektet och kvarhållningsprincipobjektet. Vi använder parametern BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix för att uppdatera resursgruppens namn på ögonblicksbilder för omedelbara RPs.
Exempel 2: Ändra Azure-fildelningsprincipen för flera säkerhetskopior per dag
$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
Här är den övergripande beskrivningen av de steg som ska följas för att ändra en fildelningsprincip för flera säkerhetskopior per dag:
- Hämta en bas varje timme SchedulePolicyObject och bastimvis RetentionPolicyObject. Lagra dem i någon variabel.
- Ange de olika parametrarna för schema- och kvarhållningsprincipobjekt enligt dina behov. I exempelskriptet ovan försöker vi till exempel ange den $timeZone där vi vill köra schemat som vi anger starttiden för timschemat och anger timintervall (i timmar), varefter säkerhetskopieringen återställs samma dag, varaktighet (i timmar) som schemat ska köras för. Nu ändrar vi kvarhållningsinställningen för dagliga återställningspunkter.
- Hämta den princip för säkerhetskopieringsskydd som du vill ändra och lagra den i en variabel. I exemplet ovan hämtade vi säkerhetskopieringsprincipen med namnet "TestPolicy" som vi ville ändra.
- Ändra säkerhetskopieringsskyddsprincipen som hämtades i steg 3 med hjälp av det ändrade schemaprincipobjektet och kvarhållningsprincipobjektet.
Exempel 3: Ändra AzureWorkload-princip för att aktivera arkiv smart nivåindelning
$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days
Det här kommandot används för att ändra principen för att aktivera arkivbaserad smart nivåindelning för principen $policy anger vi parametern -MoveToArchiveTier till $true för att aktivera nivåindelning. Vi väljer TieringMode som TierAllEligible för att flytta alla berättigade återställningspunkter till arkivet efter en viss varaktighet som anges av parametrarna TierAfterDuration och TierAfterDurationType. För att flytta rekommenderade återställningspunkter till Arkiv för AzureVM använder du TieringMode TierRecommended.
Exempel 4: Inaktivera smart nivåindelning för en befintlig princip
$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false
Det här kommandot används för att inaktivera arkivbaserad smart nivåindelning för principen $policy anger vi parametern -MoveToArchiveTier till $false. Observera att inaktivering av arkiv smart nivåindelning kan ha kostnadskonsekvenser.
Parametrar
-BackupSnapshotResourceGroup
Anpassat resursgruppnamn för att lagra de omedelbara återställningspunkterna för hanterade virtuella datorer. Det här är valfritt
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BackupSnapshotResourceGroupSuffix
Suffix för anpassat resursgruppnamn för att lagra de omedelbara återställningspunkterna för hanterade virtuella datorer. Det här är valfritt
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FixForInconsistentItems
Växla parameter som anger om principuppdatering ska försöka uppdateras igen för misslyckade objekt.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoveToArchiveTier
Anger om återställningspunkter ska flyttas till arkivlagring av principen eller inte. Tillåtna värden är $true, $false
Typ: | Nullable<T>[Boolean] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Policy
Anger den princip för säkerhetskopieringsskydd som den här cmdleten ändrar. Om du vill hämta ett BackupProtectionPolicy-objekt använder du cmdleten Get-AzRecoveryServicesBackupProtectionPolicy.
Typ: | PolicyBase |
Position: | 1 |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RetentionPolicy
Anger den grundläggande kvarhållningsprincipen. Om du vill hämta ett RetentionPolicy-objekt använder du cmdleten Get-AzRecoveryServicesBackupRetentionPolicyObject.
Typ: | RetentionPolicyBase |
Position: | 2 |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SchedulePolicy
Anger principobjektet för basschemat. Om du vill hämta ett SchedulePolicy-objekt använder du objektet Get-AzRecoveryServicesBackupSchedulePolicyObject.
Typ: | SchedulePolicyBase |
Position: | 3 |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SnapshotConsistencyType
Konsekvenstyp för ögonblicksbilder som ska användas för säkerhetskopiering. Om värdet är OnlyCrashConsistent kommer alla associerade objekt att ha kraschkonsekvent ögonblicksbild. Möjliga värden är OnlyCrashConsistent, Standard
Typ: | SnapshotConsistencyType |
accepterade värden: | Default, OnlyCrashConsistent |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TierAfterDuration
Anger varaktigheten efter vilken återställningspunkter ska börja flyttas till arkivnivån, värdet kan vara i dagar eller månader. Gäller endast när TieringMode är TierAllEligible
Typ: | Nullable<T>[Int32] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TierAfterDurationType
Anger om TierAfterDuration är i dagar eller månader
Typ: | String |
accepterade värden: | Days, Months |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TieringMode
Anger om du vill flytta rekommenderade eller alla berättigade återställningspunkter till arkivet
Typ: | TieringMode |
accepterade värden: | TierRecommended, TierAllEligible |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Token
Extra åtkomsttoken för autentisering av kritisk åtgärd till resource guard-prenumeration
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VaultId
ARM-ID för Recovery Services-valvet.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Utdata
Relaterade länkar
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för