Bagikan melalui


Get-AzRecoveryServicesBackupRecoveryPoint

Mendapatkan titik pemulihan untuk item yang dicadangkan.

Sintaks

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>]

Deskripsi

Cmdlet Get-AzRecoveryServicesBackupRecoveryPoint mendapatkan titik pemulihan untuk item Azure Backup yang dicadangkan. Setelah item dicadangkan, objek AzureRmRecoveryServicesBackupRecoveryPoint memiliki satu atau beberapa titik pemulihan. Atur konteks vault dengan menggunakan parameter -VaultId.

Contoh

Contoh 1: Dapatkan titik pemulihan dari minggu lalu untuk item

$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

Perintah pertama mendapatkan objek vault berdasarkan vaultName. Perintah kedua mendapatkan tanggal dari tujuh hari yang lalu, lalu menyimpannya dalam variabel $startDate. Perintah ketiga mendapatkan tanggal hari ini, lalu menyimpannya dalam variabel $endDate. Perintah keempat mendapatkan kontainer cadangan AzureVM, dan menyimpannya dalam variabel $Container. Perintah kelima mendapatkan item cadangan berdasarkan workloadType, vaultId lalu menyimpannya dalam variabel $backupItem. Perintah terakhir mendapatkan array titik pemulihan untuk item di $BackupItem, lalu menyimpannya dalam variabel $rp.

Contoh 2: Dapatkan titik pemulihan yang siap dipindahkan ke 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

Perintah pertama mendapatkan objek vault berdasarkan vaultName. Perintah kedua mendapatkan tanggal dari tujuh hari yang lalu, lalu menyimpannya dalam variabel $startDate. Perintah ketiga mendapatkan tanggal hari ini, lalu menyimpannya dalam variabel $endDate. Perintah keempat mendapatkan item cadangan berdasarkan backupManagementType dan workloadType, vaultId lalu menyimpannya dalam variabel $item. Perintah terakhir mendapatkan array titik pemulihan untuk item di $backupItem yang siap dipindahkan ke tingkat VaultArchive lalu menyimpannya dalam variabel $rp.

Contoh 3: Mendapatkan titik pemulihan di tingkat tertentu

$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

Perintah pertama mendapatkan objek vault berdasarkan vaultName. Perintah kedua mendapatkan tanggal dari tujuh hari yang lalu, lalu menyimpannya dalam variabel $startDate. Perintah ketiga mendapatkan tanggal hari ini, lalu menyimpannya dalam variabel $endDate. Perintah keempat mendapatkan item cadangan berdasarkan backupManagementType dan workloadType, vaultId lalu menyimpannya dalam variabel $item. Perintah terakhir mendapatkan array titik pemulihan untuk item di $backupItem yang siap dipindahkan ke tingkat VaultArchive lalu menyimpannya dalam variabel $rp.

Contoh 4: Mendapatkan titik pemulihan yang diprajakan pada tahun lalu setelah mengubah opertaion kebijakan

$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

Perintah pertama mendapatkan objek vault berdasarkan vaultName. Perintah kedua mendapatkan tanggal dari satu tahun yang lalu, lalu menyimpannya dalam variabel $startDate. Perintah ketiga mendapatkan tanggal hari ini, lalu menyimpannya dalam variabel $endDate. Perintah keempat mendapatkan item cadangan berdasarkan backupManagementType dan workloadType, vaultId lalu menyimpannya dalam variabel $item. Perintah kelima mendapatkan array titik pemulihan untuk item dalam $item yang ada sebelum operasi kebijakan modifikasi dalam satu tahun terakhir. Sekarang kita lanjutkan untuk memperbarui kebijakan. Perintah keenam mengambil kebijakan yang akan diperbarui yang digunakan untuk melindungi item cadangan $item[0]. Perintah ketujuh, delapan, dan kesembilan menonaktifkan retensi tahunan dan bulanan dalam kebijakan untuk memangkas titik pemulihan yang lebih lama. Perintah kesepuluh akhirnya memperbarui kebijakan retensi. Perintah kesebelas menunggu dalam sesi powershell yang sama sampai titik pemulihan dipangkas dan mengambil titik pemulihan dalam rentang waktu yang sama, setelah perubahan kebijakan diterapkan. Perintah kedua belas berbeda antara daftar titik pemulihan sebelum dan sesudah pemangkasan terjadi. Perintah ketiga belas membaca titik pemulihan, dari diff, yang ada sebelumnya dan sekarang diprakarsai. Perintah terakhir menampilkan daftar titik pemulihan yang dipungut.

Parameter

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-EndDate

Menentukan akhir rentang tanggal.

Jenis:Nullable<T>[DateTime]
Position:1
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-IsReadyForMove

Memfilter Titik Pemulihan berdasarkan apakah RP Siap dipindahkan ke tingkat target. Gunakan ini bersama dengan parameter tingkat target.

Jenis:Boolean
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Item

Menentukan item tempat cmdlet ini mendapatkan titik pemulihan. Untuk mendapatkan objek AzureRmRecoveryServicesBackupItem , gunakan cmdlet Get-AzRecoveryServicesBackupItem .

Jenis:ItemBase
Position:2
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyFileDownloadLocation

Menentukan lokasi untuk mengunduh file input untuk memulihkan kunci KeyVault untuk komputer virtual terenkripsi.

Jenis:String
Position:2
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-RecoveryPointId

Menentukan ID titik pemulihan.

Jenis:String
Position:1
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-StartDate

Menentukan awal rentang tanggal.

Jenis:Nullable<T>[DateTime]
Position:0
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetTier

Tingkat target untuk memeriksa kesiapan pemindahan titik pemulihan. Saat ini hanya nilai yang valid adalah 'VaultArchive'.

Jenis:RecoveryPointTier
nilai yang diterima:VaultArchive
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Tier

Memfilter titik pemulihan berdasarkan nilai tingkat.

Jenis:RecoveryPointTier
nilai yang diterima:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSecondaryRegion

Filter dari Wilayah Sekunder untuk Pemulihan Lintas Wilayah

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

ID ARM dari Vault Layanan Pemulihan.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

Input

ItemBase

String

Output

RecoveryPointBase