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