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 cmdlet 从在使用率数据库中读取和记录的性能计数器集合中删除性能计数器。此 cmdlet 还可用于从集合中删除计数器的整个类别和类型。如果未指定 DatabaseServerWebFrontEnd 参数,此 cmdlet 则删除服务器场中 Web 前端计算机上的指定性能计数器。

备注

只有在使用 Windows PowerShell 时才能使用 Remove-SPDiagnosticsPerformanceCounter cmdlet。未提供任何用户界面。

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

Parameters

参数 是否必需 类型 说明

Category

必需

System.String

指定要删除的性能计数器的类别。

键入的值必须是有效的性能计数器类别;例如,ASP.NET、PhysicalDisk 或 Processor。

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWebSPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWebSPSiteSPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

注意Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Confirm

可选

System.Management.Automation.SwitchParameter

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

Counter

可选

System.String

指定要删除的计数器的类型。如果未指定此参数,此 cmdlet 则删除指定类别的所有性能计数器。

键入的值必须是有效的计数器类型名称,例如,Requests Queued、Avg. Disk Queue Length 和 % Processor Time。

DatabaseServer

可选

System.Management.Automation.SwitchParameter

删除在服务器场的数据库服务器上收集的指定性能计数器。

Instance

可选

System.String

指定要删除的性能计数器的实例名称。如果未指定此参数,此 cmdlet 则删除指定性能计数器的所有实例。

键入的值必须是有效的性能计数器实例名称;例如,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"

此示例删除在 Web 前端计算机上具有排队请求的计数器(属于 ASP.NET 类别)。

------------------示例 3------------------

Remove-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver

此示例删除数据库服务器上 Processor 类别中 % Processor Time 计数器的 _Total 计数器实例。

See Also

Reference

Add-SPDiagnosticsPerformanceCounter
Get-SPDiagnosticsPerformanceCounter