Remove-SPDiagnosticsPerformanceCounter
適用版本: SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間: 2015-03-09
移除效能計數器的執行個體。
Syntax
Remove-SPDiagnosticsPerformanceCounter [-Category] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Counter <String>] [-DatabaseServer <SwitchParameter>] [-Instance <String>] [-WebFrontEnd <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Remove-SPDiagnosticsPerformanceCounter 指令程式會從使用狀況資料庫中讀取及記錄的效能計數器集合移除效能計數器。此指令程式也可以用來從集合移除整個類別及計數器類型。如果未指定 DatabaseServer 或 WebFrontEnd 參數,則此指令程式會在伺服器陣列的 Web 前端電腦上移除指定的效能計數器。
注意
只有使用 Windows PowerShell,才能使用 Remove-SPDiagnosticsPerformanceCounter 指令程式。沒有任何使用者介面。
如需 Windows PowerShell for SharePoint 產品的權限及最新資訊,請參閱線上文件 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Category |
必要 |
System.String |
指定要移除的效能計數器類別。 此類型必須是有效的效能計數器類別名稱;例如,ASP.NET、PhysicalDisk 或 Processor。 |
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 |
Counter |
選用 |
System.String |
指定要移除的計數器類型。如果未指定此參數,則此指令程式會移除指定類別的所有效能計數器。 此類型必須是有效的計數器類型名稱;例如,Requests Queued、Avg. Disk Queue Length 及 % Processor Time。 |
DatabaseServer |
選用 |
System.Management.Automation.SwitchParameter |
移除在伺服器陣列中資料庫伺服器上收集的指定效能計數器。 |
Instance |
選用 |
System.String |
指定要移除的效能計數器的執行個體名稱。如果未指定此參數,則此指令程式會移除指定之效能計數器的所有執行個體。 此類型必須是有效的效能計數器執行個體名稱;例如,Total_PerfCounter。 |
WebFrontEnd |
選用 |
System.Management.Automation.SwitchParameter |
移除在伺服器陣列中 Web 前端電腦上收集的效能計數器。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters |
輸入類型
傳回類型
Example
------------------範例 1------------------
Remove-SPDiagnosticsPerformanceCounter -category ASP.NET
此範例會移除 Web 前端電腦上類別 ASP.NET
中的所有計數器。
------------------範例 2------------------
Remove-SPDiagnosticsPerformanceCounter -category ASP.NET -Counter "Requests Queued"
此範例會移除類別 ASP.NET
中已在 Web 前端電腦上要求排入佇列的計數器。
------------------範例 3------------------
Remove-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver
此範例會移除 _Total
執行個體的計數器,以及資料庫伺服器上類別 Processor
中的計數器 % Processor Time
。
See Also
Reference
Add-SPDiagnosticsPerformanceCounter
Get-SPDiagnosticsPerformanceCounter