Import-SPWeb
匯入網站、清單或文件庫。
Syntax
Import-SPWeb
[-Identity] <SPWebPipeBind>
-Path <String>
[-ActivateSolutions]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-HaltOnError]
[-HaltOnWarning]
[-IncludeUserCustomAction <SPIncludeUserCustomAction>]
[-IncludeUserSecurity]
[-NoFileCompression]
[-NoLogFile]
[-UpdateVersions <SPUpdateVersions>]
[-WhatIf]
[-PreserveDeletedUserMetadataReferences]
[<CommonParameters>]Description
Import-SPWeb Cmdlet 會匯入 Web、清單或程式庫。 從程式庫匯入的功能是 SharePoint 產品中的新功能。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
---------------------範例----------------------
Import-SPWeb https://site -Path export.cmp -UpdateVersions Overwrite此範例會將 export.cmp 內容匯入位於 https://site 的網站，以export.cmp 檔案中的內容覆寫網站上的版本內容。
參數
-ActivateSolutions
指定匯入期間是否要啟動使用者解決方案。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。
使用 Global 參數時，所有物件會包含在全域儲存區內。 若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
在執行命令之前，提示您確認操作。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Force
此參數在此 Cmdlet 中沒有函式。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HaltOnError
發生錯誤時停止匯入程序。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-HaltOnWarning
發生警告時停止匯入程序。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
指定匯入目的地的 URL 或 GUID。
此類型必須是有效的 URL、GUID 或物件，例如格式為 https://server_name 的有效 URL，或格式為 1234-4567-5678a 的 GUID。
| Type: | SPWebPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-IncludeUserCustomAction
指定匯入期間是否要包括使用者自訂動作。
有效值為：
全部、無
| Type: | SPIncludeUserCustomAction |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-IncludeUserSecurity
保留使用者安全性設定。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NoFileCompression
啟用或停用匯入封裝中的檔案壓縮。 匯入封裝會儲存在 Path 參數或 Identity 參數所指定的資料夾內。 基於效能的考量，建議使用此參數。 若啟用壓縮功能，匯入程序的速度約可加快 30%。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NoLogFile
不產生匯入記錄檔。 若無此參數， Import-SPWeb Cmdlet 會產生匯出記錄檔，與匯出封裝位於相同的位置。 此記錄檔使用統一登入服務 (ULS)。
建議您使用此參數。 但是，基於效能考量，您可能不想產生記錄檔。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
指定匯入檔案的名稱。
若使用 NoFileCompression 參數，即必須指定目錄，否則所有檔案格式皆屬有效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-PreserveDeletedUserMetadataReferences
即使目的地網站上的 SPUser 物件標示為已刪除，仍嘗試為專案填入 [作者 ('Created By') 欄位。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UpdateVersions
指出當匯入檔案的網站已存在檔案時，該如何解決這些情況。 如果 UpdateVersions 參數不存在，則匯入作業預設會使用 1 (Append) 。
此類型必須是下列任一項：
-Append，將新版本新增至目前的檔案
-覆寫檔案及其所有版本 (刪除，然後插入)
-如果檔案存在於目的地上，請忽略該檔案
預設值為 [將新版本新增至目前檔案]。
有效值為：
附加、忽略、覆寫
| Type: | SPUpdateVersions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊，請輸入下列命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |