Backup-SqlDatabase

模組:: SQLPS Module

備份 SQL Server 資料庫物件。

語法

ByPath (預設值)

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    [-BackupContainer <String>]
    [-MirrorDevices <BackupDeviceList[]>]
    [-BackupAction <BackupActionType>]
    [-BackupSetName <String>]
    [-BackupSetDescription <String>]
    [-CompressionOption <BackupCompressionOptions>]
    [-CopyOnly]
    [-ExpirationDate <DateTime>]
    [-FormatMedia]
    [-Incremental]
    [-Initialize]
    [-LogTruncationType <BackupTruncateLogType>]
    [-MediaDescription <String>]
    [-RetainDays <Int32>]
    [-SkipTapeHeader]
    [-UndoFileName <String>]
    [-EncryptionOption <BackupEncryptionOptions>]
    [-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]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByName

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -ServerInstance <String[]>
    [-BackupContainer <String>]
    [-MirrorDevices <BackupDeviceList[]>]
    [-BackupAction <BackupActionType>]
    [-BackupSetName <String>]
    [-BackupSetDescription <String>]
    [-CompressionOption <BackupCompressionOptions>]
    [-CopyOnly]
    [-ExpirationDate <DateTime>]
    [-FormatMedia]
    [-Incremental]
    [-Initialize]
    [-LogTruncationType <BackupTruncateLogType>]
    [-MediaDescription <String>]
    [-RetainDays <Int32>]
    [-SkipTapeHeader]
    [-UndoFileName <String>]
    [-EncryptionOption <BackupEncryptionOptions>]
    [-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]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByDBObject

Backup-SqlDatabase
    [-DatabaseObject] <Database>
    [[-BackupFile] <String[]>]
    [-BackupContainer <String>]
    [-MirrorDevices <BackupDeviceList[]>]
    [-BackupAction <BackupActionType>]
    [-BackupSetName <String>]
    [-BackupSetDescription <String>]
    [-CompressionOption <BackupCompressionOptions>]
    [-CopyOnly]
    [-ExpirationDate <DateTime>]
    [-FormatMedia]
    [-Incremental]
    [-Initialize]
    [-LogTruncationType <BackupTruncateLogType>]
    [-MediaDescription <String>]
    [-RetainDays <Int32>]
    [-SkipTapeHeader]
    [-UndoFileName <String>]
    [-EncryptionOption <BackupEncryptionOptions>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject

Backup-SqlDatabase
    [-Database] <String>
    [[-BackupFile] <String[]>]
    -InputObject <Server[]>
    [-BackupContainer <String>]
    [-MirrorDevices <BackupDeviceList[]>]
    [-BackupAction <BackupActionType>]
    [-BackupSetName <String>]
    [-BackupSetDescription <String>]
    [-CompressionOption <BackupCompressionOptions>]
    [-CopyOnly]
    [-ExpirationDate <DateTime>]
    [-FormatMedia]
    [-Incremental]
    [-Initialize]
    [-LogTruncationType <BackupTruncateLogType>]
    [-MediaDescription <String>]
    [-RetainDays <Int32>]
    [-SkipTapeHeader]
    [-UndoFileName <String>]
    [-EncryptionOption <BackupEncryptionOptions>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByBackupContainer

Backup-SqlDatabase
    [[-BackupFile] <String[]>]
    [-BackupContainer <String>]
    [-MirrorDevices <BackupDeviceList[]>]
    [-BackupAction <BackupActionType>]
    [-BackupSetName <String>]
    [-BackupSetDescription <String>]
    [-CompressionOption <BackupCompressionOptions>]
    [-CopyOnly]
    [-ExpirationDate <DateTime>]
    [-FormatMedia]
    [-Incremental]
    [-Initialize]
    [-LogTruncationType <BackupTruncateLogType>]
    [-MediaDescription <String>]
    [-RetainDays <Int32>]
    [-SkipTapeHeader]
    [-UndoFileName <String>]
    [-EncryptionOption <BackupEncryptionOptions>]
    [-SqlCredential <PSObject>]
    [-BackupDevice <BackupDeviceItem[]>]
    [-PassThru]
    [-Checksum]
    [-ContinueAfterError]
    [-NoRewind]
    [-Restart]
    [-UnloadTapeAfter]
    [-NoRecovery]
    [-DatabaseFile <String[]>]
    [-DatabaseFileGroup <String[]>]
    [-BlockSize <Int32>]
    [-BufferCount <Int32>]
    [-MaxTransferSize <Int32>]
    [-MediaName <String>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Backup-SqlDatabase Cmdlet 會在 SQL Server 資料庫上執行備份作業。這包括完整資料庫備份、事務歷史記錄備份和資料庫檔備份。此 Cmdlet 會在 Microsoft.SqlServer.Management.Smo.Backup 類別之後建立模型。這個類別上的參數通常會對應至該 Smo 物件上的屬性。

若要依伺服器實例路徑和資料庫名稱備份資料庫，請在 Path 參數中指定伺服器實例路徑，並在 Database 參數中指定資料庫名稱。

若要使用 Smo.Server 對象和資料庫名稱來備份資料庫，請在 InputObject 參數中直接或使用管線運算子指定 Smo.Server 物件，以及 Database 參數中的資料庫名稱。

若要依伺服器實例和資料庫名稱備份資料庫，請在 ServerInstance 參數中指定伺服器實例，並在 Database 參數中指定資料庫名稱。

若要使用 Smo.Database 物件備份資料庫，請直接或使用管線運算符，在 DatabaseObject 參數中指定 Smo.Database 物件。

根據預設，此 Cmdlet 會執行完整資料庫備份。使用 BackupAction 參數設定備份的類型。

根據預設，備份檔會儲存在預設伺服器備份位置中，名稱為 databasename.bak，以供完整和/或文件備份使用，以及記錄備份的名稱 databasename.trn 底下。若要指定不同的檔名，請使用 BackupFile 參數。

若要指定備份檔位置並使用自動產生的檔名，請使用 BackupContainer 參數指定位置。

範例

範例 1：備份完整資料庫

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB"

此命令會建立名為 MainDB 之資料庫的完整資料庫備份至伺服器實例 Computer\Instance 的預設備份位置。備份檔名為 MainDB.bak。

範例 2：根據位置備份資料庫

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance"
PS SQLSERVER:\SQL\Computer\Instance> Backup-SqlDatabase -Database "MainDB"

此命令會建立資料庫 MainDB 的完整資料庫備份至伺服器實例 Computer\Instance 的預設備份位置。目前的工作目錄是用來判斷備份發生所在的伺服器實例。

範例 3：備份事務歷史記錄

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Log

此命令會建立資料庫 MainDB 事務歷史記錄的備份至伺服器實例 Computer\Instance 的預設備份位置。備份檔名為 MainDB.trn。

範例 4：備份資料庫並提示輸入認證

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Credential (Get-Credential "sa")

此命令會使用 sa SQL Server 登入，建立資料庫 MainDB 的完整資料庫備份。此命令會提示您輸入密碼以完成驗證。

範例 5：將資料庫備份至網路檔案共用

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

此命令會建立資料庫 MainDB 的完整資料庫備份至檔案 \\mainserver\databasebackup\MainDB.bak。

範例 6：備份伺服器實例中的所有資料庫

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase

此命令會將伺服器實例 Computer\Instance 上的所有資料庫備份到預設備份位置。備份檔的名稱為 <資料庫名稱>.bak。

範例 7：將伺服器實例中的所有資料庫備份至網路檔案共用

PS C:\> Set-Location "SQLSERVER:\SQL\Computer\Instance\Databases"
PS SQLSERVER:\SQL\Computer\Instance\Databases> ForEach($database in (Get-ChildItem)) {
>>> $dbName = $database.Name
>>> Backup-SqlDatabase -Database $dbName -BackupFile "\\mainserver\databasebackup\$dbName.bak"
>>> }

此命令會針對伺服器實例 Computer\Instance 上的每一個資料庫建立完整備份至共用 \\mainserver\databasebackup。備份檔的名稱為 <資料庫名稱>.bak。

範例 8：備份次要檔案群組中的所有檔案

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupAction Files -DatabaseFileGroup "FileGroupJan","FileGroupFeb"

此命令會建立次要檔案群組 FileGroupJan 和 FileGroupFeb 中每個檔案的完整文件備份。

範例 9：建立差異備份

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -Incremental

此命令會建立資料庫 MainDB 的差異備份至伺服器實例 Computer\Instance 的預設備份位置。備份檔名為 MainDB.bak。

範例 10：建立磁帶機的備份

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

此命令會建立資料庫 MainDB 的完整備份至磁帶裝置 \\.\tape0。為了表示此裝置，命令會建構 Microsoft.Sqlserver.Management.Smo.BackupDeviceItem 對象的實例。建構函式會採用兩個自變數：備份裝置的名稱和備份裝置的類型。這個BackupDeviceItem對象會傳遞至Backup-SqlDatabase Cmdlet的BackupDevice 參數。

範例 11：將資料庫備份至 Azure Blob 記憶體服務

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainDB" -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

此命令會建立資料庫 MainDB 的完整備份至 Windows Azure Blob 記憶體服務。它會使用 BackupContainer 來指定 Windows Azure Blob 容器的位置（URL）。備份檔的名稱會自動產生。 SqlCredential 參數可用來指定儲存驗證資訊的 SQL Server 認證名稱。

範例 12：將資料庫備份至 Azure Blob 記憶體服務，並指定檔名

PS C:\> Backup-SqlDatabase -ServerInstance "Computer\Instance" -Database "MainyDB" -BackupFile "https://storageaccountname.blob.core.windows.net/containername/MainDB.bak" -SqlCredential "SQLCredentialName"

此命令會建立資料庫 MainDB 的完整備份至 Windows Azure Blob 記憶體服務。它會使用 BackupFile 參數來指定位置（URL）和備份檔名。 SqlCredential 參數可用來指定 SQL Server 認證的名稱。

範例 13：將所有資料庫備份至 Azure Blob 記憶體服務

PS C:\> Get-ChildItem "SQLSERVER:\SQL\Computer\Instance\Databases" | Backup-SqlDatabase -BackupContainer "https://storageaccountname.blob.core.windows.net/containername" -SqlCredential "SQLCredentialName"

此命令會使用 BackupContainer 參數，將伺服器實例 Computer\Instance 上的所有資料庫備份至 Windows Azure Blob 記憶體服務位置。自動產生備份檔名。

範例 14：建立加密備份

PS C:\> $EncryptionOption = New-SqlBackupEncryptionOption -Algorithm Aes256 -EncryptorType ServerCertificate -EncryptorName "BackupCert"
PS C:\> Backup-SqlDatabase -ServerInstance "." -Database "MainDB" -BackupFile "MainDB.bak" -CompressionOption On -EncryptionOption $EncryptionOption

此範例會建立加密選項，並將其當做 Backup-SqlDatabase 中的參數值來建立加密的備份。

參數

-BackupAction

指定要執行的備份作業類型。有效值為：

資料庫。備份資料庫中的所有數據檔。
檔案。備份 DatabaseFile 或 DatabaseFileGroup 參數中指定的數據檔。
日誌。備份事務歷史記錄。

參數屬性

類型:	BackupActionType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BackupContainer

指定 Cmdlet 儲存備份的資料夾或位置。這可以是磁碟上的資料夾，或 Azure Blob 容器的 URL。在指定實例中備份多個資料庫時，此參數很有用。此參數不能與 BackupDevice 參數搭配使用。 BackupContainer 參數不能與 BackupFile 參數搭配使用。

用來指定位置的路徑應該以正斜線（/）結尾。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BackupDevice

指定儲存備份的裝置。此參數不能與 BackupFile 參數搭配使用。如果您要備份至磁帶，請使用此參數。

參數屬性

類型:	BackupDeviceItem[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BackupFile

指定備份的位置和檔名。這是選擇性參數。如果未指定，備份會儲存在伺服器的默認備份位置，其名稱會以完整備份和檔備份的名稱databasename.bak，或記錄備份的 databasename.trn。此參數不能與 BackupDevice 或 BackupContainer 參數搭配使用。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BackupSetDescription

指定備份集的描述。這是選擇性參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BackupSetName

指定備份組的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BlockSize

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-BufferCount

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Checksum

表示在備份作業期間計算總和檢查碼值。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CompressionOption

指定備份作業的壓縮選項。有效值為：

預設
上
關閉

參數屬性

類型:	BackupCompressionOptions
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConnectionTimeout

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ContinueAfterError

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CopyOnly

表示備份是僅限複製的備份。僅限複製備份不會影響您定期排程傳統備份的一般順序。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定 PSCredential 物件，其中包含具有執行這項作業許可權之 SQL Server 登入的認證。這不是 SQL Server 在存取 SQL Server 外部資源時，用來在內部儲存驗證資訊的 SQL 認證物件。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Database

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

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByPath

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ByName

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ByObject

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseFile

指定要備份的一或多個資料庫檔案。只有當 BackupAction 參數設定為 Files 時，才會使用此參數。當 BackupAction 設定為 Files 時，必須指定 DatabaseFileGroups 或 DatabaseFiles 參數。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseFileGroup

指定備份作業的目標資料庫檔案群組。只有當 BackupAction 參數設定為 Files 時，才會使用此參數。當 BackupAction 設定為 Files 時，必須指定 DatabaseFileGroups 或 DatabaseFiles 參數。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DatabaseObject

指定備份作業的資料庫物件。

參數屬性

類型:	Database
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByDBObject

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EncryptionOption

指定備份作業的加密選項。

參數屬性

類型:	BackupEncryptionOptions
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExpirationDate

指定備份集到期的日期和時間，且備份數據不再被視為有效。這隻適用於儲存在磁碟或磁帶裝置上的備份數據。比到期日還舊的備份集可供稍後的備份覆寫。

參數屬性

類型:	DateTime
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FormatMedia

表示磁帶已格式化為備份作業的第一個步驟。這不適用於磁碟備份。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Incremental

表示執行差異備份。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Initialize

表示與備份作業相關聯的裝置已初始化。這會覆寫媒體上任何現有的備份集，並讓此備份成為媒體上的第一個備份集。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

指定備份位置的伺服器物件。

參數屬性

類型:	Server[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LogTruncationType

指定記錄備份的截斷行為。有效值為：

TruncateOnly
NoTruncate
縮短

預設值為 Truncate。

參數屬性

類型:	BackupTruncateLogType
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaxTransferSize

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MediaDescription

指定包含備份集之媒體的描述。這是選擇性參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MediaName

指定用來識別媒體集的名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MirrorDevices

指定鏡像備份所使用的 BackupDeviceList 物件陣列。

參數屬性

類型:	BackupDeviceList[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoRecovery

表示記錄的尾端未備份。還原時，資料庫處於還原狀態。未設定時，會備份記錄的尾端。這隻適用於 BackupAction 參數設定為Log時。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoRewind

表示備份完成時，磁帶機在結束位置保持開啟狀態。未設定時，作業完成之後，磁帶會重新捲動。這不適用於磁碟或 URL 備份。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassThru

表示 Cmdlet 會輸出執行備份的 Smo.Backup 物件。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定要執行備份作業之 SQL Server 實例的路徑。這是選擇性參數。如果未指定，此參數的值預設為目前的工作位置。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByPath

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Restart

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RetainDays

指定必須經過才能覆寫備份集的天數。這隻適用於儲存在磁碟或磁帶裝置上的備份數據。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Script

指出此 Cmdlet 會輸出執行備份作業的 Transact-SQL 腳本。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ServerInstance

指定 SQL Server 實例的名稱。此伺服器實例會成為備份作業的目標。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByName

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SkipTapeHeader

表示磁帶標頭未讀取。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SqlCredential

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

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UndoFileName

指定復原檔案的名稱，用來儲存復原期間復原的未認可交易。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-UnloadTapeAfter

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

SMO.Server

指定 SMO。伺服器 對象，參考備份作業所在的 SQL Server 實例。

Restore-SqlDatabase

意見反應

此頁面對您有幫助嗎？

共用方式為

Backup-SqlDatabase

語法

ByPath (預設值)

ByName

ByDBObject

ByObject

ByBackupContainer

Description

範例

範例 1：備份完整資料庫

範例 2：根據位置備份資料庫

範例 3：備份事務歷史記錄

範例 4：備份資料庫並提示輸入認證

範例 5：將資料庫備份至網路檔案共用

範例 6：備份伺服器實例中的所有資料庫

範例 7：將伺服器實例中的所有資料庫備份至網路檔案共用

範例 8：備份次要檔案群組中的所有檔案

範例 9：建立差異備份

範例 10：建立磁帶機的備份

範例 11：將資料庫備份至 Azure Blob 記憶體服務

範例 12：將資料庫備份至 Azure Blob 記憶體服務，並指定檔名

範例 13：將所有資料庫備份至 Azure Blob 記憶體服務

範例 14：建立加密備份

參數

-BackupAction

參數屬性

參數集

-BackupContainer

參數屬性

參數集

-BackupDevice

參數屬性

參數集

-BackupFile

參數屬性

參數集

-BackupSetDescription

參數屬性

參數集

-BackupSetName

參數屬性

參數集

-BlockSize

參數屬性

參數集

-BufferCount

參數屬性

參數集

-Checksum

參數屬性

參數集

-CompressionOption

參數屬性

參數集

-Confirm

參數屬性

參數集

-ConnectionTimeout

參數屬性

參數集

-ContinueAfterError

參數屬性

參數集

-CopyOnly

參數屬性

參數集

-Credential

參數屬性

參數集

-Database

參數屬性

參數集

-DatabaseFile

參數屬性

參數集

-DatabaseFileGroup

參數屬性

參數集

-DatabaseObject