Restore-SqlDatabase

モジュール:

SqlServer Module

バックアップ またはトランザクション ログ レコードからデータベースを復元します。

構文

ByPath (既定)

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Path <String[]>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-Credential <PSCredential>]
    [-ConnectionTimeout <Int32>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Restore-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Restore-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-ClearSuspectPageTable]
    [-KeepReplication]
    [-Partial]
    [-ReplaceDatabase]
    [-RestrictedUser]
    [-Offset <Int64[]>]
    [-RelocateFile <RelocateFile[]>]
    [-AutoRelocateFile]
    [-FileNumber <Int32>]
    [-RestoreAction <RestoreActionType>]
    [-StandbyFile <String>]
    [-StopAtMarkAfterDate <String>]
    [-StopAtMarkName <String>]
    [-StopBeforeMarkAfterDate <String>]
    [-StopBeforeMarkName <String>]
    [-ToPointInTime <String>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Restore-SqlDatabase コマンドレットは、SQL Server データベースに対して復元操作を実行します。 これには、データベースの完全復元、トランザクション ログの復元、データベース ファイルの復元が含まれます。

このコマンドレットは、Microsoft.SqlServer.Management.Smo.Restore クラスの後にモデル化されています。 このコマンドレットのパラメーターは、通常、Smo.Restore オブジェクトのプロパティに対応します。

例

例 1: ネットワーク共有上のバックアップ ファイルからデータベースを復元する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak"

このコマンドは、完全なデータベース MainDB をファイル \\mainserver\databasebackup\MainDB.bak からサーバー インスタンス Computer\Instanceに復元します。

例 2: データベース トランザクション ログを復元する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log

このコマンドは、データベース MainDB のトランザクション ログをファイル \\mainserver\databasebackup\MainDB.trn からサーバー インスタンス Computer\Instanceに復元します。

例 3: データベースを復元し、パスワードを要求する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.bak" -Credential (Get-Credential "sa")

このコマンドは、MainDB SQL ログインを使用して、完全なデータベース \\mainserver\databasebackup\MainDB.bakをファイル Computer\Instanceからサーバー インスタンス saに復元します。 このコマンドを実行すると、認証を完了するためのパスワードの入力を求められます。

例 4: NORECOVERY オプションを使用してトランザクション・ログを復元する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -NoRecovery

このコマンドは、MainDB オプションを使用して、データベース NORECOVERYのトランザクション ログをファイル \\mainserver\databasebackup\MainDB.trnからサーバー インスタンス Computer\Instanceに復元します。

例 5: トランザクション ログ レコードを特定の時点まで復元する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RestoreAction Log -ToPointInTime "Sep 21, 2017 11:11 PM"

このコマンドは、MainDB パラメーター (2017 年 9 月 21 日午後 11:11) に渡された日付まで、データベース のトランザクション ログを復元します。

例 6: データベースを復元し、データ ファイルとログ ファイルを再配置する

PS C:\> $RelocateData = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Data", "c:\MySQLServer\MainDB.mdf")
PS C:\> $RelocateLog = New-Object Microsoft.SqlServer.Management.Smo.RelocateFile("MainDB_Log", "c:\MySQLServer\MainDB.ldf")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "\\mainserver\databasebackup\MainDB.trn" -RelocateFile @($RelocateData,$RelocateLog)

次の使用例は、データベース MainDB 全体をサーバー インスタンス Computer\Instanceに復元し、データ ファイルとログ ファイルを再配置します。 この例では、移動される各ファイルについて、Microsoft.SqlServer.Management.Smo.RelocateFile クラスのインスタンスを構築します。 各コンストラクターは、ファイルの論理名と、ファイルがターゲット サーバーに配置される物理的な場所という 2 つの引数を受け取ります。 RelocateFile オブジェクトは、Restore-SqlDatabase コマンドレットの RelocateFile パラメーターに渡されます。

例 7: テープからデータベースを復元する

PS C:\> $TapeDevice = New-Object Microsoft.Sqlserver.Management.Smo.BackupDeviceItem("\\.\tape0", "Tape")
PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupDevice $TapeDevice

次の使用例は、データベース MainDB を \\.\tape0 という名前のテープ デバイスからサーバー インスタンス Computer\Instanceに復元します。 このデバイスを表すために、この例では Microsoft.Sqlserver.Management.Smo.BackupDeviceItem クラスのインスタンスを構築します。 コンストラクターは、バックアップ デバイスの名前とバックアップ デバイスの種類という 2 つの引数を受け取ります。 この BackupDeviceItem オブジェクトは、Restore-SqlDatabase コマンドレットの BackupDevice パラメーターに渡されます。

例 8: Azure Blob Storage サービスからデータベースを復元する

PS C:\> Restore-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupFile "https://mystorageaccountname.blob.core.windows.net/container/MyDB.bak" -SqlCredential "mySqlCredential"

このコマンドは、Windows Azure Blob Storage サービス上のファイルからサーバー インスタンス MainDBに完全なデータベース Computer\Instanceを復元します。

例 9: SQL2016でデータベースをバックアップし、-AutoRelocateFile を使用してSQL2017に復元する

PS C:\> Get-SqlDatabase -ServerInstance MYSERVER\SQL2016 -Database AdventureWorks | Backup-SqlDatabase -BackupFile 'C:\BAK2\AdventureWorks.bak'
PS C:\> $restore = Restore-SqlDatabase -ServerInstance MYSERVER\SQL2017 -Database AdventureWorks2016 -BackupFile 'C:\BAK2\AdventureWorks.bak' -AutoRelocateFile -PassThru
PS C:\> $db.RelocateFiles

LogicalFileName     PhysicalFileName
---------------     ----------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL14.SQL2017\MSSQL\DATA\AdventureWorks_Log.ldf

# You can see that the original PhysicalFileNames were indeed differet by running the followiong query:
PS C:\> Invoke-Sqlcmd -ServerInstance MYSERVER\SQL2016 -Query "RESTORE FILELISTONLY FROM  DISK = N'C:\BAK2\AdventureWorks.bak' WITH NOUNLOAD" | Select -Property LogicalName,PhysicalName

LogicalName         PhysicalName
-----------         ------------
AdventureWorks_Data C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Data.mdf
AdventureWorks_Log  C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\MSSQL\DATA\AdventureWorks_Log.ldf

最初のコマンドは、マシン MYSERVER 上で実行されている SQL2016 インスタンス上のデータベース AdventureWorks のバックアップを取得します。 バックアップは C:\BAK2 の下に保存されます。

2 番目のコマンドレットで同じバックアップ ファイルを使用して、同じマシン (MYSERVER) で実行されているSQL2017 インスタンス上のデータベースを復元します。 AutoRelocate スイッチがないと、上記の 2 つの表に示すように物理ファイルが異なるため、コマンドレットが失敗したことに注意してください (さらに、ファイルはSQL2016によって使用され、SQL2017がアクセスできない可能性があります)。 -AutoRelocate を使用すると、ユーザーは -RelocationFile を明示的に使用する必要がなくなります。この引数は、ビルドするのが非常に面倒です。

注: SQL2016 インスタンスと SQL2017 インスタンスの両方が C:\BAK2 フォルダーにアクセスできる前提があります。

パラメーター

-AccessToken

ユーザー/パスワードまたは Windows 認証の代わりに、SQL Server に対する認証に使用されるアクセス トークン。

これは、たとえば、SQL Azure DBまたはSQL Azure Managed Instanceを使用してService Principalに接続してManaged Identityするために使用できます。

使用するパラメーターには、トークンを表す文字列、または PSAccessToken を実行して返されるGet-AzAccessToken -ResourceUrl https://database.windows.net オブジェクトのいずれかを指定できます。

このパラメーターは、モジュールの v22 の新機能です。

パラメーターのプロパティ

型:	PSObject
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-AutoRelocateFile

このスイッチを指定すると、 RelocateFile でそのような論理ファイルが指定されていない限り、コマンドレットによってバックアップ内のすべての論理ファイルが自動的に再配置されます。 サーバー DefaultFile と DefaultLog は、ファイルの再配置に使用されます。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-BackupDevice

バックアップを格納するデバイスを指定します。 このパラメーターを BackupFile パラメーターと共に使用することはできません。 テープ デバイスにバックアップする場合は、このパラメーターを使用します。

パラメーターのプロパティ

型:	BackupDeviceItem[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-BackupFile

バックアップ ファイルが格納される場所を指定します。 このパラメーターは省略可です。 指定しない場合、サーバーの既定のバックアップ場所で、ログ復元の名前 <database name>.trn 、または他のすべての種類の復元の <database name>.bak が検索されます。 このパラメーターは BackupDevice パラメーターと共に使用できません。 Windows Azure Blob Storage サービス (URL) にバックアップする場合は、このパラメーターまたは BackupDevice パラメーターを指定する必要があります。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	2
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-BlockSize

バックアップの物理ブロック サイズをバイト単位で指定します。 サポートされるサイズは、512、1024、2048、4096、8192、16384、32768、および 65536 (64 KB) バイトです。 既定値は、テープ デバイスの場合は 65536、他のすべてのデバイスでは 512 です。

パラメーターのプロパティ

型:	Int32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-BufferCount

バックアップ操作に使用される I/O バッファーの総数を指定します。 任意の正の整数を指定できます。 バッファーの Sqlservr.exe プロセスに仮想アドレス空間が不足している場合は、メモリ不足エラーが発生します。

パラメーターのプロパティ

型:	Int32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Checksum

復元操作中にチェックサム値が計算されることを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ClearSuspectPageTable

復元操作の後に、疑わしいページ テーブルが削除されることを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	False
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	cf

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ConnectionTimeout

タイムアウトエラーが発生するまでのサーバー接続を待機する秒数を指定します。 タイムアウト値は、0 ~ 65534 の整数である必要があります。 0 を指定した場合、接続試行はタイムアウトしません。

パラメーターのプロパティ

型:	Int32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByName

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ContinueAfterError

チェックサム エラーが発生したときに操作を続行することを示します。 設定されていない場合、チェックサム エラーの後に操作は失敗します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Credential

この操作を実行する権限を持つ SQL Server ログインの資格情報を含む PSCredential オブジェクトを指定します。

パラメーターのプロパティ

型:	PSCredential
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByName

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Database

復元するデータベースの名前を指定します。 これは DatabaseObject パラメーターでは使用できません。 このパラメーターを使用する場合は、 Path、 InputObject、または ServerInstance パラメーターも指定する必要があります。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByPath

配置:	1
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

ByName

配置:	1
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

ByObject

配置:	1
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-DatabaseFile

復元操作の対象となるデータベース ファイルを指定します。 これは、 RestoreAction パラメーターが Files に設定されている場合にのみ使用されます。 RestoreAction パラメーターが Files に設定されている場合は、DatabaseFileGroups または DatabaseFiles パラメーターも指定する必要があります。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-DatabaseFileGroup

復元操作の対象となるデータベース ファイル グループを指定します。 これは、 RestoreAction パラメーターが File に設定されている場合にのみ使用されます。 RestoreAction パラメーターが Files に設定されている場合は、DatabaseFileGroups または DatabaseFiles パラメーターも指定する必要があります。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-DatabaseObject

復元操作のデータベース オブジェクトを指定します。

パラメーターのプロパティ

型:	Database
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByDBObject

配置:	1
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Encrypt

SQL Server に接続するときに使用する暗号化の種類。

この値は、Microsoft.Data.SqlClient ドライバーの SqlConnection オブジェクトの Encrypt プロパティ SqlConnectionEncryptOption にマップされます。

モジュールの v22 では、既定値は Optional です (v21 との互換性のため)。 モジュールの v23 以降では、既定値は "必須" になり、既存のスクリプトに重大な変更が生じる可能性があります。

このパラメーターは、モジュールの v22 の新機能です。

パラメーターのプロパティ

型:	String
規定値:	None
指定可能な値:	Mandatory, Optional, Strict
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-FileNumber

バックアップ メディア上のターゲット バックアップ セットを識別するために使用されるインデックス番号を指定します。

パラメーターのプロパティ

型:	Int32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-HostNameInCertificate

SQL Server TLS/SSL 証明書の検証に使われるホスト名。 SQL Server インスタンスで Force Encryption が有効になっていて、ホスト名/短縮名を使用してインスタンスに接続する場合は、このパラメーターを渡す必要があります。 このパラメーターを省略した場合、強制暗号化が有効になっている SQL Server インスタンスに接続するには、完全修飾ドメイン名 (FQDN) を -ServerInstance に渡す必要があります。

このパラメーターは、モジュールの v22 の新機能です。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-InputObject

復元が行われる SQL Server インスタンスのサーバー オブジェクトを指定します。

パラメーターのプロパティ

型:	Server[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByObject

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-KeepReplication

レプリケーション構成が保持されることを示します。 設定されていない場合、レプリケーション構成は復元操作によって無視されます。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-MaxTransferSize

バックアップ メディアと SQL Server インスタンスの間で転送される最大バイト数を指定します。 指定できる値は、65536 バイト (64 KB) の倍数で、最大4194304 バイト (4 MB) です。

パラメーターのプロパティ

型:	Int32
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-MediaName

メディア セットを識別する名前を指定します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-NoRecovery

データベースが復元状態に復元されることを示します。 ロールバック操作は行われず、追加のバックアップを復元できます。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-NoRewind

復元が完了したときに、テープ ドライブが終了位置で開いたままであることを示します。 設定されていない場合は、操作の完了後にテープが巻き戻されます。 これは、ディスクの復元には適用されません。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Offset

復元するページ アドレスを指定します。 これは、RestoreAction が OnlinePage に設定されている場合にのみ使用されます。

パラメーターのプロパティ

型:	Int64[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Partial

復元操作が部分復元であることを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-PassThru

このコマンドレットが、復元操作の実行に使用される Smo.Backup オブジェクトを出力することを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Path

復元操作を実行する SQL Server インスタンスのパスを指定します。 このパラメーターは省略可です。 指定しない場合は、現在の作業場所が使用されます。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByPath

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-RelocateFile

Smo.Relocate ファイル オブジェクトの一覧を指定します。 各オブジェクトは、論理バックアップ ファイル名と物理ファイル システムの場所で構成されます。 復元により、復元されたデータベースがターゲット サーバー上の指定された物理的な場所に移動されます。

パラメーターのプロパティ

型:	RelocateFile[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ReplaceDatabase

データベースの新しいイメージが作成されることを示します。 これにより、同じ名前の既存のデータベースが上書きされます。 設定されていない場合、その名前のデータベースがサーバーに既に存在する場合、復元操作は失敗します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Restart

このコマンドレットが部分的に完了した復元操作を再開することを示します。 設定されていない場合、コマンドレットはバックアップ セットの先頭で中断された復元操作を再開します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-RestoreAction

実行される復元操作の種類を指定します。 有効な値は次のとおりです。

• データベース。 データベースが復元されます。
• Files。 1 つ以上のデータ ファイルが復元されます。 DatabaseFile または DatabaseFileGroup パラメーターを指定する必要があります。
• OnlinePage。 ユーザーがデータベースを使用できるように、データ ページがオンラインで復元されます。
• OnlineFiles。 ユーザーがデータベースを使用できるように、データ ファイルはオンラインで復元されます。 DatabaseFile または DatabaseFileGroup パラメーターを指定する必要があります。
• 丸太。 トランスアクション ログが復元されます。

パラメーターのプロパティ

型:	RestoreActionType
規定値:	None
指定可能な値:	Database, Files, OnlinePage, OnlineFiles, Log
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-RestrictedUser

復元されたデータベースへのアクセスが、db_owner固定データベース ロール、および dbcreator および sysadmin 固定サーバー ロールに制限されていることを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Script

このコマンドレットが、復元操作を実行する Transact-SQL スクリプトを出力することを示します。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ServerInstance

SQL Server インスタンスの名前を指定します。 このサーバー インスタンスが復元操作のターゲットになります。

パラメーターのプロパティ

型:	String[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ByName

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	True
残りの引数からの値:	False

-SqlCredential

認証情報を格納する SQL Server 資格情報オブジェクトを指定します。 Blob Storage サービスにバックアップする場合は、このパラメーターを指定する必要があります。 格納される認証情報には、ストレージ アカウント名と、関連付けられているアクセス キーの値が含まれます。 ディスクまたはテープには、このパラメーターを指定しないでください。

パラメーターのプロパティ

型:	PSObject
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-StandbyFile

SQL Server インスタンスのイメージング戦略の一部として使用される元に戻すファイルの名前を指定します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-StopAtMarkAfterDate

StopAtMarkName パラメーターで指定されたマーク名と共に使用する日付を指定して、回復操作の停止ポイントを決定します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-StopAtMarkName

復旧操作を停止するマーク付きトランザクションを指定します。 これは StopAtMarkAfterDate と共に使用され、復旧操作の停止ポイントを決定します。 復旧されたデータには、マークを含むトランザクションが含まれます。 StopAtMarkAfterDate 値が設定されていない場合、指定した名前の最初のマークで回復が停止します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-StopBeforeMarkAfterDate

StopBeforeMarkName と共に使用して復旧操作の停止ポイントを決定する日付を指定します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-StopBeforeMarkName

復旧操作を停止する前にマークされたトランザクションを指定します。 これは StopBeforeMarkAfterDate と共に使用され、復旧操作の停止ポイントを決定します。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-ToPointInTime

データベース ログ復元のエンドポイントを指定します。 これは、 RestoreAction がログに設定されている場合にのみ適用されます。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-TrustServerCertificate

信頼を検証するために証明書チェーンのウォークをバイパスしながらチャネルを暗号化するかどうかを示します。

モジュールの v22 では、既定値は $true です (v21 との互換性のため)。 モジュールの v23 以降では、既定値は "$false" になり、既存のスクリプトに重大な変更が生じる可能性があります。

このパラメーターは、モジュールの v22 の新機能です。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-UnloadTapeAfter

操作が完了すると、テープ デバイスが巻き戻されてアンロードされることを示します。 設定されていない場合、テープ メディアの巻き戻しとアンロードは試行されません。 これはディスク バックアップには適用されません。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	False
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	ウィスコンシン

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server

SMO を指定します。復元操作が行われる SQL Server インスタンスを記述するサーバー オブジェクト。

System.String

関連リンク

• Backup-SqlDatabase