Enable-SPFeature

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

语法

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

说明

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

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

如果尝试使用服务器场范围功能中的 Url 参数,您将收到以下错误消息:

功能“<feature name>”适用于整个场;Url 参数不能与场范围内的功能一起使用。

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

示例

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

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

本示例启用“MyCustom”网站范围内的 SharePoint 功能 https://somesite。

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

$w = Get-SPWeb https://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature -Web $w |%{ Enable-SPFeature -Identity $_ -URL $w}

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

参数

-CompatibilityLevel

{{Fill CompatibilityLevel Description}}

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Force

强制激活功能。 这将导致返回与功能关联的任何自定义代码。

备注

如果使用 Update-SPSolution 更新了该功能,请注意 -Force 将不起作用。 在这种情况下,必须先禁用 Disable-SPFeature 功能,然后使用 Enable-SPFeature

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

-Identity

指定要卸载的功能或 GUID 的名称。

键入的值必须为位于 14\Template\Features 文件夹中的功能文件夹的名称或 GUID,形式为 21d186e1-7036-4092-a825-0eb6709e9281。

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

-PassThru

如果提供,启用后 cmdlet 输出功能定义对象。

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

-Url

指定 Web 应用程序、网站集或为其激活功能的网站的 URL。

键入的值必须是有效的 URL;例如,https://server_name。

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

-WhatIf

显示一条描述命令作用的消息,而不执行命令。 有关详细信息,请键入以下命令:get-help about_commonparameters

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

-工作分配

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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