Get-SPFeature

發行項
03/07/2017

適用版本： SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間： 2015-03-09

根據指定的範圍傳回 SharePoint 功能。

Syntax

Get-SPFeature [[-Identity] <SPFeatureDefinitionPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Limit <String>]

Get-SPFeature [[-Identity] <SPFeatureDefinitionPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Farm <SwitchParameter>] [-Limit <String>]

Get-SPFeature [[-Identity] <SPFeatureDefinitionPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Limit <String>] [-Sandboxed <SwitchParameter>] [-Site <SPSitePipeBind>]

Get-SPFeature [[-Identity] <SPFeatureDefinitionPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Limit <String>] [-Web <SPWebPipeBind>]

Get-SPFeature [[-Identity] <SPFeatureDefinitionPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Limit <String>] [-WebApplication <SPWebApplicationPipeBind>]

詳細描述

SPFeature Cmdlet 會參與參數集。所有參數集都採用 Identity 參數，它可以是 SharePoint 功能的相對路徑 (考慮到功能名稱) 或功能定義的 GUID。若提供 Identity 參數，Cmdlets 會嘗試尋找指定的功能定義或指定範圍的執行個體。若未指定參數，則會傳回所有已安裝的功能。

Get-SPFeature Cmdlet 在每個範圍的運作狀況都不相同，會傳回各層級已啟用的功能。若不提供任何範圍，即傳回所有已安裝的功能。

Parameters

參數	必要	類型	描述
Identity	選用	Microsoft.SharePoint.PowerShell.SPFeatureDefinitionPipeBind	指定要擷取的功能名稱。此類型必須是要取得之功能的完整或部分名稱 (格式為 Feature1) 或 GUID (格式為 1234-4567-9879)。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
Farm	選用	System.Management.Automation.SwitchParameter	指定使用此參數時，只顯示已啟用的伺服器陣列功能。
Limit	選用	System.String	限制顯示結果。若指定「All」，即顯示所有功能。此類型必須是大於 0 的有效數字。預設值為 200。
Site	選用	Microsoft.SharePoint.PowerShell.SPSitePipeBind	指定已啟用功能取得來源的網站集合名稱。此類型必須是網站集合的有效 URL，格式為 http://server_name。
Web	選用	Microsoft.SharePoint.PowerShell.SPWebPipeBind	指定網路的 URL 或 GUID。此類型必須是格式為 http://server_name 的有效 URL，或格式為 1234-5678-9876-0987 的 GUID。
WebApplication	選用	Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind	指定已啟用功能取得來源的 Web 應用程式名稱。此類型必須是 Web 應用程式的有效 URL，格式為 http://server_name。

輸入類型

傳回類型

Example

--------------範例 1-----------------

Get-SPFeature -Limit ALL | Where-Object {$_.Scope -eq "SITE"}

此範例會傳回所有已安裝 SITE 範圍功能的清單。

--------------範例 2-----------------

Get-SPSite http://somesite | Get-SPWeb -Limit ALL |%{ Get-SPFeature -Web $_ } | Select DisplayName,ID -Unique

此範例會傳回 http://somesite 網站集合中，每個 SPWeb 物件上每一個特別啟用之功能的名稱及識別碼 (ID)。

共用方式為