Disable-SPFeature
適用版本: 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 參數,將會自動處置這些物件。 注意 使用 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,因為未儲存 Web 物件,僅使用 URL 的字串值。
See Also
Reference
Install-SPFeature
Enable-SPFeature
Get-SPFeature
Uninstall-SPFeature