New-AzRecoveryServicesBackupProtectionPolicy

Vytvoří zásadu ochrany zálohování.

Syntaxe

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

Rutina New-AzRecoveryServicesBackupProtectionPolicy vytvoří zásadu ochrany zálohování v trezoru. Zásady ochrany jsou přidružené alespoň k jedné zásadě uchovávání informací. Zásady uchovávání informací definují, jak dlouho se bod obnovení uchovává se službou Azure Backup. K získání výchozích zásad uchovávání informací můžete použít rutinu Get-AzRecoveryServicesBackupRetentionPolicyObject. Pomocí rutiny Get-AzRecoveryServicesBackupSchedulePolicyObject můžete získat výchozí zásady plánu. Objekty SchedulePolicy a RetentionPolicy se používají jako vstupy rutiny New-AzRecoveryServicesBackupProtectionPolicy. Před použitím aktuální rutiny nastavte kontext trezoru pomocí rutiny Set-AzRecoveryServicesVaultContext.

Příklady

Příklad 1: Vytvoření zásady ochrany zálohování

$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

První příkaz získá základní SchedulePolicyObject a pak ho uloží do $SchPol proměnné. Druhý příkaz odebere všechny naplánované časy spuštění ze zásad plánu v $SchPol. Třetí příkaz používá rutinu Get-Date k získání aktuálního data a času. Čtvrtý příkaz přidá aktuální datum a čas v $Dt jako naplánovaný čas běhu do zásad plánu. Pátý příkaz získá základní objekt RetentionPolicy a pak ho uloží do $RetPol proměnné. Šestý příkaz nastaví zásadu doby uchovávání informací na 365 dnů. Poslední příkaz vytvoří objekt BackupProtectionPolicy na základě zásad plánu a uchovávání informací vytvořených předchozími příkazy.

Příklad 2: Vytvoření zásady sdílení souborů pro více záloh za den

$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

První příkaz získá základní hodinovou hodnotu SchedulePolicyObject a pak ho uloží do proměnné $schedulePolicy. Druhý a třetí příkaz načte časové pásmo a aktualizuje časové pásmo v $schedulePolicy. Čtvrtý a pátý příkaz inicializuje čas spuštění okna plánu a aktualizuje $schedulePolicy. Upozorňujeme, že počáteční čas musí být ve standardu UTC, i když časové pásmo není UTC. Šestý a sedmý příkaz aktualizuje interval (v hodinách), po kterém se zálohování bude opakovat ve stejný den, dobu trvání (v hodinách), pro kterou se plán spustí. Osmý příkaz získá základní hodinový objekt RetentionPolicy a pak ho uloží do proměnné $retentionPolicy. Devátý příkaz nastaví zásadu doby uchovávání informací na 10 dnů. Poslední příkaz vytvoří objekt BackupProtectionPolicy na základě zásad plánu a uchovávání informací vytvořených předchozími příkazy.

Příklad 3

Vytvoří zásadu ochrany zálohování. (automaticky vygenerováno)

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

Příklad 4: Vytvoření nové zásady AzureVM pro povolení inteligentní vrstvení archivu s využitím úrovně TieringMode TierRecommended

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

Tento příkaz se používá k vytvoření zásady, která umožňuje archivaci inteligentní vrstvení pro vrstvovací režim TierRecommended, nastavíme parametr -MoveToArchiveTier tak, aby $true povolit inteligentní vrstvení. ÚroveňMode jsme nastavili na ÚroveňRecommended, aby se všechny doporučené body obnovení přesunuly do archivu. Upozorňujeme, že režim vrstvení TierRecommended se podporuje pouze pro typ úlohy AzureVM.

Příklad 5: Vytvoření nové zásady se zakázaným inteligentním vrstvováním archivu

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

Tento příkaz slouží k zakázání archivace inteligentní vrstvení při vytváření zásad, nastavíme MoveToArchiveTier parametr na $false zakázat vrstvení.

