Initialize-AzDataProtectionRestoreRequest

Referencia

Módulo:: Az.DataProtection

Inicializa el objeto Restore Request para desencadenar la restauración en una instancia de copia de seguridad protegida.

Syntax

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

Description

Inicializa el objeto Restore Request para desencadenar la restauración en una instancia de copia de seguridad protegida.

Ejemplos

Ejemplo 1: Obtención del objeto de solicitud de restauración para la instancia protegida de Azure Disk Backup

$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

Este comando inicializó un objeto de solicitud de restauración que se puede usar para desencadenar la restauración.

Ejemplo 2: Obtención del objeto de solicitud de restauración para la instancia protegida de Azure Blob Backup

$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

Este comando inicializó un objeto de solicitud de restauración que se puede usar para desencadenar la restauración de blobs.

Ejemplo 3: Obtención del objeto de solicitud de restauración para la recuperación de nivel de elemento para contenedores en la instancia protegida de AzureBlob Backup

$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

Este comando inicializó un objeto de solicitud de restauración que se puede usar para desencadenar la recuperación de nivel de elemento en el nivel de contenedor para blobs.

Ejemplo 4: Obtención del objeto de solicitud de restauración para la recuperación de nivel de elemento para contenedores o prefijoMatch en la instancia protegida de AzureBlob Backup

$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

Este comando inicializó un objeto de solicitud de restauración que se puede usar para desencadenar la recuperación de nivel de elemento en el nivel de blobs en función de los prefijos de nombre en contenedores de blobs.

La restauración anteriorRequest restaura los siguientes contenedores o blobs:

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (restaura todos los blobs coincidentes en este intervalo de prefijos) "container1/ccc" "container1/ddd" "container2/aab" "container2/abc" "container3" "container3-0" (restaura todo el contenedor3)

Nota: Los intervalos no deben superponerse entre sí. Referencia: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

Ejemplo 5: Obtención del objeto de solicitud de restauración entre regiones para la restauración como base de datos para el tipo de origen de datos 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

Los comandos primero y segundo capturan el almacén y la instancia de copia de seguridad de Azure Resource Graph. El tercer comando se usa para capturar puntos de recuperación de la región secundaria para la restauración entre regiones. El último comando construye el objeto de solicitud de restauración entre regiones para restaurar en una ubicación alternativa como base de datos para el tipo de origen de datos AzureDatabaseForPostgreSQL. Tenga en cuenta que establecemos el parámetro RestoreLocation en $vault. ReplicatedRegion[0] (región emparejada) en lugar de $vault. Ubicación de la restauración normal. Use los comandos Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore para validar y desencadenar la restauración.

Ejemplo 6: Obtención del objeto de solicitud de restauración entre regiones para la restauración como base de datos para el tipo de origen de datos 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

Los comandos primero y segundo capturan el almacén y la instancia de copia de seguridad de Azure Resource Graph. El tercer comando se usa para capturar puntos de recuperación de la región secundaria para la restauración entre regiones. El último comando construye el objeto de solicitud de restauración entre regiones para la restauración como archivos para datasourcetype AzureDatabaseForPostgreSQL. Tenga en cuenta que establecemos el parámetro RestoreLocation en $vault. ReplicatedRegion[0] (región emparejada) en lugar de $vault. Ubicación de la restauración normal. Use los comandos Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore para validar y desencadenar la restauración.

Parámetros

-BackupInstance

Objeto de instancia de copia de seguridad para desencadenar la restauración de la configuración local original. Para construir, consulte la sección NOTES de las propiedades BACKUPINSTANCE y cree una tabla hash.

Tipo:	BackupInstanceResource
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ContainersList

Nombres de contenedor para Item Level Recovery.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatasourceType

Tipo de origen de datos

Tipo:	DatasourceTypes
valores aceptados:	AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService, AzureDatabaseForPGFlexServer, AzureDatabaseForMySQL
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-FileNamePrefix

Nombre de archivo que se va a prefijar a los datos de copia de seguridad restaurados.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FromPrefixPattern

Especifique el intervalo de inicio de restauración de blobs para PITR. Puede usar esta opción para especificar el intervalo inicial de un subconjunto de blobs en cada contenedor que se va a restaurar. use una barra diagonal (/) para separar el nombre del contenedor del patrón de prefijo de blob.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ItemLevelRecovery

Cambie el parámetro para habilitar la recuperación de nivel de elemento.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PointInTime

Momento dado para la restauración.

Tipo:	DateTime
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrefixMatch

Use este parámetro para filtrar blobs en bloques por prefijo en un contenedor para ilR de ubicación alternativa. Al especificar un prefijo, solo se restaurarán los blobs que coincidan con ese prefijo en el contenedor. La entrada de este parámetro es una tabla hash donde cada clave es un nombre de contenedor y cada valor es una matriz de prefijos de cadena para ese contenedor.

Tipo:	Hashtable
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecoveryPoint

Identificador del punto de recuperación que se va a restaurar.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RehydrationDuration

La duración de la rehidratación del punto de recuperación archivado para mantenerse rehidratado, el valor predeterminado para la duración de la rehidratación es 15.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RehydrationPriority

Prioridad de rehidratación para el punto de recuperación archivado. Este parámetro es obligatorio para la restauración rehidratación de puntos archivados.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreConfiguration

Restauración de la configuración para la restauración. Use este parámetro para restaurar con AzureKubernetesService. Para construir, consulte la sección NOTES de las propiedades RESTORECONFIGURATION y cree una tabla hash.

Tipo:	KubernetesClusterRestoreCriteria
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreLocation

Ubicación de restauración de destino

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreType

Tipo de destino de restauración

Tipo:	RestoreTargetType
valores aceptados:	AlternateLocation, OriginalLocation, RestoreAsFiles
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretStoreType

Tipo de almacén secreto para la autenticación del almacén secreto del origen de datos. Este parámetro solo se admite para AzureDatabaseForPostgreSQL actualmente.

Tipo:	SecretStoreTypes
valores aceptados:	AzureKeyVault
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecretStoreURI

URI secreto para la autenticación del almacén secreto del origen de datos. Este parámetro solo se admite para AzureDatabaseForPostgreSQL actualmente.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SourceDataStore

Tipo de almacén de datos del punto de recuperación

Tipo:	DataStoreType
valores aceptados:	ArchiveStore, OperationalStore, VaultStore
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetContainerURI

Id. de contenedor de la cuenta de almacenamiento de destino al que se restaurarán los datos de copia de seguridad como archivos.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetResourceId

Especifique el identificador de recurso de destino para restaurar los datos de copia de seguridad en una ubicación alternativa. Por ejemplo, proporcione el identificador de ARM de la base de datos de destino al que desea restaurar, para workloadType AzureDatabaseForPostgreSQL.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TargetResourceIdForRestoreAsFile

Id. de ARM del contenedor de la cuenta de almacenamiento de destino al que se restaurarán los datos de copia de seguridad como archivos. Este parámetro es necesario para restaurar como archivos cuando la restauración entre suscripciones está deshabilitada en el almacén de copia de seguridad.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ToPrefixPattern

Especifique el intervalo final de restauración de blobs para PITR. Puede usar esta opción para especificar el intervalo final de un subconjunto de blobs en cada contenedor que se va a restaurar. use una barra diagonal (/) para separar el nombre del contenedor del patrón de prefijo de blob.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Salidas

IAzureBackupRestoreRequest

Compartir a través de