Set-AzRecoveryServicesBackupProtectionPolicy

Hiermee wijzigt u een back-upbeveiligingsbeleid.

Syntax

Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [[-RetentionPolicy] <RetentionPolicyBase>]
   [[-SchedulePolicy] <SchedulePolicyBase>]
   [-MoveToArchiveTier <Boolean>]
   [-TieringMode <TieringMode>]
   [-TierAfterDuration <Int32>]
   [-TierAfterDurationType <String>]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [-FixForInconsistentItems]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzRecoveryServicesBackupProtectionPolicy wijzigt een bestaand Azure Backup-beveiligingsbeleid. U kunt de onderdelen van het back-upschema en het bewaarbeleid wijzigen. Wijzigingen die u aanbrengt, zijn van invloed op de back-up en retentie van de items die aan het beleid zijn gekoppeld. Stel de kluiscontext in met behulp van de cmdlet Set-AzRecoveryServicesVaultContext voordat u de huidige cmdlet gebruikt.

Voorbeelden

Voorbeeld 1: Een back-upbeveiligingsbeleid wijzigen

$SchPol = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType "AzureVM" 
$SchPol.ScheduleRunTimes.Clear()
$Time = Get-Date
$Time1 = Get-Date -Year $Time.Year -Month $Time.Month -Day $Time.Day -Hour $Time.Hour -Minute 0 -Second 0 -Millisecond 0
$Time1 = $Time1.ToUniversalTime()
$SchPol.ScheduleRunTimes.Add($Time1)
$SchPol.ScheduleRunFrequency.Clear
$SchPol.ScheduleRunDays.Add("Monday")
$SchPol.ScheduleRunFrequency="Weekly"
$RetPol = Get-AzRecoveryServicesBackupRetentionPolicyObject -WorkloadType "AzureVM" 
$RetPol.IsDailyScheduleEnabled=$false
$RetPol.DailySchedule.DurationCountInDays = 0
$RetPol.IsWeeklyScheduleEnabled=$true 
$RetPol.WeeklySchedule.DaysOfTheWeek.Add("Monday")
$RetPol.WeeklySchedule.DurationCountInWeeks = 365
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "azurefiles" -Name "azurefilesvault"
$Pol= Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
$Pol.SnapshotRetentionInDays=5
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $Pol -SchedulePolicy $SchPol -RetentionPolicy $RetPol -BackupSnapshotResourceGroup "snapshotResourceGroupPrefix" -BackupSnapshotResourceGroupSuffix "snapshotResourceGroupSuffix"

Hier volgt de beschrijving op hoog niveau van de stappen die moeten worden gevolgd voor het wijzigen van een beveiligingsbeleid:

  1. Haal een base SchedulePolicyObject en base RetentionPolicyObject op. Sla ze op in een variabele.
  2. Stel de verschillende parameters van het plannings- en bewaarbeleidsobject in op basis van uw behoeften. In het bovenstaande voorbeeldscript proberen we bijvoorbeeld een wekelijks beveiligingsbeleid in te stellen. Daarom hebben we de planningsfrequentie gewijzigd in Wekelijks en ook de uitvoeringstijd van het schema bijgewerkt. In het bewaarbeleidsobject hebben we de wekelijkse bewaarduur bijgewerkt en de juiste vlag 'wekelijks gepland ingeschakeld' ingesteld. Als u een dagelijks beleid wilt instellen, stelt u de vlag 'dagelijkse planning ingeschakeld' in op waar en wijst u de juiste waarden toe voor andere objectparameters.
  3. Haal het back-upbeveiligingsbeleid op dat u wilt wijzigen en sla het op in een variabele. In het bovenstaande voorbeeld hebben we het back-upbeleid opgehaald met de naam 'TestPolicy' die we wilden wijzigen.
  4. Wijzig het back-upbeveiligingsbeleid dat is opgehaald in stap 3 met behulp van het gewijzigde beleidsobject en het bewaarbeleidsobject. We gebruiken de parameter BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix om de naam van de resourcegroep voor momentopnamen bij te werken voor directe RPs.

Voorbeeld 2: Azure-bestandssharebeleid wijzigen voor meerdere back-ups per dag

