Get-AzRecoveryServicesBackupRecoveryPoint
語法
NoFilterParameterSet (預設值)
Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
DateTimeFilter
Get-AzRecoveryServicesBackupRecoveryPoint
[[-StartDate] <DateTime>]
[[-EndDate] <DateTime>]
[-Item] <ItemBase>
[-UseSecondaryRegion]
[-Tier <RecoveryPointTier>]
[-IsReadyForMove <Boolean>]
[-TargetTier <RecoveryPointTier>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RecoveryPointId
Get-AzRecoveryServicesBackupRecoveryPoint
[-Item] <ItemBase>
[-RecoveryPointId] <String>
[[-KeyFileDownloadLocation] <String>]
[-UseSecondaryRegion]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Get-AzRecoveryServicesBackupRecoveryPoint Cmdlet 會取得備份 Azure 備份專案的復原點。
備份專案之後, AzureRmRecoveryServicesBackupRecoveryPoint 物件會有一或多個復原點。
使用 -VaultId 參數設定 Vault 前後關聯。
範例
範例 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 取得 vault 物件。
第二個命令會取得 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 取得 vault 物件。 第二個命令會取得 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 取得 vault 物件。 第二個命令會取得 7 天前的日期,然後將其儲存在 $startDate 變數中。
第三個命令取得今天的日期,然後將其儲存在$endDate變數中。
第四個命令會根據 backupManagementType 和 workloadType, vaultId 取得備份項目,然後將它儲存在 $item 變數中。
最後一個命令會取得$backupItem中項目的復原點陣列,這些復原點已準備好移至 VaultArchive 層,然後將它們儲存在 $rp 變數中。
範例 4:在修改原則作業之後,取得去年的修剪復原點
$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 取得 vault 物件。 第二個命令會取得一年前的日期,然後將其儲存在$startDate變數中。
第三個命令取得今天的日期,然後將其儲存在$endDate變數中。
第四個命令會根據 backupManagementType 和 workloadType, vaultId 取得備份項目,然後將它儲存在 $item 變數中。
第五個命令會取得專案的復原點陣列,這些復原點位於過去一年的修改原則作業之前$item。
現在我們繼續更新政策。 第六個命令提取要更新的策略,該策略用於保護備份項$item[0]。
第七個、第八個和第九個命令會停用原則中的年度和每月保留,以修剪較舊的復原點。
第十個命令最終更新保留策略。
第十一個命令會在相同的 powershell 會話中等候,直到修剪復原點,並在套用原則變更之後擷取相同時間範圍內的復原點。
第十二個命令在修剪發生之前和之後在復原點清單之間取得差異。
第十三個命令從差異讀取恢復點,這些恢復點以前存在,現在正在修剪。
最後一個命令會顯示已刪改復原點的清單。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-EndDate
指定日期範圍的結束時間。
參數屬性
參數集
DateTimeFilter
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
根據 RP 是否已準備好移至目標層來篩選復原點。 將此與目標層參數一起使用。
| 類型: | Boolean
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
NoFilterParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DateTimeFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Item
指定此 Cmdlet 取得復原點的專案。
若要取得 AzureRmRecoveryServicesBackupItem 物件,請使用 Get-AzRecoveryServicesBackupItem Cmdlet。
參數屬性
| 類型: | ItemBase
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-KeyFileDownloadLocation
指定下載輸入檔案的位置,以還原加密虛擬機器的 KeyVault 金鑰。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RecoveryPointId
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecoveryPointId
指定復原點識別碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
RecoveryPointId
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StartDate
指定日期範圍的開始。
參數屬性
參數集
DateTimeFilter
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetTier
目標層,以檢查復原點的移動整備程度。 目前只有有效的值是 'VaultArchive'。
參數屬性
參數集
NoFilterParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DateTimeFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Tier
根據層級值篩選復原點。
參數屬性
| 類型: | RecoveryPointTier
|
| 預設值: | None |
| 接受的值: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
NoFilterParameterSet
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
DateTimeFilter
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-UseSecondaryRegion
來自次要區域的篩選器,以進行跨區域還原
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-VaultId
復原服務保存庫的 ARM 識別碼。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出