Enable-SPFeature
适用于: 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 功能。
See Also
Reference
Disable-SPFeature
Install-SPFeature
Uninstall-SPFeature
Get-SPFeature