Import-SPWeb
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
导入网站集、Web 应用程序、列表或库。
Syntax
Import-SPWeb [-Identity] <SPWebPipeBind> -Path <String> [-ActivateSolutions <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-HaltOnError <SwitchParameter>] [-HaltOnWarning <SwitchParameter>] [-IncludeUserCustomAction <None | All>] [-IncludeUserSecurity <SwitchParameter>] [-NoFileCompression <SwitchParameter>] [-NoLogFile <SwitchParameter>] [-UpdateVersions <Append | Overwrite | Ignore>] [-WhatIf [<SwitchParameter>]]
详细说明
Import-SPWeb cmdlet 导入网站集、Web 应用程序、列表或库。从库导入这一功能是 SharePoint 2010 产品的一项新功能。
有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 是否必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定要导入到的 Web 的 URL 或 GUID。 键入的值必须是有效的 URL、GUID 或对象；例如，有效的 URL 形式为 http://server_name，或 GUID 的形式为 1234-4567-5678a。 |
Path |
必需 |
System.String |
指定导入文件的名称。 如果使用了 NoFileCompression 参数，则必须指定目录；否则，任何文件格式都有效。 |
ActivateSolutions |
可选 |
System.Management.Automation.SwitchParameter |
指定是否在导入时激活用户解决方案。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 .gif "注意") Note
在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
|
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 |
出现警告时停止导入过程。 |
IncludeUserCustomAction |
可选 |
Microsoft.SharePoint.Deployment.SPIncludeUserCustomAction |
指定导入期间是否包括用户自定义操作。 |
IncludeUserSecurity |
可选 |
System.Management.Automation.SwitchParameter |
保留用户安全设置。 |
NoFileCompression |
可选 |
System.Management.Automation.SwitchParameter |
启用或禁用导入包中的文件压缩。导入包存储在 Path 参数或 Identity 参数指定的文件夹中。出于性能方面的考虑，建议您使用此参数。如果启用压缩，则导入过程的速度可提高大约 30%。 |
NoLogFile |
可选 |
System.Management.Automation.SwitchParameter |
取消生成导入日志文件。如果此参数不存在，则 Import-SPWeb cmdlet 将在导出包所在的位置生成一个导出日志文件。该日志文件使用统一日志记录服务 (ULS)。 建议您使用此参数。但是，为提高性能，您可能不想生成日志文件。 |
UpdateVersions |
否 |
Microsoft.SharePoint.Deployment.SPUpdateVersions |
指示如何解决要导入到某网站的文件已经存在于该网站上的这种情况。如果缺少 UpdateVersions 参数，则导入操作默认使用值 1。 键入的值必须为下列某一个： -向当前文件添加新版本 -覆盖文件及其所有版本（删除然后插入） -如果存在于目标上，则忽略文件 默认值为向当前文件添加新版本。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
---------------------示例----------------------
Import-SPWeb http://site -Path export.cmp -UpdateVersions -Overwrite
此示例将 export.cmp 的内容导入到网站 http://site，使用 export.cmp 文件的内容覆盖网站上已进行版本管理的内容。