你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
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>] 说明
Get-AzRecoveryServicesBackupRecoveryPoint cmdlet 获取备份的 Azure 备份项的恢复点。 备份项后，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 获取保管库对象。 第二个命令从七天前获取日期，然后将其存储在$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 获取保管库对象。 第二个命令从七天前获取日期，然后将其存储在$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 获取保管库对象。 第二个命令从七天前获取日期，然后将其存储在$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 获取保管库对象。 第二个命令从一年前获取日期，然后将其存储在$startDate变量中。 第三个命令获取今天的日期，然后将其存储在$endDate变量中。 第四个命令基于 backupManagementType 和 workloadType、vaultId 获取备份项，然后将其存储在$item变量中。 第五个命令获取$item项的恢复点数组，这些恢复点在去年的修改策略操作之前存在。 现在，我们继续更新策略。 第六个命令提取要更新的策略，该策略用于保护备份项$item[0]。 第七、八和第九个命令禁用策略中的每年和每月保留期，以修剪较旧的恢复点。 第十个命令最终更新保留策略。 第十一个命令在相同的 powershell 会话中等待，直到恢复点被修剪，并在应用策略更改后在同一时间范围内提取恢复点。 twelth 命令在删除之前和之后的恢复点列表之间采用差异。 第十三个命令从差异读取恢复点，该差异以前存在，现在被修剪。 最后一个命令显示已修剪恢复点的列表。
参数
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EndDate
指定日期范围的结束。
| 类型: | Nullable<T>[DateTime] |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-IsReadyForMove
根据 RP 是否准备好移动到目标层来筛选恢复点。 将此与目标层参数一起使用。
| 类型: | Boolean |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Item
指定此 cmdlet 获取恢复点的项。 若要获取 AzureRmRecoveryServicesBackupItem 对象，请使用 Get-AzRecoveryServicesBackupItem cmdlet。
| 类型: | ItemBase |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-KeyFileDownloadLocation
指定下载输入文件以还原加密虚拟机的 KeyVault 密钥的位置。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RecoveryPointId
指定恢复点 ID。
| 类型: | String |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-StartDate
指定日期范围的开始日期。
| 类型: | Nullable<T>[DateTime] |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-TargetTier
用于检查恢复点移动就绪情况的目标层。 目前只有有效值为“VaultArchive”。
| 类型: | RecoveryPointTier |
| 接受的值: | VaultArchive |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tier
根据层值筛选恢复点。
| 类型: | RecoveryPointTier |
| 接受的值: | VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UseSecondaryRegion
从次要区域筛选跨区域还原
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VaultId
恢复服务保管库的 ARM ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
