New-AzRecoveryServicesBackupProtectionPolicy

  • Referentie
Module:
Az.RecoveryServices

Hiermee maakt u een back-upbeveiligingsbeleid.

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

Met de cmdlet New-AzRecoveryServicesBackupProtectionPolicy maakt u 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 cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject gebruiken om het standaardretentiebeleid op te halen. En u kunt de cmdlet Get-AzRecoveryServicesBackupSchedulePolicyObject 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 cmdlet Set-AzRecoveryServicesVaultContext 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 maakt gebruik van de cmdlet Get-Date 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 base-uurlijk SchedulePolicyObject opgehaald 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-retentiepolicy-object per uur 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 om slimme archieflagen in te schakelen voor laagmodus TierRecommended. We stellen de parameter -MoveToArchiveTier 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 $schedulePolicy variabele. 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 het 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 aanvaardbare waarden voor deze parameter zijn:

  • 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

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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

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

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

-Name

Hiermee geeft u de naam van het beleid.

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

-RetentionPolicy

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

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

-SchedulePolicy

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

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

-TierAfterDurationType

Hiermee geeft u op of tierAfterDuration in dagen of maanden is

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

-TieringMode

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

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

-VaultId

ARM-id van de Recovery Services-kluis.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert.

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

-WorkloadType

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

  • 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

Invoerwaarden

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

Uitvoerwaarden

PolicyBase