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
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