Delen via

New-AzRecoveryServicesBackupProtectionPolicy

  • Referentie
Module:
Az.RecoveryServices

Hiermee maakt u een back-upbeveiligingsbeleid.

Syntaxis

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

De New-AzRecoveryServicesBackupProtectionPolicy cmdlet maakt een back-upbeveiligingsbeleid in een kluis. Een beveiligingsbeleid is gekoppeld aan ten minste één bewaarbeleid. Het bewaarbeleid bepaalt hoe lang een herstelpunt wordt bewaard met Azure Backup. U kunt de Get-AzRecoveryServicesBackupRetentionPolicyObject-cmdlet gebruiken om het standaardretentiebeleid op te halen. En u kunt de Get-AzRecoveryServicesBackupSchedulePolicyObject-cmdlet gebruiken om het standaardschemabeleid op te halen. De SchedulePolicy-- en RetentionPolicy--objecten worden gebruikt als invoer voor de cmdlet New-AzRecoveryServicesBackupProtectionPolicy. Stel de kluiscontext in met behulp van de Set-AzRecoveryServicesVaultContext-cmdlet voordat u de huidige cmdlet gebruikt.

Voorbeelden

Voorbeeld 1: Een back-upbeveiligingsbeleid maken

$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

Met de eerste opdracht wordt een basis-SchedulePolicyObject-opgehaald en vervolgens opgeslagen in de $SchPol variabele. Met de tweede opdracht worden alle geplande uitvoeringstijden uit het planningsbeleid in $SchPol verwijderd. De derde opdracht gebruikt de Get-Date cmdlet om de huidige datum en tijd op te halen. Met de vierde opdracht wordt de huidige datum en tijd in $Dt toegevoegd als de geplande uitvoeringstijd aan het planningsbeleid. Met de vijfde opdracht wordt een base-RetentionPolicy--object opgehaald en vervolgens opgeslagen in de $RetPol variabele. Met de zesde opdracht wordt het bewaarduurbeleid ingesteld op 365 dagen. Met de laatste opdracht maakt u een BackupProtectionPolicy--object op basis van het schema en bewaarbeleid dat door de vorige opdrachten is gemaakt.

Voorbeeld 2: Een bestandssharebeleid maken voor meerdere back-ups 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

Met de eerste opdracht wordt een basis per uur SchedulePolicyObjectopgehaald en vervolgens opgeslagen in de $schedulePolicy variabele. Met de tweede en derde opdracht wordt de tijdzone opgehaald en wordt de tijdzone bijgewerkt in de $schedulePolicy. Met de vierde en vijfde opdracht wordt de begintijd van het planningsvenster geïnitialiseerd en wordt de $schedulePolicy bijgewerkt. Houd er rekening mee dat de begintijd utc moet zijn, zelfs als de tijdzone niet UTC is. Met de zesde en zevende opdracht wordt het interval (in uren) bijgewerkt waarna de back-up opnieuw wordt opgestart op dezelfde dag, duur (in uren) waarvoor de planning wordt uitgevoerd. De achtste opdracht krijgt een base per uur RetentionPolicy object en slaat het vervolgens op in de $retentionPolicy variabele. Met de negende opdracht wordt het bewaarduurbeleid ingesteld op 10 dagen. Met de laatste opdracht maakt u een BackupProtectionPolicy--object op basis van het schema en bewaarbeleid dat door de vorige opdrachten is gemaakt.

Voorbeeld 3

Hiermee maakt u een back-upbeveiligingsbeleid. (automatisch gegenereerd)

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

Voorbeeld 4: Nieuw AzureVM-beleid maken om slimme archieflagen in te schakelen met TieringMode TierRecommended

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

Deze opdracht wordt gebruikt om beleid te maken voor het inschakelen van slimme archieflagen voor laagmodus TierRecommended. We stellen -MoveToArchiveTier parameter in op $true om slimme lagen in te schakelen. We stellen TieringMode in op TierRecommended om alle aanbevolen herstelpunten naar archief te verplaatsen. Houd er rekening mee dat tierRecommended tiering-modus alleen wordt ondersteund voor het type AzureVM van het workloadtype.

Voorbeeld 5: Nieuw beleid maken met slimme archieflagen uitgeschakeld

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

