Get-SPFeature

项目
10/14/2016

适用于： 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 参数，该 cmdlet 将尝试查找给定范围的给定功能定义或实例。如果未指定参数，那么将返回所有已安装的功能。

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 参数，则会自动处理这些对象。 Note 在使用 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	指定 Web 的 URL 或 GUID。类型必须为有效的 URL，格式为 http://server_name；也可以是 GUID，格式为 1234-5678-9876-0987。
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)。