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 také můžete získat výchozí zásady plánu. Objekty SchedulePolicy a RetentionPoli cy 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í SchedulePolicyObjecta pak ho uloží do proměnné $SchPol. 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í RetentionPolicy objektu a uloží ho do proměnné $RetPol. Šestý příkaz nastaví zásadu doby uchovávání informací na 365 dnů. Poslední příkaz vytvoří BackupProtectionPolicy objekt 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 SchedulePolicyObjecta 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ý RetentionPolicy objekt a uloží ho do proměnné $retentionPolicy. Devátý příkaz nastaví zásadu doby uchovávání informací na 10 dnů. Poslední příkaz vytvoří BackupProtectionPolicy objekt 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 slouží k vytvoření zásad pro povolení archivace inteligentní vrstvení pro vrstvení v režimu vrstvení, nastavíme parametr -MoveToArchiveTier na $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á SchedulePolicyObjecta 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 RetentionPolicyObject a aktualizujeme rozdílové a úplné nastavení 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. Přijatelné hodnoty pro tento parametr jsou:
- 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 vás vyzve 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. Pomocí rutiny Get-AzRecoveryServicesBackupRetentionPolicyObject můžete získat objekt RetentionPolicy.
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í SchedulePolicy objektu. Rutinu Get-AzRecoveryServicesBackupSchedulePolicyObject můžete použít k získání objektu SchedulePolicy.
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
Ukazuje, co se stane, když se rutina spustí.
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 Přijatelné hodnoty pro tento parametr jsou:
- 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
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]]
Výstupy
Související odkazy
Azure PowerShell