Add-SPDiagnosticsPerformanceCounter
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
新增效能計數器的執行個體至 Web 前端電腦或資料庫伺服器。
Syntax
Add-SPDiagnosticsPerformanceCounter [-Category] <String> -Counter <String> [-AllInstances <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DatabaseServer <SwitchParameter>] [-WebFrontEnd <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Add-SPDiagnosticsPerformanceCounter [-Category] <String> -Instance <String> [-AllInstances <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Counter <String>] [-DatabaseServer <SwitchParameter>] [-WebFrontEnd <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Add-SPDiagnosticsPerformanceCounter Cmdlet 會新增效能計數器到前端網頁伺服器或資料庫伺服器上。效能計數器在經讀取後記錄於使用狀況資料庫中。根據預設，新的效能計數器會新增至伺服器陣列中的資料庫伺服器。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Category |
必要 |
System.String |
指定效能計數器的類別以新增至目標 Web 前端電腦或資料庫伺服器。 此類型必須是效能計數器類別的有效名稱，例如 ASP.NET、PhysicalDisk 或 Processor。 |
Counter |
必要 |
System.String |
指定計數器的類型以新增至目標 Web 前端電腦或資料庫伺服器。 此類型必須是計數器類型的有效名稱，例如 Requests Queued、Avg. Disk Queue Length 及 % Processor Time。 |
Instance |
必要 |
System.String |
指定新效能計數器的顯示名稱。 此類型必須是效能計數器執行個體的有效名稱，例如 Total_PerfCounter。 |
AllInstances |
選用 |
System.Management.Automation.SwitchParameter |
收集目標 Web 前端電腦或資料庫伺服器上計數器類別與類型的所有執行個體。 |
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 |
DatabaseServer |
選用 |
System.Management.Automation.SwitchParameter |
新增指定的效能計數器至伺服器陣列中的所有資料庫伺服器。 |
WebFrontEnd |
選用 |
System.Management.Automation.SwitchParameter |
新增指定的效能計數器至伺服器陣列中的所有 Web 前端電腦。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
------------------範例 1------------------
Add-SPDiagnosticsPerformanceCounter -category ASP.NET -Counter "Requests Queued"
此範例會在前端網頁電腦上新增名為 ASP.NET\Requests Queued 的計數器。
------------------範例 2------------------
Add-SPDiagnosticsPerformanceCounter -category PhysicalDisk -counter "Avg. Disk Queue Length" -allinstances
此範例會在前端網頁電腦上的 Avg. Disk Queue Length 類別中新增 PhysicalDisk 計數器的所有執行個體。
------------------範例 3------------------
Add-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver
此範例會在資料庫伺服器上的 Processor 類別中新增 % Processor Time 計數器的 _Total 執行個體。
See Also
Reference
Get-SPDiagnosticsPerformanceCounter
Remove-SPDiagnosticsPerformanceCounter