Initialize-AzDataProtectionRestoreRequest

Referencia

Modul:: Az.DataProtection

Inicializálja a visszaállítási kérelem objektumot, amely egy védett biztonsági mentési példányon indítja el a visszaállítást.

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

Inicializálja a visszaállítási kérelem objektumot, amely egy védett biztonsági mentési példányon indítja el a visszaállítást.

Példák

1. példa: Visszaállítási kérelem objektumának lekérése védett Azure Disk Backup-példányhoz

$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

Ez a parancs inicializált egy visszaállítási kérelem objektumot, amely a visszaállítás aktiválására használható.

2. példa: Visszaállítási kérelem objektumának lekérése védett Azure Blob Backup-példányhoz

$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

Ez a parancs inicializált egy visszaállítási kérelem objektumot, amely a blobok visszaállításának aktiválására használható.

3. példa: A védett AzureBlob Backup-példányban lévő tárolók elemszintű helyreállításához szükséges visszaállítási kérelem objektumának lekérése

$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

Ez a parancs inicializált egy visszaállítási kérelemobjektumot, amely a blobok tárolószint-szintű elemszintű helyreállításának aktiválására használható.

4. példa: A tárolók/prefixMatch elemszintű helyreállításhoz tartozó visszaállítási kérelemobjektum lekérése a védett AzureBlob Backup-példány alatt

$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

Ez a parancs inicializált egy visszaállítási kérelemobjektumot, amely a Blob-tárolókban lévő névelőtagok alapján az Elemszintű helyreállítás blobszinten történő aktiválására használható.

A fenti restoreRequest a következő tárolókat/blobokat állítja vissza:

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (az előtagtartományban egyeztetett összes blob visszaállítása) "container1/ccc" "container1/ddd" "container2/aab" "container2/abc" "container3" "container3-0" (a teljes tároló3 visszaállítása)

Megjegyzés: A tartományok nem lehetnek átfedésben egymással. Referencia: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

5. példa: Régióközi visszaállítási kérelemobjektum lekérése az AzureDatabaseForPostgreSQL típusú adatforrás adatbázisaként történő visszaállításhoz

$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

Az első és a második parancs lekéri a tárolót és a biztonsági mentési példányt az Azure Resource Graphból. A harmadik parancs a helyreállítási pontok lekérésére szolgál a másodlagos régióból a régiók közötti visszaállításhoz. Az utolsó parancs az AzureDatabaseForPostgreSQL adatforrástípus adatbázisaként állítja össze a régiók közötti visszaállítási kérelemobjektumot, hogy alternatív helyre állítsa vissza a visszaállítást. Vegye figyelembe, hogy a RestoreLocation paramétert $vault értékre állítottuk. Replikáltrégió[0] (párosított régió) $vault helyett. A normál visszaállítás helye. A visszaállítás ellenőrzéséhez és aktiválásához használja a Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore parancsokat.

6. példa: Régiók közötti visszaállítási kérelemobjektum lekérése az AzureDatabaseForPostgreSQL típusú adatforrás adatbázisaként történő visszaállításhoz

$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

Az első és a második parancs lekéri a tárolót és a biztonsági mentési példányt az Azure Resource Graphból. A harmadik parancs a helyreállítási pontok lekérésére szolgál a másodlagos régióból a régiók közötti visszaállításhoz. Az utolsó parancs az AzureDatabaseForPostgreSQL adatforrástípus fájljaiként hozza létre a visszaállítás régióközi visszaállítási kérésobjektumát. Vegye figyelembe, hogy a RestoreLocation paramétert $vault értékre állítottuk. Replikáltrégió[0] (párosított régió) $vault helyett. A normál visszaállítás helye. A visszaállítás ellenőrzéséhez és aktiválásához használja a Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore parancsokat.

Paraméterek

-BackupInstance

Biztonsági másolatpéldány-objektum az eredeti területi beállítások visszaállításának aktiválásához. A létrehozáshoz tekintse meg a BACKUPINSTANCE tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.

Típus:	BackupInstanceResource
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ContainersList

Az Elemszintű helyreállítás tárolónevei.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DatasourceType

