Get-AzRecoveryServicesBackupRecoveryPoint
백업된 항목의 복구 지점을 가져옵니다.
구문
Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzRecoveryServicesBackupRecoveryPoint
[[-StartDate] <DateTime>]
[[-EndDate] <DateTime>]
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-RecoveryPointId] <String>
[[-KeyFileDownloadLocation] <String>]
[-UseSecondaryRegion]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Get-AzRecoveryServicesBackupRecoveryPoint cmdlet은 백업된 Azure Backup 항목의 복구 지점을 가져옵니다. 항목이 백업 되면 AzureRmRecoveryServicesBackupRecoveryPoint 개체에 하나 이상의 복구 지점이 있습니다. -VaultId 매개 변수를 사용하여 자격 증명 모음 컨텍스트를 설정합니다.
예제
예제 1: 항목에 대한 지난 주의 복구 지점 가져오기
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7)
$endDate = Get-Date
$container = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVM -FriendlyName "V2VM" -VaultId $vault.ID
$backupItem = Get-AzRecoveryServicesBackupItem -Container $container -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -Item $backupItem -StartDate $startdate.ToUniversalTime() -EndDate $enddate.ToUniversalTime() -VaultId $vault.ID첫 번째 명령은 vaultName을 기반으로 자격 증명 모음 개체를 가져옵니다. 두 번째 명령은 7일 전의 날짜를 가져오고 $startDate 변수에 저장합니다. 세 번째 명령은 오늘 날짜를 가져오고 $endDate 변수에 저장합니다. 네 번째 명령은 AzureVM 백업 컨테이너를 가져오고 $Container 변수에 저장합니다. 다섯 번째 명령은 workloadType, vaultId를 기반으로 백업 항목을 가져오고 $backupItem 변수에 저장합니다. 마지막 명령은 $BackupItem 항목에 대한 복구 지점 배열을 가져오고 $rp 변수에 저장합니다.
예제 2: VaultArchive로 이동할 준비가 된 복구 지점 가져오기
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-IsReadyForMove $true -TargetTier VaultArchive첫 번째 명령은 vaultName을 기반으로 자격 증명 모음 개체를 가져옵니다. 두 번째 명령은 7일 전의 날짜를 가져오고 $startDate 변수에 저장합니다. 세 번째 명령은 오늘 날짜를 가져오고 $endDate 변수에 저장합니다. 네 번째 명령은 backupManagementType 및 workloadType, vaultId를 기반으로 백업 항목을 가져오고 $item 변수에 저장합니다. 마지막 명령은 $backupItem 항목에 대한 복구 지점 배열을 가져오며, 이 배열은 VaultArchive 계층으로 이동한 다음 $rp 변수에 저장됩니다.
예제 3: 특정 계층에서 복구 지점 가져오기
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-7).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate $startDate -EndDate $endDate -VaultId $vault.ID -Item $item[3] `
-Tier VaultStandard첫 번째 명령은 vaultName을 기반으로 자격 증명 모음 개체를 가져옵니다. 두 번째 명령은 7일 전의 날짜를 가져오고 $startDate 변수에 저장합니다. 세 번째 명령은 오늘 날짜를 가져오고 $endDate 변수에 저장합니다. 네 번째 명령은 backupManagementType 및 workloadType, vaultId를 기반으로 백업 항목을 가져오고 $item 변수에 저장합니다. 마지막 명령은 $backupItem 항목에 대한 복구 지점 배열을 가져오며, 이 배열은 VaultArchive 계층으로 이동한 다음 $rp 변수에 저장됩니다.
예제 4: 정책 opertaion 수정 후 작년에 정리된 복구 지점 가져오기
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$startDate = (Get-Date).AddDays(-365).ToUniversalTime()
$endDate = (Get-Date).ToUniversalTime()
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -VaultId $vault.ID
$rpsBefore = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID
# update policy
$pol = Get-AzRecoveryServicesBackupProtectionPolicy -VaultId $vault.ID -Name "policyName"
$pol.RetentionPolicy.IsWeeklyScheduleEnabled = $false
$pol.RetentionPolicy.IsMonthlyScheduleEnabled = $false
$pol.RetentionPolicy.IsYearlyScheduleEnabled = $false
Set-AzRecoveryServicesBackupProtectionPolicy -Policy $pol -VaultId $vault.ID -RetentionPolicy $pol.RetentionPolicy -Debug
# wait until policy changes are applied to recovery points and they are pruned
$rpsAfter = Get-AzRecoveryServicesBackupRecoveryPoint -Item $item[0] -StartDate $startDate -EndDate $endDate -VaultId $vault.ID
# compare the recovery points list before and after
$diff = Compare-Object $rpsBefore $rpsAfter
$rpsRemoved = $diff | Where-Object{ $_.SideIndicator -eq'<='} | Select-Object -ExpandProperty InputObject
$rpsRemoved
RecoveryPointId RecoveryPointType RecoveryPointTime ContainerName ContainerType
--------------- ----------------- ----------------- ------------- -------------
7397781054902 CrashConsistent 5/2/2023 3:28:35 AM iaasvmcontainerv2;test-rg;test-vm AzureVM
9722704411921 CrashConsistent 4/1/2023 3:32:26 AM iaasvmcontainerv2;test-rg;test-vm AzureVM
6543100104464 CrashConsistent 3/1/2023 3:26:27 AM iaasvmcontainerv2;test-rg;test-vm AzureVM첫 번째 명령은 vaultName을 기반으로 자격 증명 모음 개체를 가져옵니다. 두 번째 명령은 1년 전의 날짜를 가져오고 $startDate 변수에 저장합니다. 세 번째 명령은 오늘 날짜를 가져오고 $endDate 변수에 저장합니다. 네 번째 명령은 backupManagementType 및 workloadType, vaultId를 기반으로 백업 항목을 가져오고 $item 변수에 저장합니다. 다섯 번째 명령은 지난 1년 동안 정책 수정 작업 전에 있는 $item 항목에 대한 복구 지점 배열을 가져옵니다. 이제 정책을 업데이트합니다. 여섯 번째 명령은 백업 항목 $item[0]을 보호하는 데 사용되는 업데이트할 정책을 가져옵니다. 일곱 번째, 여덟 번째 및 아홉 번째 명령은 정책에서 연간 및 월별 보존을 사용하지 않도록 설정하여 이전 복구 지점을 정리합니다. 10번째 명령은 마지막으로 보존 정책을 업데이트합니다. 11번째 명령은 정책 변경이 적용된 후 복구 지점이 정리되고 동일한 시간 범위 내에서 복구 지점을 가져올 때까지 동일한 PowerShell 세션에서 대기합니다. 12번째 명령은 정리가 발생하기 전과 후에 복구 지점 목록 간에 차이입니다. 13번째 명령은 이전에 있었고 이제 정리된 diff에서 복구 지점을 읽습니다. 마지막 명령은 정리된 복구 지점 목록을 표시합니다.
매개 변수
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EndDate
날짜 범위의 끝을 지정합니다.
| 형식: | Nullable<T>[DateTime] |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IsReadyForMove
RP가 대상 계층으로 이동할 준비가 되었는지 여부에 따라 복구 지점을 필터링합니다. 대상 계층 매개 변수와 함께 사용합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Item
이 cmdlet이 복구 지점을 가져오는 항목을 지정합니다. AzureRmRecoveryServicesBackupItem 개체를 가져오려면 Get-AzRecoveryServicesBackupItem cmdlet을 사용합니다.
| 형식: | ItemBase |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-KeyFileDownloadLocation
암호화된 가상 머신에 대한 KeyVault 키를 복원하기 위해 입력 파일을 다운로드할 위치를 지정합니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RecoveryPointId
복구 지점 ID를 지정합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StartDate
날짜 범위의 시작을 지정합니다.
| 형식: | Nullable<T>[DateTime] |
| Position: | 0 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TargetTier
복구 지점의 이동 준비 상태를 확인하는 대상 계층입니다. 현재 유효한 값만 'VaultArchive'입니다.
| 형식: | RecoveryPointTier |
| 허용되는 값: | VaultArchive |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tier
계층 값을 기준으로 복구 지점을 필터링합니다.
| 형식: | RecoveryPointTier |
| 허용되는 값: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseSecondaryRegion
지역 간 복원을 위한 보조 지역의 필터
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-VaultId
Recovery Services 자격 증명 모음의 ARM ID입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |