Udostępnij za pośrednictwem


Initialize-AzDataProtectionRestoreRequest

Inicjuje obiekt Żądania przywracania na potrzeby wyzwalania przywracania w chronionym wystąpieniu kopii zapasowej.

Składnia

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

Opis

Inicjuje obiekt Żądania przywracania na potrzeby wyzwalania przywracania w chronionym wystąpieniu kopii zapasowej.

Przykłady

Przykład 1. Uzyskiwanie obiektu żądania przywracania dla chronionego wystąpienia usługi 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

To polecenie zainicjowało obiekt żądania przywracania, który może służyć do wyzwalania przywracania.

Przykład 2. Pobieranie obiektu żądania przywracania dla chronionego wystąpienia usługi 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

To polecenie zainicjowało obiekt żądania przywracania, który może służyć do wyzwalania przywracania dla obiektów blob.

Przykład 3. Pobieranie obiektu żądania przywracania dla odzyskiwania na poziomie elementu dla kontenerów w ramach chronionego wystąpienia usługi 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

To polecenie zainicjowało obiekt żądania przywracania, który może służyć do wyzwalania odzyskiwania na poziomie elementu na poziomie kontenera dla obiektów blob.

Przykład 4. Pobieranie obiektu żądania przywracania dla odzyskiwania na poziomie elementu dla kontenerów/prefiksMatch w ramach chronionego wystąpienia usługi 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

To polecenie zainicjowało obiekt żądania przywracania, który może służyć do wyzwalania odzyskiwania na poziomie elementu na poziomie obiektów blob na podstawie prefiksów nazw w kontenerach obiektów blob.

Powyższe polecenie restoreRequest przywraca następujące kontenery/obiekty blob:

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (przywraca wszystkie obiekty blob dopasowane w tym zakresie prefiksów) "container1/ccc" "container1/ddd" "container2/aab" "container2/abc" "container3" "container3-0" (przywraca cały kontener3)

Uwaga: zakresy nie powinny pokrywać się ze sobą. Dokumentacja: https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

Przykład 5. Pobieranie obiektu żądania przywracania między regionami w celu przywrócenia jako bazy danych dla typu źródła danych 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

Pierwsze i drugie polecenia pobierają magazyn i wystąpienie kopii zapasowej z grafu zasobów platformy Azure. Trzecie polecenie służy do pobierania punktów odzyskiwania z regionu pomocniczego na potrzeby przywracania między regionami. Ostatnie polecenie konstruuje obiekt żądania przywracania między regionami w celu przywrócenia do alternatywnej lokalizacji jako bazy danych dla źródła danych AzureDatabaseForPostgreSQL. Należy pamiętać, że ustawiliśmy parametr RestoreLocation na $vault. Zreplikowanyregion[0] (sparowany region) zamiast $vault. Lokalizacja normalnego przywracania. Użyj poleceń Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore, aby zweryfikować i wyzwolić przywracanie.

Przykład 6: Uzyskiwanie obiektu żądania przywracania między regionami w celu przywrócenia jako bazy danych dla typu źródła danych 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

Pierwsze i drugie polecenia pobierają magazyn i wystąpienie kopii zapasowej z grafu zasobów platformy Azure. Trzecie polecenie służy do pobierania punktów odzyskiwania z regionu pomocniczego na potrzeby przywracania między regionami. Ostatnie polecenie konstruuje obiekt żądania przywracania między regionami w celu przywrócenia jako pliki dla źródła danych AzureDatabaseForPostgreSQL. Należy pamiętać, że ustawiliśmy parametr RestoreLocation na $vault. Zreplikowanyregion[0] (sparowany region) zamiast $vault. Lokalizacja normalnego przywracania. Użyj poleceń Test-AzDataProtectionBackupInstanceRestore, Start-AzDataProtectionBackupInstanceRestore, aby zweryfikować i wyzwolić przywracanie.

Parametry

-BackupInstance

Obiekt wystąpienia kopii zapasowej w celu wyzwolenia oryginalnego przywracania lokalizacji. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości KLASY BACKUPINSTANCE i utwórz tabelę skrótów.

Typ:BackupInstanceResource
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-ContainersList

Nazwy kontenerów dla odzyskiwania na poziomie elementu.

Typ:String[]
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-DatasourceType

Typ źródła danych

Typ:DatasourceTypes
akceptowane wartości:AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService, AzureDatabaseForPGFlexServer, AzureDatabaseForMySQL
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-FileNamePrefix

