Edit-AzDataProtectionPolicyRetentionRuleClientObject
기존 백업 정책에 보존 규칙을 추가하거나 제거합니다. AzureBlob 하이브리드 정책의 경우 OperationalStore 수명 주기는 -Name Default_OperationalStore 사용해야 합니다. -Name 기본값은 VaultStore용으로 예약되어 있습니다. 이러한 항목을 혼합하거나 OperationalStore 수명 주기를 매주/매월/매년 연결하면 유효성 검사 오류가 발생합니다.
구문
RemoveRetention (기본값)
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
[-RemoveRule]
[<CommonParameters>]
AddRetention
Edit-AzDataProtectionPolicyRetentionRuleClientObject
-Policy <IBackupPolicy>
-Name <RetentionRuleName>
-IsDefault <Boolean>
-LifeCycles <ISourceLifeCycle[]>
[-OverwriteLifeCycle <Boolean>]
[<CommonParameters>]
Description
기존 백업 정책에 보존 규칙을 추가하거나 제거합니다. AzureBlob 하이브리드 정책의 경우 OperationalStore 수명 주기는 -Name Default_OperationalStore 사용해야 합니다. -Name 기본값은 VaultStore용으로 예약되어 있습니다. 이러한 항목을 혼합하거나 OperationalStore 수명 주기를 매주/매월/매년 연결하면 유효성 검사 오류가 발생합니다.
예제
예제 1: 매주 보존 규칙 추가
$pol = Get-AzDataProtectionPolicyTemplate
$lifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Weeks -SourceRetentionDurationCount 5
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -LifeCycles $lifecycle -IsDefault $false
DatasourceType ObjectType
-------------- ----------
{Microsoft.Compute/disks} BackupPolicy
첫 번째 명령은 기본 정책 템플릿을 가져옵니다. 두 번째 명령은 주별 수명 주기 개체를 만듭니다. 세 번째 명령은 주별 보존 규칙을 기본 정책에 추가합니다.
예제 2: 매주 보존 규칙 제거
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Weekly -RemoveRule
DatasourceType ObjectType
-------------- ----------
{Microsoft.Compute/disks} BackupPolicy
이 명령은 지정된 백업 정책에 있는 경우 주간 보존 규칙을 제거합니다.
예제 3: AzureBlob 정책에 OperationalStore 보존 규칙 추가
$pol = Get-AzDataProtectionPolicyTemplate -DatasourceType AzureBlob
$opLifecycle = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore OperationalStore -SourceRetentionDurationType Days -SourceRetentionDurationCount 30
Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $pol -Name Default_OperationalStore -LifeCycles $opLifecycle -IsDefault $true
DatasourceType ObjectType
-------------- ----------
{Microsoft.Storage/storageAccounts/blobServices} BackupPolicy
AzureBlob의 경우 OperationalStore 보존 규칙의 이름을 지정Default_OperationalStore.
규칙이 추가됩니다. 정책 템플릿의 기존 Default (VaultStore) 보존 규칙이 유지됩니다.
OperationalStore 수명 주기를 사용하여 전달하는 -Name Default 것은 유효성 검사에 의해 거부됩니다.
참고: -OverwriteLifeCycle 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.
설정 -OverwriteLifeCycle $false 은 기존 보존 규칙을 $true 업데이트하는 것을 차단합니다. 이 매개 변수가 제거되면 기본 동작인 기존 규칙의 수명 주기가 대체됩니다.
매개 변수
-IsDefault
보존 규칙이 기본 보존 규칙인지를 지정합니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AddRetention
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-LifeCycles
보존 규칙과 연결된 수명 주기입니다.
매개 변수 속성
| 형식: | |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AddRetention
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
보존 규칙 이름입니다. 참고: "기본" 보존 규칙은 수명 주기에 관계없이 제거할 수 없습니다.
매개 변수 속성
| 형식: | RetentionRuleName |
| Default value: | None |
| 허용되는 값: | Default, Daily, Weekly, Monthly, Yearly, Default_OperationalStore |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-OverwriteLifeCycle
[사용되지 않음] 선택적; 이 매개 변수는 향후 릴리스에서 제거될 예정입니다. -OverwriteLifeCycle $false 설정하면 기존 보존 규칙 업데이트가 차단되며, $true 또는 생략하면 기존 규칙 수명 주기가 대체됩니다. 이 매개 변수가 제거되면 기본 동작입니다.
매개 변수 속성
| 형식: | |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AddRetention
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Policy
Backup 정책 개체
매개 변수 속성
| 형식: | IBackupPolicy |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RemoveRule
보존 규칙을 제거할지 여부를 지정합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
RemoveRetention
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