Deze opdracht wordt gebruikt om het archiveren van slimme lagen uit te schakelen tijdens het maken van een beleid. We stellen de parameter MoveToArchiveTier in op $false om lagen uit te schakelen.

Voorbeeld 6: Een niet-UTC-tijdzonestandaardbeleid maken voor 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

Met de eerste opdracht wordt een SchedulePolicyObject-opgehaald en vervolgens opgeslagen in de variabele $schedulePolicy. Het tweede opdrachtblok haalt de tijdzone en datum/tijd (localtime gemarkeerd als UTC) op en werkt de tijdzone en tijd in de $schedulePolicy bij. Houd er rekening mee dat de datum/tijd altijd moet worden gemarkeerd als UTC, omdat de tijdzone afzonderlijk wordt gegeven. Houd er ook rekening mee dat voor andere tijdzones voor werkbelastingtypen moet worden opgegeven in het kenmerk $schedulePolicy.ScheduleRunTimeZone. Met het derde opdrachtblok wordt het beleid voor differentiële planning bijgewerkt. Vervolgens krijgen we de RetentionPolicyObject en werken we differentiële en volledige back-upretentie-instellingen bij. Ten slotte maken we een BackupProtectionPolicy--object op basis van het schema- en bewaarbeleid dat door de vorige opdrachten is gemaakt.

Parameters

-BackupManagementType

De klasse resources die worden beveiligd. De acceptabele waarden voor deze parameter zijn:

  • AzureVM
  • AzureStorage
  • AzureWorkload
Type:Nullable<T>[BackupManagementType]
Geaccepteerde waarden:AzureVM, AzureStorage, AzureWorkload
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-BackupSnapshotResourceGroup

De naam van de aangepaste resourcegroep voor het opslaan van de directe herstelpunten van beheerde virtuele machines. Dit is optioneel

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BackupSnapshotResourceGroupSuffix

Het achtervoegsel voor de naam van de aangepaste resourcegroep voor het opslaan van de directe herstelpunten van beheerde virtuele machines. Dit is optioneel

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MoveToArchiveTier

Hiermee geeft u op of herstelpunten moeten worden verplaatst naar archiefopslag door het beleid of niet. Toegestane waarden zijn $true, $false

Type:Nullable<T>[Boolean]
Position:6
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van het beleid.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RetentionPolicy

Hiermee geeft u de basis RetentionPolicy object. U kunt de cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject gebruiken om een RetentionPolicy--object op te halen.

Type:RetentionPolicyBase
Position:4
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SchedulePolicy

Hiermee geeft u de basis SchedulePolicy object. U kunt de cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject gebruiken om een SchedulePolicy--object op te halen.

Type:SchedulePolicyBase
Position:5
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SnapshotConsistencyType

Type momentopnameconsistentie dat moet worden gebruikt voor back-up. Als deze optie is ingesteld op OnlyCrashConsistent, hebben alle gekoppelde items een crashconsistente momentopname. Mogelijke waarden zijn OnlyCrashConsistent, Default

Type:SnapshotConsistencyType
Geaccepteerde waarden:Default, OnlyCrashConsistent
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TierAfterDuration

Hiermee geeft u de duur op waarna herstelpunten moeten worden verplaatst naar de archieflaag, de waarde kan in dagen of maanden zijn. Alleen van toepassing wanneer TieringMode TierAllEligible is

Type:Nullable<T>[Int32]
Position:8
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TierAfterDurationType

Hiermee geeft u op of tierAfterDuration in dagen of maanden is

Type:String
Geaccepteerde waarden:Days, Months
Position:9
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TieringMode

Hiermee geeft u op of aanbevolen of alle in aanmerking komende herstelpunten naar archief moeten worden verplaatst

Type:TieringMode
Geaccepteerde waarden:TierRecommended, TierAllEligible
Position:7
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VaultId

ARM-id van de Recovery Services-kluis.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WorkloadType

Workloadtype van de resource. De acceptabele waarden voor deze parameter zijn:

  • AzureVM
  • AzureFiles
  • MSSQL
Type:WorkloadType
Geaccepteerde waarden:AzureVM, AzureFiles, MSSQL
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

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

Uitvoerwaarden