Dela via

New-AzRecoveryServicesBackupProtectionPolicy

  • Referens
Modul:
Az.RecoveryServices

Skapar en princip för säkerhetskopieringsskydd.

Syntax

New-AzRecoveryServicesBackupProtectionPolicy
   [-Name] <String>
   [-WorkloadType] <WorkloadType>
   [[-BackupManagementType] <BackupManagementType>]
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [[-MoveToArchiveTier] <Boolean>]
   [[-TieringMode] <TieringMode>]
   [[-TierAfterDuration] <Int32>]
   [[-TierAfterDurationType] <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzRecoveryServicesBackupProtectionPolicy skapar en princip för säkerhetskopieringsskydd i ett valv. En skyddsprincip är associerad med minst en kvarhållningsprincip. Kvarhållningsprincipen definierar hur länge en återställningspunkt sparas med Azure Backup. Du kan använda cmdleten Get-AzRecoveryServicesBackupRetentionPolicyObject för att hämta standardprincipen för kvarhållning. Och du kan använda cmdleten Get-AzRecoveryServicesBackupSchedulePolicyObject för att hämta standardschemaprincipen. Objekten SchedulePolicy och RetentionPolicy används som indata till cmdleten New-AzRecoveryServicesBackupProtectionPolicy. Ange valvkontexten med hjälp av cmdleten Set-AzRecoveryServicesVaultContext innan du använder den aktuella cmdleten.

Exempel

Exempel 1: Skapa en princip för säkerhetskopieringsskydd

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM"
$SchPol.ScheduleRunTimes.Clear()
$Dt = Get-Date
$SchPol.ScheduleRunTimes.Add($Dt.ToUniversalTime())
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM"
$RetPol.DailySchedule.DurationCountInDays = 365
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $RetPol -SchedulePolicy $SchPol

Det första kommandot hämtar en bas SchedulePolicyObjectoch lagrar den sedan i variabeln $SchPol. Det andra kommandot tar bort alla schemalagda körningstider från schemaprincipen i $SchPol. Det tredje kommandot använder cmdleten Get-Date för att hämta aktuellt datum och tid. Det fjärde kommandot lägger till aktuellt datum och tid i $Dt som schemalagd körningstid i schemaprincipen. Det femte kommandot hämtar ett RetentionPolicy- objekt och lagrar det sedan i variabeln $RetPol. Det sjätte kommandot anger kvarhållningsvaraktighetsprincipen till 365 dagar. Det sista kommandot skapar ett BackupProtectionPolicy objekt baserat på schema- och kvarhållningsprinciperna som skapades av föregående kommandon.

Exempel 2: Skapa en fildelningsprincip för flera säkerhetskopior per dag

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -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 = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy.DailySchedule.DurationCountInDays = 10
New-AzRecoveryServicesBackupProtectionPolicy -Name "NewPolicy" -WorkloadType AzureVM -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy

Det första kommandot hämtar en bas varje timme SchedulePolicyObjectoch lagrar den sedan i variabeln $schedulePolicy. Det andra och tredje kommandot hämtar tidszonen och uppdaterar tidszonen i $schedulePolicy. Det fjärde och femte kommandot initierar starttiden för schemafönstret och uppdaterar $schedulePolicy. Observera att starttiden måste vara i UTC även om tidszonen inte är UTC. Det sjätte och sjunde kommandot uppdaterar intervallet (i timmar) efter vilket säkerhetskopieringen ska återaktiveras samma dag, varaktighet (i timmar) som schemat ska köras för. Det åttonde kommandot hämtar en bas varje timme RetentionPolicy objekt och lagrar det sedan i variabeln $retentionPolicy. Det nionde kommandot anger kvarhållningsvaraktighetsprincipen till 10 dagar. Det sista kommandot skapar ett BackupProtectionPolicy objekt baserat på schema- och kvarhållningsprinciperna som skapades av föregående kommandon.

Exempel 3

Skapar en princip för säkerhetskopieringsskydd. (automatiskt genererad)

New-AzRecoveryServicesBackupProtectionPolicy -Name 'NewPolicy' -RetentionPolicy $RetPol -SchedulePolicy $SchPol -VaultId $vault.ID -WorkloadType AzureVM

Exempel 4: Skapa en ny AzureVM-princip för att aktivera arkiv smart nivåindelning med TieringMode TierRecommended

$pol = New-AzRecoveryServicesBackupProtectionPolicy -Name newTierRecommendedPolicy -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -VaultId $vault.ID -MoveToArchiveTier $true -TieringMode TierRecommended

Det här kommandot används för att skapa en princip för att aktivera arkivbaserad smart nivåindelning för nivåindelningsläget TierRecommended. Vi anger -MoveToArchiveTier parametern till $true för att aktivera smart nivåindelning. Vi ställer in TieringMode på TierRecommended för att flytta alla rekommenderade återställningspunkter till arkivet. Observera att nivåindelningsläget TierRecommended endast stöds för arbetsbelastningstypen AzureVM.

Exempel 5: Skapa ny princip med arkiv smart nivåindelning inaktiverad

$pol = New-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID  -WorkloadType AzureVM -BackupManagementType AzureVM -RetentionPolicy $retPol -SchedulePolicy $schPol -MoveToArchiveTier $false

Det här kommandot används för att inaktivera arkivbaserad smart nivåindelning när du skapar en princip. Vi anger parametern MoveToArchiveTier till $false för att inaktivera nivåindelning.

Exempel 6: Skapa en standardprincip för icke UTC-tidszon för workloadType MSSQL

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload -PolicySubType Standard

$timeZone = Get-TimeZone -ListAvailable | Where-Object { $_.Id -match "Tokyo" } 
$date= Get-Date -Hour 9 -Minute 0 -Second 0 -Year 2022 -Day 26 -Month 12 -Millisecond 0
$date = [DateTime]::SpecifyKind($date,[DateTimeKind]::Utc)
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunFrequency = "Weekly"
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimes[0] = $date
$schedulePolicy.FullBackupSchedulePolicy.ScheduleRunTimeZone = $timeZone[0].Id

$schedulePolicy.IsDifferentialBackupEnabled = $true
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunDays[0] = "Wednesday"
$schedulePolicy.DifferentialBackupSchedulePolicy.ScheduleRunTimes[0] = $date.AddHours(1)

$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType MSSQL -BackupManagementType AzureWorkload

$retentionPolicy.DifferentialBackupRetentionPolicy.RetentionCount = 15

$retentionPolicy.FullBackupRetentionPolicy.IsDailyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.IsMonthlyScheduleEnabled = $false
$retentionPolicy.FullBackupRetentionPolicy.WeeklySchedule.DurationCountInWeeks = 35
$retentionPolicy.FullBackupRetentionPolicy.YearlySchedule.DurationCountInYears = 2

New-AzRecoveryServicesBackupProtectionPolicy -Name "Tokyo-mssql-policy" -WorkloadType MSSQL -BackupManagementType AzureWorkload -RetentionPolicy $retentionPolicy -SchedulePolicy $schedulePolicy -VaultId $vault.ID

Det första kommandot hämtar en SchedulePolicyObject-och lagrar den sedan i variabeln $schedulePolicy. Det andra kommandoblocket hämtar tidszonen och datetime (lokal tid markerad som UTC) och uppdaterar tidszonen och tiden i $schedulePolicy. Observera att datetime alltid ska markeras som UTC eftersom tidszonen anges separat. Observera också att tidszonen för andra arbetsbelastningstyper bör anges i attributet $schedulePolicy.ScheduleRunTimeZone. Det tredje kommandoblocket uppdaterar principen differentiellt schema. Sedan får vi RetentionPolicyObject och uppdaterar inställningar för differentiell och fullständig kvarhållning av säkerhetskopior. Slutligen skapar vi ett BackupProtectionPolicy objekt baserat på schema- och kvarhållningsprinciperna som skapades av föregående kommandon.

Parametrar

-BackupManagementType

Klassen med resurser som skyddas. De godtagbara värdena för den här parametern är:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Typ:Nullable<T>[BackupManagementType]
Godkända värden:AzureVM, AzureStorage, AzureWorkload
Position:3
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-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

-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:6
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på principen.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RetentionPolicy

Anger basobjektet RetentionPolicy. Du kan använda cmdleten Get-AzRecoveryServicesBackupRetentionPolicyObject för att hämta ett RetentionPolicy--objekt.

Typ:RetentionPolicyBase
Position:4
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SchedulePolicy

Anger basobjektet SchedulePolicy. Du kan använda cmdleten Get-AzRecoveryServicesBackupSchedulePolicyObject för att hämta ett SchedulePolicy--objekt.

Typ:SchedulePolicyBase
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
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:8
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:9
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:7
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

-WorkloadType

Resursens arbetsbelastningstyp. De godtagbara värdena för den här parametern är:

  • AzureVM
  • AzureFiles
  • MSSQL
Typ:WorkloadType
Godkända värden:AzureVM, AzureFiles, MSSQL
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

WorkloadType

Nullable<T>[[Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.BackupManagementType, Microsoft.Azure.PowerShell.Cmdlets.RecoveryServices.Backup.Models, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

RetentionPolicyBase

SchedulePolicyBase

String

Utdata

PolicyBase