Příklad 6: Vytvoření standardní zásady časového pásma mimo UTC pro 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

První příkaz získá SchedulePolicyObject a pak ho uloží do proměnné $schedulePolicy. Druhý blok příkazu načte časové pásmo a datum a čas (localtime označený jako UTC) a aktualizuje časové pásmo a čas v $schedulePolicy. Upozorňujeme, že datum a čas by měl být vždy označený jako UTC, protože časové pásmo je dáno samostatně. Všimněte si také, že pro jiné typy úloh je třeba zadat časové pásmo v atributu $schedulePolicy.ScheduleRunTimeZone. Třetí blok příkazu aktualizuje zásady rozdílového plánu. Pak získáme nastavení retentionPolicyObject a aktualizace rozdílového a úplného uchovávání záloh. Nakonec vytvoříme objekt BackupProtectionPolicy na základě zásad plánu a uchovávání informací vytvořených předchozími příkazy.

Parametry

-BackupManagementType

Třída prostředků, které jsou chráněny. Tento parametr přijímá tyto hodnoty:

  • Virtuální počítač AzureVM
  • AzureStorage
  • AzureWorkload
Typ:Nullable<T>[BackupManagementType]
Přípustné hodnoty:AzureVM, AzureStorage, AzureWorkload
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-BackupSnapshotResourceGroup

Vlastní název skupiny prostředků pro ukládání okamžitých bodů obnovení spravovaných virtuálních počítačů Toto je volitelné.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BackupSnapshotResourceGroupSuffix

Vlastní přípona názvu skupiny prostředků pro ukládání okamžitých bodů obnovení spravovaných virtuálních počítačů Toto je volitelné.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MoveToArchiveTier

Určuje, jestli se body obnovení mají přesunout do archivu úložiště zásadami, nebo ne. Povolené hodnoty jsou $true, $false

Typ:Nullable<T>[Boolean]
Position:6
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název zásady.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RetentionPolicy

Určuje základní objekt RetentionPolicy . K získání objektu RetentionPolicy můžete použít rutinu Get-AzRecoveryServicesBackupRetentionPolicyObject.

Typ:RetentionPolicyBase
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SchedulePolicy

Určuje základní objekt SchedulePolicy . K získání objektu SchedulePolicy můžete použít rutinu Get-AzRecoveryServicesBackupSchedulePolicyObject.

Typ:SchedulePolicyBase
Position:5
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SnapshotConsistencyType

Typ konzistence snímků, který se má použít pro zálohování. Pokud je nastavená hodnota OnlyCrashConsistent, budou mít všechny přidružené položky snímek konzistentní vzhledem k chybám. Možné hodnoty jsou OnlyCrashConsistent, Default

Typ:SnapshotConsistencyType
Přípustné hodnoty:Default, OnlyCrashConsistent
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TierAfterDuration

Určuje dobu, po které by se body obnovení měly začít přesouvat na archivní úroveň, může být hodnota ve dnech nebo měsících. Platí pouze v případě, že tieringMode je TierAllEligible

Typ:Nullable<T>[Int32]
Position:8
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TierAfterDurationType

Určuje, jestli je hodnota TierAfterDuration ve dnech nebo měsících.

Typ:String
Přípustné hodnoty:Days, Months
Position:9
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TieringMode

Určuje, jestli se mají přesunout doporučené nebo všechny oprávněné body obnovení do archivu.

Typ:TieringMode
Přípustné hodnoty:TierRecommended, TierAllEligible
Position:7
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VaultId

ID ARM trezoru služby Recovery Services

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WorkloadType

Typ úlohy prostředku Tento parametr přijímá tyto hodnoty:

  • Virtuální počítač AzureVM
  • AzureFiles
  • MSSQL
Typ:WorkloadType
Přípustné hodnoty:AzureVM, AzureFiles, MSSQL
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

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

Výstupy

PolicyBase