共用方式為


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 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EndDate

指定日期範圍的結束時間。

參數屬性

類型:

Nullable<T>[DateTime]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

DateTimeFilter
Position:1
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IsReadyForMove

根據 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

指定日期範圍的開始。

參數屬性

類型:

Nullable<T>[DateTime]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

DateTimeFilter
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-TargetTier

目標層,以檢查復原點的移動整備程度。 目前只有有效的值是 'VaultArchive'。

參數屬性

類型:RecoveryPointTier
預設值:None
接受的值:VaultArchive
支援萬用字元:False
不要顯示:False

參數集

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

來自次要區域的篩選器,以進行跨區域還原

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(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

輸入

ItemBase

String

輸出

RecoveryPointBase