Enable-SPFeature

项目
10/16/2016

适用于： SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题： 2016-10-12

在给定范围启用安装的 SharePoint 功能。

Syntax

Enable-SPFeature [-Identity] <SPFeatureDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-Url <String>] [-WhatIf [<SwitchParameter>]]

详细说明

Enable-SPFeature cmdlet 在给定范围启用安装的功能。如果功能是服务器场功能，则不需要 URL。否则，提供要启用功能处的 URL，并将基于功能定义在适当的范围进行启用。

除非提供了 PassThru 参数，否则此 cmdlet 没有输出，提供参数时，为新启用的功能返回 SPFeatureDefinition 对象。

备注

如果尝试使用服务器场范围功能中的 Url 参数，您将收到以下错误消息：
功能“<功能名称>”适用于整个服务器场；Url 参数无法用于服务器场范围的功能。

有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

参数	必需	类型	说明
Identity	必需	Microsoft.SharePoint.PowerShell.SPFeatureDefinitionPipeBind	指定要启用的功能名称或 GUID。类型必须为位于 14\Template\Features 文件夹中的功能文件夹的名称或 GUID，形式为 21d186e1-7036-4092-a825-0eb6709e9281。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。备注在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
Confirm	可选	System.Management.Automation.SwitchParameter	在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters
Force	可选	System.Management.Automation.SwitchParameter	强制激活功能。这将导致返回与功能关联的任何自定义代码。
PassThru	可选	System.Management.Automation.SwitchParameter	如果提供，启用后 cmdlet 输出功能定义对象。
Url	可选	System.String	指定 Web 应用程序、网站集或为其激活功能的网站的 URL。该类型必须是有效的 URL；例如，http://server_name。
WhatIf	可选	System.Management.Automation.SwitchParameter	显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

输入类型

返回类型

Example

--------------示例 1-----------------

Enable-SPFeature -identity "MyCustom" -URL http://somesite

此示例在 http://somesite 上启用 "MyCustom" 网站范围的 SharePoint 功能。

--------------示例 2-----------------

$w = Get-SPWeb http://somesite/myweb | ForEach{ $_.URL }

Get-SPFeature -Web $w |%{ Enable-SPFeature -Identity $_ -URL $w}

此示例在 http://somesite/myweb 上启用子网站中的所有 SharePoint 功能。

通过