Sdílet prostřednictvím

New-AzRecoveryServicesBackupProtectionPolicy

  • Reference
Modul:
Az.RecoveryServices

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

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

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
Type:Nullable<T>[BackupManagementType]
Accepted values:AzureVM, AzureStorage, AzureWorkload
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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é.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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é.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:Nullable<T>[Boolean]
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje název zásady.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetentionPolicy

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

Type:RetentionPolicyBase
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SchedulePolicy

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

Type:SchedulePolicyBase
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

Type:SnapshotConsistencyType
Accepted values:Default, OnlyCrashConsistent
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:Nullable<T>[Int32]
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TierAfterDurationType

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

Type:String
Accepted values:Days, Months
Position:9
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TieringMode

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

Type:TieringMode
Accepted values:TierRecommended, TierAllEligible
Position:7
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

ID ARM trezoru služby Recovery Services

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkloadType

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

  • Virtuální počítač AzureVM
  • AzureFiles
  • MSSQL
Type:WorkloadType
Accepted values:AzureVM, AzureFiles, MSSQL
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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