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" -allinstancesEn 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" -databaseserverEn 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 |