Add-SPDiagnosticsPerformanceCounter

Agrega una nueva instancia de un contador de rendimiento a un equipo web front-end o a un servidor de base de datos.

Syntax

Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   -Counter <String>
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   [<CommonParameters>]
Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   [-Counter <String>]
   -Instance <String>
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   [<CommonParameters>]
Add-SPDiagnosticsPerformanceCounter
   [-Category] <String>
   [-Instance <String>]
   [-AllInstances]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-DatabaseServer]
   [-WebFrontEnd]
   [-WhatIf]
   -CounterList <String[]>
   [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El cmdlet Add-SPDiagnosticsPerformanceCounter agrega un contador de rendimiento a un servidor front-end web o a un servidor de bases de datos. Los contadores de rendimiento se leen y se registran en la base de datos de uso. De manera predeterminada, el nuevo contador de rendimiento se agrega a los servidores de base de datos del conjunto de servidores.

Ejemplos

------------------EJEMPLO 1------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category ASP.NET -Counter "Requests Queued"

En este ejemplo, se agrega el contador con el nombre ASP.NET\Requests Queued a los servidores front-end web.

------------------EJEMPLO 2------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category PhysicalDisk -counter "Avg. Disk Queue Length" -allinstances

En este ejemplo, se agregan todas las instancias del contador PhysicalDisk en la categoría Avg. Disk Queue Length a los servidores front-end web.

------------------EJEMPLO 3------------------

C:\PS>Add-SPDiagnosticsPerformanceCounter -category Processor -counter "% Processor Time" -instance "_Total" -databaseserver

En este ejemplo se agrega la instancia _Total del contador % Processor Time de la categoría Processor a servidores de base de datos.

Parámetros

-AllInstances

Recopila todas las instancias de un tipo y categoría de contador en el equipo web front-end o en el servidor de base de datos de destino.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Category

Especifica la categoría del contador de rendimiento que se va a agregar al equipo web front-end o al servidor de base de datos de destino.

El tipo debe ser un nombre válido de categoría de contadores de rendimiento, como, por ejemplo, ASP.NET, PhysicalDisk o Processor.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Counter

Especifica el tipo de contador de rendimiento que se va a agregar al equipo web front-end o al servidor de base de datos de destino.

El tipo debe ser un nombre válido de tipo de contador, como, por ejemplo, Requests Queued, Avg. Disk Queue Length o % Processor Time.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CounterList

{{Fill CounterList Description}}

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Agrega el contador de rendimiento especificado a todos los servidores de base de datos del conjunto.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Instance

Especifica el nombre para mostrar del nuevo contador de rendimiento.

El tipo debe ser un nombre válido de instancia de contador de rendimiento, como, por ejemplo, Total_PerfCounter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebFrontEnd

Agrega el contador de rendimiento especificado a todos los equipos web front-end del conjunto de servidores.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019