Enable-SPFeature

啟用位在指定範圍上的已安裝 SharePoint 功能。

Syntax

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>]

Description

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 功能。

參數

-AssignmentCollection

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

-CompatibilityLevel

{{填滿 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