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 $retentionPolicyHä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 DaysDet här kommandot används för att ändra principen för att aktivera arkiv smart nivåindelning för principen $policy anger vi -MoveToArchiveTier parametern 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 $falseDet här kommandot används för att inaktivera arkiv smart nivåindelning för principen $policy anger vi -MoveToArchiveTier parametern 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
| Typ: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
| Typ: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkända värden: | Default, OnlyCrashConsistent |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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 |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TierAfterDurationType
Anger om TierAfterDuration är i dagar eller månader
| Typ: | String |
| Godkända värden: | Days, Months |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-TieringMode
Anger om du vill flytta rekommenderade eller alla berättigade återställningspunkter till arkivet
| Typ: | TieringMode |
| Godkända värden: | TierRecommended, TierAllEligible |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Token
Extra åtkomsttoken för autentisering av kritisk åtgärd till resource guard-prenumeration
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-VaultId
ARM-ID för Recovery Services-valvet.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
-WhatIf
Visar vad som skulle hända om cmdleten körs.
| Typ: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
Indata
Utdata
Relaterade länkar
Azure PowerShell