Set-AzRecoveryServicesBackupProtectionPolicy

Module:

Az.RecoveryServices

Hiermee wijzigt u een back-upbeveiligingsbeleid.

Syntaxis

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

Set-AzRecoveryServicesBackupProtectionPolicy
   [-Policy] <PolicyBase>
   [-FixForInconsistentItems]
   [-BackupSnapshotResourceGroup <String>]
   [-BackupSnapshotResourceGroupSuffix <String>]
   [-SnapshotConsistencyType <SnapshotConsistencyType>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De Set-AzRecoveryServicesBackupProtectionPolicy cmdlet 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 Set-AzRecoveryServicesVaultContext-cmdlet 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 om slimme archieflagen in te schakelen voor het beleid $policy. We stellen -MoveToArchiveTier parameter 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 -MoveToArchiveTier parameter 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
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

-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
Vereist:	True
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:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	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
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-SchedulePolicy

Hiermee geeft u het basisplanningsbeleidsobject. Als u een SchedulePolicy--object wilt verkrijgen, gebruikt u het Get-AzRecoveryServicesBackupSchedulePolicyObject-object.

Type:	SchedulePolicyBase
Position:	3
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
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:	Named
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:	Named
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:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Token

Hulptoegangstoken voor verificatie van kritieke bewerking voor resource guard-abonnement

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

Invoerwaarden

PolicyBase

String

Uitvoerwaarden

JobBase

Verwante koppelingen

• Get-AzRecoveryServicesBackupProtectionPolicy
• Get-AzRecoveryServicesBackupRetentionPolicyObject
• New-AzRecoveryServicesBackupProtectionPolicy
• Remove-AzRecoveryServicesBackupProtectionPolicy