Dela via


Set-AzRecoveryServicesBackupProtectionPolicy

Ändrar en princip för säkerhetskopieringsskydd.

Syntax

ModifyPolicyParamSet

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>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FixPolicyParamSet

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:

  1. Hämta en grundläggande SchedulePolicyObject och grundläggande RetentionPolicyObject. Lagra dem i någon variabel.
  2. 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.
  3. 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.
  4. Ä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:

  1. Hämta en bas varje timme SchedulePolicyObject och bastimvis RetentionPolicyObject. Lagra dem i någon variabel.
  2. 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.
  3. 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.
  4. Ä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 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 $false

Det 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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FixForInconsistentItems

Växla parameter som anger om principuppdatering ska försöka uppdateras igen för misslyckade objekt.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

FixPolicyParamSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MoveToArchiveTier

Anger om återställningspunkter ska flyttas till arkivlagring av principen eller inte. Tillåtna värden är $true, $false

Parameteregenskaper

Typ:

Nullable<T>[Boolean]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:PolicyBase
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RetentionPolicy

Anger den grundläggande kvarhållningsprincipen. Om du vill hämta ett RetentionPolicy-objekt använder du cmdleten Get-AzRecoveryServicesBackupRetentionPolicyObject.

Parameteregenskaper

Typ:RetentionPolicyBase
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:2
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SchedulePolicy

Anger principobjektet för basschemat. Om du vill hämta ett SchedulePolicy-objekt använder du objektet Get-AzRecoveryServicesBackupSchedulePolicyObject.

Parameteregenskaper

Typ:SchedulePolicyBase
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:3
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SecureToken

Parameter för att auktorisera åtgärder som skyddas av resursskydd mellan klientorganisationer. Använd kommandot (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx"). Token för att hämta auktoriseringstoken för olika klientorganisationer

Parameteregenskaper

Typ:SecureString
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:SnapshotConsistencyType
Standardvärde:None
Godkända värden:Default, OnlyCrashConsistent
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TierAfterDurationType

Anger om TierAfterDuration är i dagar eller månader

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Days, Months
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TieringMode

Anger om du vill flytta rekommenderade eller alla berättigade återställningspunkter till arkivet

Parameteregenskaper

Typ:TieringMode
Standardvärde:None
Godkända värden:TierRecommended, TierAllEligible
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Token

Extra åtkomsttoken för autentisering av kritisk åtgärd till resource guard-prenumeration

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ModifyPolicyParamSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-VaultId

ARM-ID för Recovery Services-valvet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PolicyBase

String

Utdata

JobBase