Set-AzRecoveryServicesBackupProtectionPolicy

모듈:

Az.RecoveryServices

Backup 보호 정책을 수정합니다.

Syntax

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

Set-AzRecoveryServicesBackupProtectionPolicy cmdlet은 기존 Azure Backup 보호 정책을 수정합니다. 백업 일정 및 보존 정책 구성 요소를 수정할 수 있습니다. 변경한 내용은 정책과 연결된 항목의 백업 및 보존에 영향을 줍니다. 현재 cmdlet을 사용하기 전에 Set-AzRecoveryServicesVaultContext cmdlet을 사용하여 자격 증명 모음 컨텍스트를 설정합니다.

예제

예제 1: Backup 보호 정책 수정

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

다음은 보호 정책을 수정하기 위해 수행할 단계에 대한 개략적인 설명입니다.

1. 기본 SchedulePolicyObject 및 기본 RetentionPolicyObject를 가져옵니다. 일부 변수에 저장합니다.
2. 요구 사항에 따라 일정 및 보존 정책 개체의 다른 매개 변수를 설정합니다. 예를 들어 위의 샘플 스크립트에서는 주간 보호 정책을 설정하려고 합니다. 따라서 일정 빈도를 "매주"로 변경하고 일정 실행 시간도 업데이트했습니다. 보존 정책 개체에서 주간 보존 기간을 업데이트하고 올바른 "매주 일정 사용" 플래그를 설정했습니다. 일일 정책을 설정하려는 경우 "일별 일정 사용" 플래그를 true로 설정하고 다른 개체 매개 변수에 적절한 값을 할당합니다.
3. 수정하려는 백업 보호 정책을 가져와서 변수에 저장합니다. 위의 예제에서는 수정하려는 이름이 "TestPolicy"인 백업 정책을 검색했습니다.
4. 수정된 일정 정책 개체 및 보존 정책 개체를 사용하여 3단계에서 검색된 백업 보호 정책을 수정합니다. BackupSnapshotResourceGroup, BackupSnapshotResourceGroupSuffix 매개 변수를 사용하여 인스턴트 RP에 대한 스냅샷 리소스 그룹 이름을 업데이트합니다.

예제 2: 하루에 여러 백업에 대한 Azure 파일 공유 정책 수정

$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

다음은 하루에 여러 백업에 대한 파일 공유 정책을 수정하기 위해 수행해야 하는 단계에 대한 대략적인 설명입니다.

1. 기본 시간별 SchedulePolicyObject 및 기본 시간별 RetentionPolicyObject를 가져옵니다. 일부 변수에 저장합니다.
2. 요구 사항에 따라 일정 및 보존 정책 개체의 다른 매개 변수를 설정합니다. 예를 들어 위의 샘플 스크립트에서 시간별 일정의 시작 시간을 설정하고 시간 간격(시간)을 설정한 일정을 실행하려는 $timeZone 설정하려고 합니다. 그 후에는 같은 날, 일정이 실행되는 기간(시간)에 백업이 다시 시도됩니다. 다음으로 일별 복구 지점에 대한 보존 설정을 수정합니다.
3. 수정하려는 백업 보호 정책을 가져와서 변수에 저장합니다. 위의 예제에서는 수정하려는 이름이 "TestPolicy"인 백업 정책을 검색했습니다.
4. 수정된 일정 정책 개체 및 보존 정책 개체를 사용하여 3단계에서 검색된 백업 보호 정책을 수정합니다.

예제 3: 보관 스마트 계층화가 가능하도록 AzureWorkload 정책 수정

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

이 명령은 정책 $policy 대해 보관 스마트 계층을 사용하도록 정책을 수정하는 데 사용되며, 계층화가 가능하도록 $true -MoveToArchiveTier 매개 변수를 설정합니다. TierAfterDuration 및 TierAfterDurationType 매개 변수에서 지정된 특정 기간 후에 적격 복구 지점을 보관으로 이동하려면 TieringMode를 TierAllEligible로 선택합니다. 권장 복구 지점을 AzureVM 보관으로 이동하려면 TieringMode TierRecommended를 사용합니다.

예제 4: 기존 정책에서 스마트 계층화 사용 안 함

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

이 명령은 정책 $policy 대해 보관 스마트 계층을 사용하지 않도록 설정하는 데 사용됩니다. -MoveToArchiveTier 매개 변수를 $false 설정합니다. 보관 스마트 계층을 사용하지 않도록 설정하면 비용이 발생할 수 있습니다.

매개 변수

-BackupSnapshotResourceGroup

관리되는 가상 머신의 빠른 복구 지점을 저장하는 사용자 지정 리소스 그룹 이름입니다. 선택 사항입니다.

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

-BackupSnapshotResourceGroupSuffix

관리되는 가상 머신의 빠른 복구 지점을 저장하는 사용자 지정 리소스 그룹 이름 접미사입니다. 선택 사항입니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FixForInconsistentItems

실패한 항목에 대한 정책 업데이트를 다시 시도할지 여부를 나타내는 Switch 매개 변수입니다.

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

-MoveToArchiveTier

복구 지점을 정책에 따라 보관 스토리지로 이동할지 여부를 지정합니다. 허용되는 값은 $true $false

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Policy

이 cmdlet에서 수정하는 Backup 보호 정책을 지정합니다. BackupProtectionPolicy 개체를 가져오려면 Get-AzRecoveryServicesBackupProtectionPolicy cmdlet을 사용합니다.

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

-RetentionPolicy

기본 보존 정책을 지정합니다. RetentionPolicy 개체를 가져오려면 Get-AzRecoveryServicesBackupRetentionPolicyObject cmdlet을 사용합니다.

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

-SchedulePolicy

기본 일정 정책 개체를 지정합니다. SchedulePolicy 개체를 가져오려면 Get-AzRecoveryServicesBackupSchedulePolicyObject 개체를 사용합니다.

Type:	SchedulePolicyBase
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SnapshotConsistencyType

백업에 사용할 스냅샷 일관성 유형입니다. OnlyCrashConsistent로 설정하면 연결된 모든 항목은 크래시 일치 스냅샷. 가능한 값은 OnlyCrashConsistent, Default입니다.

Type:	SnapshotConsistencyType
Accepted values:	Default, OnlyCrashConsistent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TierAfterDuration

복구 지점이 보관 계층으로 이동하기 시작하는 기간을 지정합니다. 값은 일 또는 월 단위일 수 있습니다. TieringMode가 TierAllEligible인 경우에만 적용 가능

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TierAfterDurationType

TierAfterDuration이 일 또는 월인지 여부를 지정합니다.

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

-TieringMode

권장 복구 지점을 보관으로 이동할지 또는 모든 적격 복구 지점을 이동할지 여부를 지정합니다.

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

-Token

리소스 보호 구독에 중요한 작업을 인증하기 위한 보조 액세스 토큰

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

-VaultId

Recovery Services 자격 증명 모음의 ARM ID입니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다.

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

입력

PolicyBase

String

출력

JobBase

관련 링크

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