Поделиться через

Get-AzRecoveryServicesBackupRecoveryPoint

  • Ссылка
Модуль:
Az.RecoveryServices

Возвращает точки восстановления для резервного копирования элемента.

Синтаксис

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 получает точки восстановления для резервного копирования элемента 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. Вторая команда получает дату с семи дней назад, а затем сохраняет ее в переменной $startDate. Третья команда получает текущую дату, а затем сохраняет ее в переменной $endDate. Четвертая команда получает контейнеры резервного копирования AzureVM и сохраняет их в переменной $Container. Пятая команда получает элемент резервного копирования на основе рабочей нагрузкиType, 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. Получение отрезаемых точек восстановления в прошлом году после изменения политики 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. Вторая команда получает дату с одного года назад, а затем сохраняет ее в переменной $startDate. Третья команда получает текущую дату, а затем сохраняет ее в переменной $endDate. Четвертая команда получает элементы резервного копирования на основе backupManagementType и workloadType, vaultId, а затем сохраняет его в переменной $item. Пятая команда получает массив точек восстановления для элемента в $item которые присутствуют перед операцией изменения политики в прошлом году. Теперь мы перейдем к обновлению политики. Шестая команда получает политику для обновления, которая используется для защиты элемента резервного копирования $item[0]. Седьмой, восемь и девятый команды отключают ежегодное и ежемесячное хранение в политике, чтобы обрезать старые точки восстановления. Десятая команда, наконец, обновляет политику хранения. Одиннадцатая команда ожидает в том же сеансе PowerShell, пока точки восстановления не будут обрезаны и извлекаются точки восстановления в течение одного и того же диапазона времени после применения изменений политики. Команда twelth принимает различение между списком точек восстановления до и после запуска. Тринадцатая команда считывает точки восстановления из диффа, которые присутствовали раньше и теперь обрезаны. Последняя команда отображает список обрезаемых точек восстановления.

Параметры

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases: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

Указывает элемент, для которого этот командлет получает точки восстановления. Чтобы получить объект AzureRmRecoveryServicesBackupItem, используйте командлет Get-AzRecoveryServicesBackupItem.

Тип:ItemBase
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-KeyFileDownloadLocation

Указывает расположение для скачивания входного файла для восстановления ключа KeyVault для зашифрованной виртуальной машины.

Тип:String
Position:2
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RecoveryPointId

Указывает идентификатор точки восстановления.

Тип: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

Идентификатор ARM хранилища служб восстановления.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

ItemBase

String

Выходные данные

RecoveryPointBase