Initialize-AzDataProtectionRestoreRequest

Ссылка

Модуль:: Az.DataProtection

Инициализирует объект запроса восстановления для активации восстановления в защищенном экземпляре резервной копии.

Синтаксис

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          -TargetResourceId <String>
          [-RecoveryPoint <String>]
          [-PointInTime <DateTime>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          -TargetResourceId <String>
          [-RecoveryPoint <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-ItemLevelRecovery]
          [-ContainersList <String[]>]
          [-PrefixMatch <Hashtable>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-RecoveryPoint <String>]
          [-PointInTime <DateTime>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          -BackupInstance <BackupInstanceResource>
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-RecoveryPoint <String>]
          [-PointInTime <DateTime>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-RestoreConfiguration <KubernetesClusterRestoreCriteria>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          [-ItemLevelRecovery]
          [-ContainersList <String[]>]
          -BackupInstance <BackupInstanceResource>
          [-FromPrefixPattern <String[]>]
          [-ToPrefixPattern <String[]>]
          [<CommonParameters>]

Initialize-AzDataProtectionRestoreRequest
          -DatasourceType <DatasourceTypes>
          -SourceDataStore <DataStoreType>
          -RestoreLocation <String>
          -RestoreType <RestoreTargetType>
          [-RecoveryPoint <String>]
          [-RehydrationDuration <String>]
          [-RehydrationPriority <String>]
          [-SecretStoreURI <String>]
          [-SecretStoreType <SecretStoreTypes>]
          -TargetContainerURI <String>
          [-TargetResourceIdForRestoreAsFile <String>]
          [-FileNamePrefix <String>]
          [<CommonParameters>]

Описание

Примеры

Пример 1. Получение объекта запроса на восстановление для экземпляра резервного копирования защищенных дисков Azure

$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "sarath-rg" -VaultName "sarath-vault"
$rp = Get-AzDataProtectionRecoveryPoint -SubscriptionId "xxx-xxx-xxx" -ResourceGroupName "sarath-rg" -VaultName "sarath-vault" -BackupInstanceName $instance.Name
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDisk -SourceDataStore OperationalStore -RestoreLocation "westus"  -RestoreType AlternateLocation -TargetResourceId "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/disks/{DiskName}" -RecoveryPoint "892e5c5014dc4a96807d22924f5745c9"

ObjectType                                  RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointI
                                                                                                                                                             d
----------                                  --------------------------- ------------------------------- -------------------------------- ------------------- --------------
AzureBackupRecoveryPointBasedRestoreRequest RestoreTargetInfo           FailIfExists                    westus                           OperationalStore    892e5c5014dc4a96807d22924f5745c9

Эта команда инициализировала объект запроса восстановления, который можно использовать для запуска восстановления.

Пример 2. Получение объекта запроса восстановления для защищенного экземпляра резервного копирования BLOB-объектов Azure

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instance[0] -PointInTime (Get-Date -Date $pointInTimeRange.RestorableTimeRange.EndTime)

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest restoreTargetInfo           FailIfExists                    eastus2euap                      OperationalStore    2021-04-24T13:32:41.7018481Z

Эта команда инициализировала объект запроса восстановления, который можно использовать для активации восстановления больших двоичных объектов.

Пример 3. Получение объекта запроса на восстановление на уровне элементов для контейнеров под защищенным экземпляром резервного копирования AzureBlob

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instances[0] -PointInTime (Get-Date).AddDays(-1) -ItemLevelRecovery -ContainersList "containerName1","containerName2"

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest itemLevelRestoreTargetInfo  FailIfExists                    eastus2euap                      OperationalStore    2021-04-23T02:47:02.9500000Z

Эта команда инициализировала объект запроса восстановления, который можно использовать для активации восстановления уровня элементов на уровне контейнера для BLOB-объектов.

Пример 4. Получение объекта запроса на восстановление на уровне элементов для контейнеров или префиксMatch в защищенном экземпляре резервного копирования AzureBlob

$startTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$endTime = (Get-Date).AddDays(0).ToString("yyyy-MM-ddTHH:mm:ss.0000000Z")
$instance = Get-AzDataProtectionBackupInstance -SubscriptionId "xxxx-xxx-xxx" -ResourceGroupName "rgName" -VaultName "vaultName"
$pointInTimeRange = Find-AzDataProtectionRestorableTimeRange -BackupInstanceName $instance[0].BackupInstanceName -ResourceGroupName "rgName" -SubscriptionId "subscriptionId"  -VaultName "vaultName" -SourceDataStoreType OperationalStore -StartTime $startTime -EndTime $endTime
Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureBlob -SourceDataStore OperationalStore -RestoreLocation $vault.Location -RestoreType OriginalLocation -BackupInstance $instances[0] -PointInTime (Get-Date).AddDays(-1) -ItemLevelRecovery -FromPrefixPattern "container1/aaa","container1/ccc", "container2/aab", "container3" -ToPrefixPattern "container1/bbb","container1/ddd", "container2/abc", "container3-0"

ObjectType                                 RestoreTargetInfoObjectType RestoreTargetInfoRecoveryOption RestoreTargetInfoRestoreLocation SourceDataStoreType RecoveryPointTime
----------                                 --------------------------- ------------------------------- -------------------------------- ------------------- -----------------
AzureBackupRecoveryTimeBasedRestoreRequest itemLevelRestoreTargetInfo  FailIfExists                    eastus2euap                      OperationalStore    2021-04-23T02:47:02.9500000Z

Эта команда инициализировала объект запроса восстановления, который можно использовать для активации восстановления уровня элементов на уровне больших двоичных объектов на основе префиксов имен в контейнерах BLOB-объектов.

Приведенное выше восстановлениеRequest восстанавливает следующие контейнеры и большие двоичные объекты:

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (восстанавливает все большие двоичные объекты, соответствующие этому диапазону префикса) "container1/ccc" "container1/dddd" "container2/aab" "container2/abc" "container3" "container3-0" (восстанавливает весь контейнер3)

Примечание. Диапазоны не должны перекрываться друг с другом. Ссылка: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

Пример 5. Получение объекта запроса на восстановление между регионами для восстановления в качестве базы данных для типа источника данных AzureDatabaseForPostgreSQL

$vault = Search-AzDataProtectionBackupVaultInAzGraph -ResourceGroup $ResourceGroupName -Subscription $SubscriptionId -Vault $VaultName
$instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription $subscriptionId  -ResourceGroup  $resourceGroupName  -Vault $vaultName -DatasourceType AzureDatabaseForPostgreSQL
$recoveryPointsCrr = Get-AzDataProtectionRecoveryPoint -BackupInstanceName $instance.Name -ResourceGroupName $resourceGroupName -VaultName $vaultName -SubscriptionId $subscriptionId -UseSecondaryRegion
$targetResourceId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/{targetResourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{targetServerName}/databases/{targetDatabaseName}"
$secretURI = "https://{crr-key-vault}.vault.azure.net/secrets/{secret-for-crr}"
$OssRestoreReq = Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDatabaseForPostgreSQL -SourceDataStore VaultStore -RestoreLocation $vault.ReplicatedRegion[0] -RestoreType AlternateLocation -RecoveryPoint $recoveryPointsCrr[0].Property.RecoveryPointId -TargetResourceId $targetResourceId -SecretStoreURI $secretURI -SecretStoreType AzureKeyVault

ObjectType                                  SourceDataStoreType SourceResourceId RecoveryPointId
----------                                  ------------------- ---------------- ---------------
AzureBackupRecoveryPointBasedRestoreRequest VaultStore                           d49aeb83264456ccab92a105cade9afe

Первая и вторая команды извлекает экземпляр хранилища и резервного копирования из графа ресурсов Azure. Третья команда используется для получения точек восстановления из дополнительного региона для восстановления между регионами. Последняя команда создает объект запроса на восстановление между регионами для восстановления в альтернативное расположение в качестве базы данных для источника данных AzureDatabaseForPostgreSQL. Обратите внимание, что для параметра RestoreLocation задано значение $vault. РепликацияRegion[0] (парный регион) вместо $vault. Расположение для нормального восстановления. Используйте команды Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore для проверки и активации восстановления.

Пример 6. Получение объекта запроса на восстановление между регионами для восстановления в качестве базы данных для типа источника данных AzureDatabaseForPostgreSQL

$vault = Search-AzDataProtectionBackupVaultInAzGraph -ResourceGroup $ResourceGroupName -Subscription $SubscriptionId -Vault $VaultName
$instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription $subscriptionId  -ResourceGroup  $resourceGroupName  -Vault $vaultName -DatasourceType AzureDatabaseForPostgreSQL
$recoveryPointsCrr = Get-AzDataProtectionRecoveryPoint -BackupInstanceName $instance.Name -ResourceGroupName $resourceGroupName -VaultName $vaultName -SubscriptionId $subscriptionId -UseSecondaryRegion
$targetContainerURI = "https://{targetStorageAccountName}.blob.core.windows.net/{targetContainerName}"
$fileNamePrefix = "oss-pstest-crrasfiles"
$OssRestoreReq = Initialize-AzDataProtectionRestoreRequest -DatasourceType AzureDatabaseForPostgreSQL -SourceDataStore VaultStore -RestoreLocation $vault.ReplicatedRegion[0] -RestoreType RestoreAsFiles -RecoveryPoint $recoveryPointsCrr[0].Property.RecoveryPointId -TargetContainerURI $targetContainerURI -FileNamePrefix $fileNamePrefix

ObjectType                                  SourceDataStoreType SourceResourceId RecoveryPointId
----------                                  ------------------- ---------------- ---------------
AzureBackupRecoveryPointBasedRestoreRequest VaultStore                           d49aeb83264456ccab92a105cade9afe

Первая и вторая команды извлекает экземпляр хранилища и резервного копирования из графа ресурсов Azure. Третья команда используется для получения точек восстановления из дополнительного региона для восстановления между регионами. Последняя команда создает объект запроса на восстановление между регионами для восстановления в виде файлов для источника данных AzureDatabaseForPostgreSQL. Обратите внимание, что для параметра RestoreLocation задано значение $vault. РепликацияRegion[0] (парный регион) вместо $vault. Расположение для нормального восстановления. Используйте команды Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore для проверки и активации восстановления.

Параметры

-BackupInstance

Объект экземпляра резервного копирования для активации исходного восстановления локализации. Сведения о создании см. в разделе NOTES для свойств BACKUPINSTANCE и создании хэш-таблицы.

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

-ContainersList

Имена контейнеров для восстановления уровня элементов.

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

-DatasourceType

Тип источника данных

Тип:	DatasourceTypes
Допустимые значения:	AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService, AzureDatabaseForPGFlexServer, AzureDatabaseForMySQL
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FileNamePrefix

Имя файла для префикса восстановленных данных резервного копирования.

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

-FromPrefixPattern

Укажите диапазон запуска восстановления BLOB-объектов для PITR. Этот параметр можно использовать для указания начального диапазона для подмножества больших двоичных объектов в каждом контейнере для восстановления. используйте косую черту (/) для разделения имени контейнера из шаблона префикса БОЛЬШОго двоичного объекта.

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

-ItemLevelRecovery

Параметр переключения для включения восстановления уровня элементов.

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

-PointInTime

Время восстановления.

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

-PrefixMatch

Используйте этот параметр для фильтрации блочных BLOB-объектов по префиксу в контейнере для альтернативного расположения ILR. При указании префикса будут восстановлены только большие двоичные объекты, соответствующие префиксу в контейнере. Входные данные для этого параметра — это хэш-файл, в котором каждый ключ является именем контейнера, и каждое значение представляет собой массив строковых префиксов для этого контейнера.

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

-RecoveryPoint

Идентификатор точки восстановления, необходимой для восстановления.

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

-RehydrationDuration

Длительность восстановления для архивной точки восстановления, чтобы оставаться восстановленной, значение по умолчанию для длительности восстановления равно 15.

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

-RehydrationPriority

Приоритет восстановления для архивной точки восстановления. Этот параметр является обязательным для восстановления архивированных точек.

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

-RestoreConfiguration

Конфигурация восстановления для восстановления. Используйте этот параметр для восстановления с помощью AzureKubernetesService. Сведения о создании см. в разделе NOTES для свойств RESTORECONFIGURATION и создания хэш-таблицы.

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

-RestoreLocation

Расположение целевого восстановления

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

-RestoreType

Тип целевого объекта restore

Тип:	RestoreTargetType
Допустимые значения:	AlternateLocation, OriginalLocation, RestoreAsFiles
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SecretStoreType

Тип секретного хранилища для проверки подлинности источника данных. Этот параметр поддерживается только для AzureDatabaseForPostgreSQL в настоящее время.

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

-SecretStoreURI

URI секрета для проверки подлинности хранилища секретов источника данных. Этот параметр поддерживается только для AzureDatabaseForPostgreSQL в настоящее время.

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

-SourceDataStore

Тип хранилища данных точки восстановления

Тип:	DataStoreType
Допустимые значения:	ArchiveStore, OperationalStore, VaultStore
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TargetContainerURI

Идентификатор контейнера учетной записи хранения, в который будут восстановлены данные резервного копирования в виде файлов.

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

-TargetResourceId

Укажите идентификатор целевого ресурса для восстановления данных резервного копирования в альтернативном расположении. Например, укажите идентификатор ARM целевой базы данных, в который требуется восстановить, для рабочей нагрузкиType AzureDatabaseForPostgreSQL.

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

-TargetResourceIdForRestoreAsFile

Идентификатор ARM контейнера целевой учетной записи хранения, в который будут восстановлены данные резервной копии в виде файлов. Этот параметр необходим для восстановления в виде файлов при отключении восстановления между подписками в хранилище резервных копий.

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

-ToPrefixPattern

Укажите конечный диапазон восстановления BLOB-объектов для PITR. Этот параметр можно использовать для указания конечного диапазона для подмножества больших двоичных объектов в каждом контейнере для восстановления. используйте косую черту (/) для разделения имени контейнера из шаблона префикса БОЛЬШОго двоичного объекта.

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

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

IAzureBackupRestoreRequest

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