Nazwa pliku do prefiksu do przywróconych danych kopii zapasowej.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-FromPrefixPattern

Określ zakres rozpoczęcia przywracania obiektów blob dla punktu w czasie przywracania do punktu w czasie. Tej opcji można użyć do określenia zakresu początkowego dla podzbioru obiektów blob w każdym kontenerze do przywrócenia. użyj ukośnika (/), aby oddzielić nazwę kontenera od wzorca prefiksu obiektu blob.

Typ:String[]
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-ItemLevelRecovery

Przełącz parametr, aby włączyć odzyskiwanie na poziomie elementu.

Typ:SwitchParameter
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-PointInTime

Punkt w czasie przywracania.

Typ:DateTime
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-PrefixMatch

Użyj tego parametru, aby filtrować blokowe obiekty blob według prefiksu w kontenerze dla lokalizacji alternatywnej ILR. Po określeniu prefiksu zostaną przywrócone tylko obiekty blob pasujące do tego prefiksu w kontenerze. Dane wejściowe dla tego parametru to tabela skrótu, w której każdy klucz jest nazwą kontenera, a każda wartość jest tablicą prefiksów ciągów dla tego kontenera.

Typ:Hashtable
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RecoveryPoint

Identyfikator punktu odzyskiwania, który ma zostać przywrócony.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RehydrationDuration

Czas trwania ponownego wypełniania dla zarchiwizowanego punktu odzyskiwania w celu pozostania ponownie wypełniania, wartość domyślna czasu trwania ponownego wypełniania wynosi 15.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RehydrationPriority

Priorytet ponownego wypełniania dla zarchiwizowanego punktu odzyskiwania. Ten parametr jest obowiązkowy w przypadku przywracania zarchiwizowanych punktów.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreConfiguration

Przywróć konfigurację przywracania. Użyj tego parametru do przywrócenia za pomocą usługi AzureKubernetesService. Aby utworzyć, zobacz sekcję UWAGI dla właściwości RESTORECONFIGURATION i utwórz tabelę skrótów.

Typ:KubernetesClusterRestoreCriteria
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreLocation

Lokalizacja przywracania docelowego

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreType

Przywróć typ docelowy

Typ:RestoreTargetType
akceptowane wartości:AlternateLocation, OriginalLocation, RestoreAsFiles
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretStoreType

Typ magazynu wpisów tajnych na potrzeby uwierzytelniania źródła danych w magazynie wpisów tajnych. Ten parametr jest obecnie obsługiwany tylko dla usługi AzureDatabaseForPostgreSQL.

Typ:SecretStoreTypes
akceptowane wartości:AzureKeyVault
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-SecretStoreURI

Identyfikator URI wpisu tajnego na potrzeby uwierzytelniania źródła danych w magazynie wpisów tajnych. Ten parametr jest obecnie obsługiwany tylko dla usługi AzureDatabaseForPostgreSQL.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceDataStore

Typ magazynu danych punktu odzyskiwania

Typ:DataStoreType
akceptowane wartości:ArchiveStore, OperationalStore, VaultStore
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetContainerURI

Docelowy identyfikator kontenera konta magazynu, do którego zostaną przywrócone dane kopii zapasowej jako pliki.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetResourceId

Określ identyfikator zasobu docelowego na potrzeby przywracania danych kopii zapasowej w lokalizacji alternatywnej. Na przykład podaj docelowy identyfikator arm bazy danych, do którego chcesz przywrócić, dla parametru workloadType AzureDatabaseForPostgreSQL.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetResourceIdForRestoreAsFile

Identyfikator arm kontenera konta magazynu docelowego, do którego zostaną przywrócone dane kopii zapasowej jako pliki. Ten parametr jest wymagany do przywracania jako plików, gdy przywracanie między subskrypcjami jest wyłączone w magazynie kopii zapasowych.

Typ:String
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

-ToPrefixPattern

Określ zakres końcowy przywracania obiektów blob dla punktu odzyskiwania do punktu w czasie. Za pomocą tej opcji można określić zakres końcowy podzestawu obiektów blob w każdym kontenerze do przywrócenia. użyj ukośnika (/), aby oddzielić nazwę kontenera od wzorca prefiksu obiektu blob.

Typ:String[]
Position:Named
wartość domyślna:None
Wymagane:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

IAzureBackupRestoreRequest