Disable-SPFeature

项目
10/14/2016

适用于： SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题： 2015-03-09

在给定范围内禁用已安装的 SharePoint 功能。

Syntax

Disable-SPFeature [-Identity] <SPFeatureDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Url <String>] [-WhatIf [<SwitchParameter>]]

详细说明

Disable-SPFeature cmdlet 在给定范围内禁用 SharePoint 功能。如果此功能的范围为服务器场，则无需 URL。否则，请提供将在其中停用此功能的 URL（无需显式范围）。

有关 Windows PowerShell for SharePoint 产品的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

参数	必需	类型	说明
Identity	必需	Microsoft.SharePoint.PowerShell.SPFeatureDefinitionPipeBind	指定要禁用的功能名称或 GUID。该类型必须是位于 14\Template\Features 文件夹中功能文件夹的名称或 GUID，格式为 21d186e1-7036-4092-a825-0eb6709e9281。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 Note 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
Confirm	可选	System.Management.Automation.SwitchParameter	在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters
Force	可选	System.Management.Automation.SwitchParameter	强制禁用功能。
Url	可选	System.String	指定要禁用其功能的 Web 应用程序、网站集或网站的 URL。该类型必须是有效的 URL，例如，http://server_name。
WhatIf	可选	System.Management.Automation.SwitchParameter	显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

输入类型

返回类型

无

Example

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

Disable-SPFeature -identity "MyCustom" -URL http://somesite

此示例禁用 http://somesite 中 "MyCustom" 网站范围的功能。

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

$w = Get-SPWeb http://somesite/myweb | ForEach{ $_.URL }

Get-SPFeature -Web $w |%{ Disable-SPFeature -Identity $_ -URL $w}

此示例禁用 http://somesite/myweb 中子网站的所有功能。

无需在此示例中使用 SPAssignment cmdlet，因为仅存储该 URL 的字符串值，而未存储 Web 对象。

通过