$schedulePolicy = Get-AzRecoveryServicesBackupSchedulePolicyObject -WorkloadType AzureFiles -BackupManagementType AzureStorage -ScheduleRunFrequency Hourly
$retentionPolicy = Get-AzRecoveryServicesBackupRetentionPolicyObject -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.DailySchedule.DurationCountInDays = 6
$policy = Get-AzRecoveryServicesBackupProtectionPolicy -Name "TestPolicy" -VaultId $vault.ID
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $policy -VaultId $vault.ID -SchedulePolicy $schedulePolicy -RetentionPolicy $retentionPolicy

Hier volgt de beschrijving op hoog niveau van de stappen die moeten worden gevolgd voor het wijzigen van een bestandssharebeleid voor meerdere back-ups per dag:

  1. Haal een basis op uurbasis SchedulePolicyObject en base elk uur RetentionPolicyObject op. Sla ze op in een variabele.
  2. Stel de verschillende parameters van het plannings- en bewaarbeleidsobject in op basis van uw behoeften. In het bovenstaande voorbeeldscript proberen we bijvoorbeeld de $timeZone in te stellen waarin we het schema willen uitvoeren waarin we de begintijd van het uurschema instellen, het uurinterval (in uren) instellen, waarna de back-up opnieuw wordtrigger op dezelfde dag, duur (in uren) waarvoor de planning wordt uitgevoerd. Vervolgens wijzigen we de bewaarinstelling voor dagelijkse herstelpunten.
  3. Haal het back-upbeveiligingsbeleid op dat u wilt wijzigen en sla het op in een variabele. In het bovenstaande voorbeeld hebben we het back-upbeleid opgehaald met de naam 'TestPolicy' die we wilden wijzigen.
  4. Wijzig het back-upbeveiligingsbeleid dat is opgehaald in stap 3 met behulp van het gewijzigde beleidsobject en het bewaarbeleidsobject.

Voorbeeld 3: AzureWorkload-beleid wijzigen om slimme archieflagen in te schakelen

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $true -TieringMode TierAllEligible -TierAfterDuration 60 -TierAfterDurationType Days

Deze opdracht wordt gebruikt om beleid te wijzigen voor het inschakelen van slimme archieflagen voor het beleid $policy. We stellen de parameter -MoveToArchiveTier in op $true om lagen in te schakelen. We kiezen TieringMode als TierAllEligible om alle in aanmerking komende herstelpunten te verplaatsen naar archief na een bepaalde duur die is opgegeven door de parameters TierAfterDuration en TierAfterDurationType. Gebruik TieringMode TierRecommended om aanbevolen herstelpunten te verplaatsen naar Archive for AzureVM.

Voorbeeld 4: Slimme lagen uitschakelen voor een bestaand beleid

$pol = Set-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Policy $policy -MoveToArchiveTier $false

Deze opdracht wordt gebruikt om het archiveren van slimme lagen voor het beleid $policy uit te schakelen. We stellen de parameter -MoveToArchiveTier in op $false. Houd er rekening mee dat het uitschakelen van slimme archieflagen gevolgen kan hebben voor kosten.

Parameters

-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

-FixForInconsistentItems

Schakel de parameter om aan te geven of beleidsupdate voor mislukte items al dan niet opnieuw moet worden uitgevoerd.

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

-Policy

Hiermee geeft u het back-upbeveiligingsbeleid op dat door deze cmdlet wordt gewijzigd. Gebruik de cmdlet Get-AzRecoveryServicesBackupProtectionPolicy om een BackupProtectionPolicy-object op te halen.

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

-RetentionPolicy

Hiermee geeft u het basisretentiebeleid op. Gebruik de cmdlet Get-AzRecoveryServicesBackupRetentionPolicyObject om een RetentionPolicy-object te verkrijgen.

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

-SchedulePolicy

Hiermee geeft u het basisplanningsbeleidsobject. Gebruik het object Get-AzRecoveryServicesBackupSchedulePolicyObject om een SchedulePolicy-object te verkrijgen.

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

-Token

Hulptoegangstoken voor verificatie van kritieke bewerking voor resource guard-abonnement

Type:String
Position:Named
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

Invoerwaarden

PolicyBase

String

Uitvoerwaarden

JobBase