Adatforrás típusa

Típus:	DatasourceTypes
Elfogadott értékek:	AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService, AzureDatabaseForPGFlexServer, AzureDatabaseForMySQL
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-FileNamePrefix

A visszaállított biztonsági mentési adatokhoz előtagként megadott fájlnév.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-FromPrefixPattern

Adja meg a PITR blob-visszaállítási kezdőtartományát. Ezzel a beállítással megadhatja az egyes tárolókban lévő blobok egy részhalmazának kezdőtartományát a visszaállításhoz. használjon perjelet (/) a tárolónév és a blobelőtag-minta elválasztásához.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ItemLevelRecovery

Váltson paraméterre az elemszintű helyreállítás engedélyezéséhez.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PointInTime

Időpont a visszaállításhoz.

Típus:	DateTime
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PrefixMatch

Ezzel a paraméterrel szűrheti a blokkblobokat előtag alapján egy tárolóban alternatív hely ILR-hez. Előtag megadásakor csak a tárolóban lévő előtaggal egyező blobok lesznek visszaállítva. Ennek a paraméternek a bemenete egy kivonatoló, amelyben minden kulcs egy tárolónév, és minden érték az adott tárolóhoz tartozó sztringelőtagok tömbje.

Típus:	Hashtable
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RecoveryPoint

A visszaállítandó helyreállítási pont azonosítója.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RehydrationDuration

Az archivált helyreállítási pont rehidratálási időtartama rehidratált marad, a rehidratálási időtartam alapértelmezett értéke 15.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RehydrationPriority

Archivált helyreállítási pont rehidratálási prioritása. Ez a paraméter kötelező az archivált pontok rehidratálásához.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RestoreConfiguration

Visszaállítási konfiguráció visszaállítása. Ezzel a paraméterrel állíthatja vissza az AzureKubernetesService szolgáltatást. A létrehozáshoz tekintse meg a RESTORECONFIGURATION tulajdonságok jegyzetei szakaszt, és hozzon létre egy kivonattáblát.

Típus:	KubernetesClusterRestoreCriteria
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RestoreLocation

Cél-visszaállítási hely

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RestoreType

Céltípus visszaállítása

Típus:	RestoreTargetType
Elfogadott értékek:	AlternateLocation, OriginalLocation, RestoreAsFiles
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SecretStoreType

Titkos tár típusa az adatforrás titkos tárának hitelesítéséhez. Ez a paraméter jelenleg csak az AzureDatabaseForPostgreSQL esetében támogatott.

Típus:	SecretStoreTypes
Elfogadott értékek:	AzureKeyVault
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SecretStoreURI

Titkos uri az adatforrás titkos tárbeli hitelesítéséhez. Ez a paraméter jelenleg csak az AzureDatabaseForPostgreSQL esetében támogatott.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SourceDataStore

A helyreállítási pont DataStore-típusa

Típus:	DataStoreType
Elfogadott értékek:	ArchiveStore, OperationalStore, VaultStore
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TargetContainerURI

Céltárfiók tárolóazonosítója, amelyre a biztonsági mentési adatok fájlokként lesznek visszaállítva.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TargetResourceId

Adja meg a célerőforrás-azonosítót a biztonsági mentési adatok másodlagos helyen való visszaállításához. Adja meg például a visszaállítani kívánt céladatbázis ARM-azonosítóját az AzureDatabaseForPostgreSQL számítási feladathoz.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-TargetResourceIdForRestoreAsFile

A céltárfiók arm-azonosítója, amelyre a biztonsági mentési adatok fájlokként lesznek visszaállítva. Ez a paraméter szükséges a fájlok visszaállításához, ha az előfizetések közötti visszaállítás le van tiltva a biztonsági mentési tárolóban.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ToPrefixPattern

Adja meg a PITR blob-visszaállítási végponttartományát. Ezzel a beállítással megadhatja az egyes tárolókban lévő blobok egy részhalmazának zárótartományát. használjon perjelet (/) a tárolónév és a blobelőtag-minta elválasztásához.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Kimenetek

IAzureBackupRestoreRequest

Megosztás a következőn keresztül: