Install-SPWebPartPack

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

将指定的 Web 部件包安装在指定位置。

语法

Install-SPWebPartPack
       [-LiteralPath] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<CommonParameters>]

Install-SPWebPartPack
       [-Name] <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Force]
       [-GlobalInstall]
       [-Language <UInt32>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [-CompatibilityLevel <String>]
       [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。您可以只使用来自一个参数集的参数，也可以不合并来自不同参数集的参数。若要详细了解如何使用参数集，请参阅 Cmdlet 参数集。

Install-SPWebPartPack cmdlet 将 Web 部件包安装在本地服务器场中的 LiteralPath 参数位置。通过使用 WebApplication 参数，可以将 Web 部件包安装到特定的 Web 应用程序中。如果未指定 Web 应用程序，则将 Web 部件包安装到所有 Web 应用程序中。

使用 Language 参数可以指定包语言。

使用 GlobalInstall 参数可以将程序包安装到全局程序集缓存 (GAC) 中。 GAC 中的程序集被授予 FullTrust 权限，这为此程序包授予了对所有系统级资源的完全访问权限。

使用 Force 参数安装包可以覆盖任何同名或安装在相同位置的现有 Web 部件包。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

------------------示例------------------

Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall

此示例从路径 c:/mywebpart.wpp 在服务器场中以全局方式安装名为 MyCustomWebPartPack 的 Web 部件包。

参数

-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

-CompatibilityLevel

指定创建新 SPSite 对象时要使用的模板版本。此值为网站集设置初始 CompatibilityLevel 值。如果不指定此参数，CompatibilityLevel 默认为 Web 应用程序可能的最高版本，具体取决于 SiteCreationMode 设置。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

覆盖任何同名或安装在相同位置的现有 Web 部件包。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-GlobalInstall

将 Web 部件包安装到全局程序集缓存 (GAC) 中，而不是安装到各 Web 应用程序的 /bin 目录中。此安装将导致可以在服务器上全局访问 Web 部件。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Language

指定 Web 部件包的语言 ID。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-LiteralPath

指定 Web 部件包的确切路径。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Name

指定要安装的 Web 部件包的名称。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

指定要在其上安装 Web 部件包的 Web 应用程序。如果未指定 Web 应用程序，则将 Web 部件包安装到所有 Web 应用程序中。

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

通过