Restore-SqlDatabase

參考

模組:: SQLServer

從備份或事務歷史記錄記錄還原資料庫。

Syntax

Restore-SqlDatabase
       [-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>]
       [-Database] <String>
       [-Path <String[]>]
       [[-BackupFile] <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
       [-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>]
       [-Database] <String>
       -ServerInstance <String[]>
       [-Credential <PSCredential>]
       [-ConnectionTimeout <Int32>]
       [[-BackupFile] <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
       [-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>]
       [-Database] <String>
       -InputObject <Server[]>
       [[-BackupFile] <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
       [-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>]
       [-DatabaseObject] <Database>
       [[-BackupFile] <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>]

Description

Restore-SqlDatabase Cmdlet 會在 SQL Server 資料庫上執行還原作業。這包括完整資料庫還原、交易記錄還原和資料庫檔案還原。

這個 Cmdlet 是依照 Microsoft.SqlServer.Management.Smo.Restore 類別建立的。此 Cmdlet 上的參數通常會對應至 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")

此命令會使用 sa SQL 登入，將完整資料庫MainDB從檔案\\mainserver\databasebackup\MainDB.bak還原到伺服器實例Computer\Instance。此命令會提示您輸入密碼來完成驗證。

範例 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 事務歷史記錄還原至傳遞至 ToPointInTime 參數 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 類別的實例。每個建構函式都會採用兩個自變數：檔案的邏輯名稱，以及檔案將放在目標伺服器上的實體位置。 RelocateFile 物件會傳遞至 Restore-SqlDatabase Cmdlet 的 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 類別的實例。建構函式會採用兩個自變數：備份裝置的名稱和備份裝置的類型。此 BackupDeviceItem 對象接著會傳遞至 Restore-SqlDatabase Cmdlet 的 BackupDevice 參數。

範例 8：從 Azure Blob 儲存體服務還原資料庫

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

此命令會將 Windows Azure Blob 儲存體服務上檔案的完整資料庫MainDB還原至伺服器實例Computer\Instance。

範例 9：使用 -AutoRelocateFile 在SQL2017上備份資料庫SQL2016和還原

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 之下。

第二個 Cmdlet 會使用相同的備份檔，在相同計算機上執行的 SQL2017 實例上還原資料庫， (MYSERVER) 。請注意，若沒有 -AutoRelocate 參數，Cmdlet 會因為實體檔案不同而失敗，如上述兩個數據表所示， (更進一步，檔案可能已由SQL2016使用，而且可能無法由SQL2017) 存取。 -AutoRelocate 允許使用者避免明確使用 -RelocationFile，這是相當繁瑣的建置自變數。

注意：假設SQL2016實例和SQL2017實例都有 C：\BAK2 資料夾的存取權。

參數

-AccessToken

用來驗證 SQL Server 的存取令牌，作為使用者/密碼或 Windows 驗證的替代方案。

例如，這可用來連線至 SQL Azure DB 或使用或使用 SQL Azure Managed InstanceService Principal 或 Managed Identity。

要使用的參數可以是字串，代表令牌或 PSAccessToken 執行所傳 Get-AzAccessToken -ResourceUrl https://database.windows.net回的物件。

這個參數是模組 v22 的新功能。

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoRelocateFile

指定此參數時，Cmdlet 會負責自動重新放置備份中的所有邏輯檔案，除非使用 RelocateFile 指定這類邏輯檔案。伺服器 DefaultFile 和 DefaultLog 是用來重新放置檔案。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupDevice

指定儲存備份的裝置。這個參數無法搭配 BackupFile 參數使用。如果您要備份到磁帶裝置，請使用此參數。

Type:	BackupDeviceItem[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BackupFile

指定儲存備份檔的位置或位置。這是選擇性參數。如果未指定，則會搜尋伺服器的默認備份位置以取得記錄還原的名稱 <database name>.trn ，或 <database name>.bak 搜尋所有其他類型的還原。此參數不能與 BackupDevice 參數搭配使用。如果您要備份到 Windows Azure Blob 儲存體服務 (URL) ，則必須指定此參數或 BackupDevice 參數。

Type:	String[]
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockSize

指定備份的實體區塊大小，以位元組為單位。支援的大小為 512、1024、2048、4096、8192、16384、32768 和 65536 (64 KB) 位元組。磁帶裝置的預設值為 65536，所有其他裝置則為 512。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BufferCount

指定要用於備份作業的 I/O 緩衝區總數。您可以指定任何正整數。如果緩衝區的 Sqlservr.exe 進程中沒有足夠的虛擬位址空間，您會收到記憶體不足的錯誤。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Checksum

表示在還原作業期間會計算總和檢查碼值。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearSuspectPageTable

表示在還原作業之後刪除可疑的頁面數據表。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

指定在逾時失敗之前等候伺服器連線的秒數。逾時值必須是介於 0 到 65534 之間的整數。如果指定 0，則連線嘗試不會逾時。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueAfterError

表示發生總和檢查碼錯誤時，作業會繼續。如果未設定，則作業會在總和檢查碼錯誤之後失敗。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

指定 PSCredential 物件，其中包含具有執行此作業許可權之 SQL Server 登入的認證。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

指定要還原的資料庫名稱。這不能與 DatabaseObject 參數搭配使用。使用此參數時，也必須指定 Path、 InputObject或 ServerInstance 參數。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFile

指定還原作業的目標資料庫檔案。只有在 RestoreAction 參數設定為 [檔案] 時，才會使用此參數。當 RestoreAction 參數設定為 Files 時，也必須指定 DatabaseFileGroups 或 DatabaseFiles 參數。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseFileGroup

指定還原作業的目標資料庫檔案群組。只有當 RestoreAction 參數設定為 [檔案] 時，才會使用此參數。當 RestoreAction 參數設定為 Files 時，也必須指定 DatabaseFileGroups 或 DatabaseFiles 參數。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DatabaseObject

指定還原作業的資料庫物件。

Type:	Database
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Encrypt

連接到 SQL Server 時要使用的加密類型。

這個值會對應至 Encrypt Microsoft.Data.SqlClient 驅動程式之 SqlConnection 物件上的屬性 SqlConnectionEncryptOption 。

在模組的 v22 中，預設值為 Optional (，以便與 v21) 相容。在模組 v23+ 中，預設值會是「強制」，這可能會為現有的腳本建立重大變更。

這個參數是模組 v22 的新功能。

Type:	String
Accepted values:	Mandatory, Optional, Strict
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileNumber

指定用來識別備份媒體上目標備份集的索引編號。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostNameInCertificate

用於驗證 SQL Server TLS/SSL 憑證的主機名稱。如果您的 SQL Server 實例已啟用強制加密，而且您想要使用主機名/簡短名稱連線到實例，則必須傳遞此參數。如果省略此參數，則必須將完整域名 (FQDN) 傳遞至 -ServerInstance，才能連線到啟用強制加密的 SQL Server 實例。

這個參數是模組 v22 的新功能。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定還原發生所在 SQL Server 實例的伺服器物件。

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeepReplication

表示會保留復寫組態。如果未設定，還原作業會忽略複寫組態。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxTransferSize

指定要在備份媒體與 SQL Server 實例之間傳輸的最大位元元組數目。可能的值是 65536 個位元組 (64 KB) 的倍數，最多 4194304 個位元組 (4 MB)。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaName

指定識別媒體集的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRecovery

表示資料庫已還原至還原狀態。復原作業不會發生，而且可以還原其他備份。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRewind

表示當還原完成時，磁帶機會在結束位置保持開啟。如果未設定，就會在作業完成之後倒轉磁帶。這不適用於磁碟還原。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Offset

指定要還原的頁面位址。只有在 RestoreAction 設定為 OnlinePage 時，才會使用此功能。

Type:	Int64[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Partial

表示還原作業是部分還原。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

指出此 Cmdlet 會輸出用來執行還原作業的 Smo.Backup 物件。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

指定要在其中執行還原作業之 SQL Server 實例的路徑。這是選擇性參數。如果未指定，則會使用目前的工作位置。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RelocateFile

指定 Smo.Relocate 檔案物件的清單。每個物件都包含邏輯備份檔案名稱以及實體檔案系統位置。還原作業會將還原的資料庫移入目標伺服器上的指定實體位置。

Type:	RelocateFile[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReplaceDatabase

表示已建立資料庫的新映像。這會覆寫任何具有相同名稱的現有資料庫。如果未設定，當伺服器上已有該名稱的資料庫存在時，還原作業將會失敗。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Restart

表示此 Cmdlet 會繼續部分完成的還原作業。如果未設定，Cmdlet 會在備份集開頭重新啟動中斷的還原作業。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestoreAction

指定執行的還原作業類型。有效值為：

資料庫。資料庫已還原。
檔案。還原一或多個數據檔。必須指定 DatabaseFile 或 DatabaseFileGroup 參數。
OnlinePage。數據頁會在在線還原，讓資料庫仍可供使用者使用。
OnlineFiles。數據檔會在線還原，讓資料庫仍可供使用者使用。必須指定 DatabaseFile 或 DatabaseFileGroup 參數。
日誌。交易記錄會還原。

Type:	RestoreActionType
Accepted values:	Database, Files, OnlinePage, OnlineFiles, Log
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RestrictedUser

表示還原資料庫的存取僅限於db_owner固定資料庫角色，以及 dbcreator 和 sysadmin 固定伺服器角色。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

表示此 Cmdlet 會輸出執行還原作業的 Transact-SQL 腳本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

指定 SQL Server 實例的名稱。這個伺服器執行個體會成為還原作業的目標。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SqlCredential

指定儲存驗證資訊的 SQL Server 認證物件。如果您要備份至 Blob 記憶體服務，則必須指定此參數。儲存的驗證資訊包括記憶體帳戶名稱和相關聯的存取金鑰值。請勿為磁碟或磁帶指定此參數。

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StandbyFile

指定復原檔案的名稱，做為 SQL Server 實例映像策略的一部分。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopAtMarkAfterDate

指定要與 StopAtMarkName 參數所指定的標記名稱搭配使用的日期，以判斷復原作業的停止點。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopAtMarkName

指定要停止復原作業的標示交易。這與 StopAtMarkAfterDate 搭配使用，以判斷復原作業的停止點。復原的數據報含包含標記的交易。如果未設定 StopAtMarkAfterDate 值，復原會以指定的名稱在第一個標記停止。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopBeforeMarkAfterDate

指定要與 StopBeforeMarkName 搭配使用的日期，以判斷復原作業的停止點。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopBeforeMarkName

指定要停止復原作業之前所標示的交易。這會與 StopBeforeMarkAfterDate 搭配使用，以判斷復原作業的停止點。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ToPointInTime

指定資料庫記錄還原的端點。這隻適用於 RestoreAction 設定為 Log 時。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustServerCertificate

指出通道是否會在略過憑證鏈結以驗證信任時加密。

在模組的 v22 中，預設為 $true (，以便與 v21) 相容。在模組 v23+ 中，預設值會是『$false』，這可能會為現有的腳本建立重大變更。

這個參數是模組 v22 中的新功能。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnloadTapeAfter

表示當作業完成時，磁帶裝置會重新叫用和卸除。如果未設定，則不會嘗試倒轉並卸載磁帶媒體。這不適用於磁碟備份。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

Microsoft.SqlServer.Management.Smo.Database

Microsoft.SqlServer.Management.Smo.Server[]

指定 SMO。描述還原作業發生所在之 SQL Server 實例的伺服器物件。

System.String[]

Backup-SqlDatabase

Restore-SqlDatabase

Syntax

Description

範例

範例 1：從網路共用上的備份檔還原資料庫

範例 2：還原資料庫事務歷史記錄

範例 3：還原資料庫並提示輸入密碼

範例 4：使用 NORECOVERY 選項還原事務歷史記錄

範例 5：將事務歷史記錄檔記錄還原到一個時間點

範例 6：還原資料庫並重新放置數據和記錄檔

範例 7：從磁帶還原資料庫

範例 8：從 Azure Blob 儲存體 服務還原資料庫

範例 9：使用 -AutoRelocateFile 在SQL2017上備份資料庫SQL2016和還原

參數

-AccessToken

-AutoRelocateFile

-BackupDevice

-BackupFile

-BlockSize

-BufferCount

-Checksum

-ClearSuspectPageTable

-Confirm

-ConnectionTimeout

-ContinueAfterError

-Credential

-Database

-DatabaseFile

-DatabaseFileGroup

-DatabaseObject

-Encrypt

-FileNumber

-HostNameInCertificate

-InputObject

-KeepReplication

-MaxTransferSize

-MediaName

-NoRecovery

-NoRewind

-Offset

-Partial

-PassThru

-Path

-RelocateFile

-ReplaceDatabase

-Restart

-RestoreAction

-RestrictedUser

-Script

-ServerInstance

-SqlCredential

-StandbyFile

-StopAtMarkAfterDate

-StopAtMarkName

-StopBeforeMarkAfterDate

-StopBeforeMarkName

-ToPointInTime

-TrustServerCertificate

-UnloadTapeAfter

-WhatIf

輸入

相關連結

其他資源

範例 8：從 Azure Blob 儲存體服務還原資料庫