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

Описание

Командлет 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. Получение отрезаемых точек восстановления в прошлом году после изменения операции политики

$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, пока точки восстановления не будут обрезаны и извлекаются точки восстановления в течение одного и того же диапазона времени после применения изменений политики. Двенадцатая команда принимает разность между списком точек восстановления до и после выполнения обрезки. Тринадцатая команда считывает точки восстановления из диффа, которые присутствовали раньше и теперь обрезаны. Последняя команда отображает список обрезаемых точек восстановления.

Параметры

-DefaultProfile

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

Свойства параметров

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-EndDate

Указывает конец диапазона дат.

Свойства параметров

Тип:

Nullable<T>[DateTime]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DateTimeFilter
Position:1
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IsReadyForMove

Фильтрует точки восстановления на основе готовности RP к переходу на целевой уровень. Используйте это вместе с параметром целевого уровня.

Свойства параметров

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NoFilterParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
DateTimeFilter
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Item

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

Свойства параметров

Тип:ItemBase
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:2
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-KeyFileDownloadLocation

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RecoveryPointId
Position:2
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RecoveryPointId

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RecoveryPointId
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StartDate

Указывает начало диапазона дат.

Свойства параметров

Тип:

Nullable<T>[DateTime]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

DateTimeFilter
Position:0
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TargetTier

Целевой уровень для проверки готовности к перемещению точки восстановления. В настоящее время допустимым значением является "VaultArchive".

Свойства параметров

Тип:RecoveryPointTier
Default value:None
Допустимые значения:VaultArchive
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NoFilterParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
DateTimeFilter
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tier

Фильтрация точек восстановления на основе значения уровня.

Свойства параметров

Тип:RecoveryPointTier
Default value:None
Допустимые значения:VaultStandard, Snapshot, VaultArchive, VaultStandardRehydrated, SnapshotAndVaultStandard, SnapshotAndVaultArchive
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

NoFilterParameterSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
DateTimeFilter
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UseSecondaryRegion

Фильтры из дополнительного региона для восстановления между регионами

Свойства параметров

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VaultId

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

Свойства параметров

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

ItemBase

String

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

RecoveryPointBase