英語で読む

次の方法で共有


Initialize-AzDataProtectionRestoreRequest

保護されたバックアップ インスタンスで復元をトリガーするための復元要求オブジェクトを初期化します。

構文

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

このコマンドは、復元のトリガーに使用できる復元要求オブジェクトを初期化しました。

例 2: 保護された 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

このコマンドは、BLOB の復元をトリガーするために使用できる復元要求オブジェクトを初期化しました。

例 3: 保護された 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

このコマンドは、BLOB のコンテナー レベルで項目レベルの回復をトリガーするために使用できる復元要求オブジェクトを初期化しました。

例 4: 保護された AzureBlob Backup インスタンスのコンテナー/prefixMatch の項目レベル回復の復元要求オブジェクトを取得する

$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 コンテナーの名前プレフィックスに基づいて BLOB レベルで項目レベルの回復をトリガーするために使用できる復元要求オブジェクトを初期化しました。

上記の restoreRequest では、次のコンテナー/BLOB を復元します。

FromPrefix ToPrefix "container1/aaa" "container1/bbb" (このプレフィックス範囲で一致するすべての BLOB を復元します) "container1/ccc" "container1/ddd" "container2/aab" "container2/abc" "container3" "container3-0" (container3 全体を復元)

注: 範囲は互いに重複しないようにしてください。 参照: 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

1 番目と 2 番目のコマンドは、Azure リソース グラフからコンテナーとバックアップ インスタンスをフェッチします。 3 番目のコマンドは、リージョン間の復元のためにセカンダリ リージョンから復旧ポイントをフェッチするために使用されます。 最後のコマンドは、データ ソースタイプ AzureDatabaseForPostgreSQL のデータベースとして、別の場所に復元するためのリージョン間復元要求オブジェクトを構築します。 RestoreLocation パラメーターは $vault に設定されることに注意してください。$vaultではなく、ReplicatedRegion[0] (ペアリージョン)。通常の復元の場所。 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

1 番目と 2 番目のコマンドは、Azure リソース グラフからコンテナーとバックアップ インスタンスをフェッチします。 3 番目のコマンドは、リージョン間の復元のためにセカンダリ リージョンから復旧ポイントをフェッチするために使用されます。 最後のコマンドは、データ ソースタイプ AzureDatabaseForPostgreSQL のファイルとして、復元用のリージョン間復元要求オブジェクトを構築します。 RestoreLocation パラメーターは $vault に設定されることに注意してください。$vaultではなく、ReplicatedRegion[0] (ペアリージョン)。通常の復元の場所。 Test-AzDataProtectionBackupInstanceRestore、Start-AzDataProtectionBackupInstanceRestore コマンドを使用して、復元を検証してトリガーします。

パラメーター

-BackupInstance

元のローカル復元をトリガーするバックアップ インスタンス オブジェクト。 構築するには、BACKUPINSTANCE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:BackupInstanceResource
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ContainersList

項目レベル回復のコンテナー名。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DatasourceType

データ ソースの種類

型:DatasourceTypes
指定可能な値:AzureDisk, AzureBlob, AzureDatabaseForPostgreSQL, AzureKubernetesService, AzureDatabaseForPGFlexServer, AzureDatabaseForMySQL
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FileNamePrefix

復元されたバックアップ データの前に付けるファイル名。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FromPrefixPattern

PITR の BLOB 復元の開始範囲を指定します。 このオプションを使用して、復元する各コンテナー内の BLOB のサブセットの開始範囲を指定できます。 では、スラッシュ (/) を使用して、コンテナー名を BLOB プレフィックス パターンから分離します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ItemLevelRecovery

項目レベルの回復を有効にするには、パラメーターを切り替えます。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PointInTime

復元の時点。

型:DateTime
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrefixMatch

このパラメーターを使用して、別の場所 ILR のコンテナー内のプレフィックスでブロック BLOB をフィルター処理します。 プレフィックスを指定すると、コンテナー内のそのプレフィックスに一致する BLOB のみが復元されます。 このパラメーターの入力はハッシュテーブルであり、各キーはコンテナー名であり、各値はそのコンテナーの文字列プレフィックスの配列です。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RecoveryPoint

復元する復旧ポイントの ID。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RehydrationDuration

アーカイブされた復旧ポイントがリハイドレートされた状態を維持するためのリハイドレート期間。リハイドレート期間の既定値は 15 です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RehydrationPriority

アーカイブされた復旧ポイントのリハイドレートの優先順位。 このパラメーターは、アーカイブされたポイントのリハイドレート復元に必須です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RestoreConfiguration

復元の復元構成。 このパラメーターを使用して、AzureKubernetesService を使用して復元します。 構築するには、RESTORECONFIGURATION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

型:KubernetesClusterRestoreCriteria
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RestoreLocation

ターゲット復元の場所

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RestoreType

復元ターゲットの種類

型:RestoreTargetType
指定可能な値:AlternateLocation, OriginalLocation, RestoreAsFiles
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SecretStoreType

データ ソースのシークレット ストア認証のシークレット ストアの種類。 このパラメーターは、現在 AzureDatabaseForPostgreSQL でのみサポートされています。

型:SecretStoreTypes
指定可能な値:AzureKeyVault
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SecretStoreURI

データ ソースのシークレット ストア認証のシークレット URI。 このパラメーターは、現在 AzureDatabaseForPostgreSQL でのみサポートされています。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SourceDataStore

復旧ポイントのデータストアの種類

型:DataStoreType
指定可能な値:ArchiveStore, OperationalStore, VaultStore
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TargetContainerURI

バックアップ データをファイルとして復元するターゲット ストレージ アカウント コンテナー ID。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TargetResourceId

バックアップ データを別の場所に復元するためのターゲット リソース ID を指定します。 たとえば、復元先のターゲット データベース ARM ID を workloadType AzureDatabaseForPostgreSQL に指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TargetResourceIdForRestoreAsFile

バックアップ データをファイルとして復元するターゲット ストレージ アカウント コンテナー ARM ID。 このパラメーターは、バックアップ コンテナーでサブスクリプション間の復元が無効になっている場合に、ファイルとして復元するために必要です。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ToPrefixPattern

PITR の BLOB 復元の終了範囲を指定します。 このオプションを使用して、復元する各コンテナー内の BLOB のサブセットの終了範囲を指定できます。 では、スラッシュ (/) を使用して、コンテナー名を BLOB プレフィックス パターンから分離します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

出力

IAzureBackupRestoreRequest