Install-SPWebPartPack
适用于： SharePoint Foundation 2010, SharePoint Server 2010
上一次修改主题： 2015-03-09
将指定的 Web 部件包安装在指定位置。
Syntax
Install-SPWebPartPack [-LiteralPath] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalInstall <SwitchParameter>] [-Language <UInt32>] [-WebApplication <SPWebApplicationPipeBind>] [-WhatIf [<SwitchParameter>]]
Install-SPWebPartPack [-Name] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-GlobalInstall <SwitchParameter>] [-Language <UInt32>] [-WebApplication <SPWebApplicationPipeBind>] [-WhatIf [<SwitchParameter>]]
详细说明
Install-SPWebPartPack cmdlet 将 Web 部件包安装在本地服务器场中的 LiteralPath 参数位置。通过使用 WebApplication 参数，可以将 Web 部件包安装到特定的 Web 应用程序中。如果未指定 Web 应用程序，则将 Web 部件包安装到所有 Web 应用程序中。
使用 Language 参数可以指定包语言。
使用 GlobalInstall 参数可以将程序包安装到全局程序集缓存 (GAC) 中。GAC 中的程序集被授予 FullTrust 权限，这为此程序包授予了对所有系统级资源的完全访问权限。
使用 Force 参数安装包可以覆盖任何同名或安装在相同位置的现有 Web 部件包。
Parameters
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
LiteralPath |
必需 |
System.String |
指定 Web 部件包的确切路径。 |
Name |
必需 |
System.String |
指定要安装的 Web 部件包的名称。 |
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 |
覆盖任何同名或安装在相同位置的现有 Web 部件包。 |
GlobalInstall |
可选 |
System.Management.Automation.SwitchParameter |
将 Web 部件包安装到全局程序集缓存 (GAC) 中，而不是安装到各 Web 应用程序的 /bin 目录中。此安装将导致可以在服务器上全局访问 Web 部件。 |
Language |
可选 |
System.UInt32 |
指定 Web 部件包的语言 ID。 |
WebApplication |
可选 |
Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind |
指定要在其上安装 Web 部件包的 Web 应用程序。如果未指定 Web 应用程序，则将 Web 部件包安装到所有 Web 应用程序中。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
------------------示例------------------
Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "c:/mywebpart.wpp" -GlobalInstall
此示例从路径 c:/mywebpart.wpp 在服务器场中以全局方式安装名为 MyCustomWebPartPack 的 Web 部件包。