Export-SPWeb
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
匯出網站集合、Web 應用程式、清單或文件庫。
Syntax
Export-SPWeb [-Identity] <SPWebPipeBind> -Path <String> [-AssignmentCollection <SPAssignmentCollection>] [-CompressionSize <Int32>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-HaltOnError <SwitchParameter>] [-HaltOnWarning <SwitchParameter>] [-IncludeUserSecurity <SwitchParameter>] [-IncludeVersions <LastMajor | CurrentVersion | LastMajorAndMinor | All>] [-ItemUrl <String>] [-NoFileCompression <SwitchParameter>] [-NoLogFile <SwitchParameter>] [-UseSqlSnapshot <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Export-SPWeb Cmdlet 會匯出網站集合、Web 應用程式、清單或文件庫。從文件庫中匯出是 SharePoint 2010 產品的新功能。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊，請參閱線上說明文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 參數 | 必要 | 輸入 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定要匯出的網址或 GUID。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID、有效的 Microsoft SharePoint Foundation 2010 網站名稱 (例如 MySPSite1)，或有效之 SPWeb 物件的執行個體。 |
Path |
必要 |
System.String |
指定匯出檔案的名稱。 若使用 NoFileCompression 參數，即必須指定目錄，否則所有檔案格式皆屬有效。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
CompressionSize |
選用 |
System.Int32 |
設定壓縮匯出檔案的大小上限。若匯出封裝的總大小大於此大小，匯出的封裝即會被分割成多個檔案。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
Force |
選用 |
System.Management.Automation.SwitchParameter |
強制覆寫既存的匯出封裝。 此類型必須是下列其中一個值： -True -False 預設值為 False。 |
HaltOnError |
選用 |
System.Management.Automation.SwitchParameter |
發生錯誤時停止匯出程序。 |
HaltOnWarning |
選用 |
System.Management.Automation.SwitchParameter |
發生警告時停止匯出程序。 |
IncludeUserSecurity |
選用 |
System.Management.Automation.SwitchParameter |
保留使用者的安全性設定。 |
IncludeVersions |
選用 |
Microsoft.SharePoint.Deployment.SPIncludeVersions |
指出應該併入匯出作業的檔案和清單項目版本歷程記錄類型。若無 IncludeVersions 參數，Export-SPWeb Cmdlet 預設會使用值 1。 此類型必須是下列任一版本： - 檔案和清單項目的上一個主要版本 (預設值) - 目前版本 (上一個主要版本或上一個次要版本) - 檔案和清單項目的上一個主要版本和上一個次要版本 - 檔案和清單項目的所有版本 |
ItemUrl |
選用 |
System.string |
指定要匯出的 Web 應用程式 URL、GUID 或物件。 此類型必須是有效的 URL，例如 http://server_name。 |
NoFileCompression |
選用 |
System.Management.Automation.SwitchParameter |
啟用或停用匯出封裝中的檔案壓縮。匯出封裝會儲存在 Path 參數或 Identity 參數所指定的資料夾內。基於效能的考量，建議使用此參數。若啟用壓縮功能，匯出程序的速度約可加快 30%。 |
NoLogFile |
選用 |
System.Management.Automation.SwitchParameter |
不產生匯出記錄檔。若不指定此參數，Export-SPWeb Cmdlet 會產生匯出記錄檔，與匯出封裝位於相同的位置。此記錄檔使用統一登入服務 (ULS)。 建議使用此參數。但是，基於效能考量，您可能不想產生記錄檔。 |
UseSqlSnapshot |
選用 |
System.Management.Automation.SwitchParameter |
指定在匯出程序開始時建立 SQL 資料庫快照集，而且直接從資料庫快照集中擷取所有的匯出資料。當匯出完成時，會自動刪除此快照集。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
--------------------範例-----------------------
Export-SPWeb http://site -Path "site export.cmp"
此範例會將位於 http://site/ 的網站，匯出至目前目錄下名為 site export.cmp 的檔案。