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
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla