Compartir vía

Export-Counter

Módulo:
Microsoft.PowerShell.Diagnostics Module

Exporta los datos del contador de rendimiento a los archivos de registro.

Sintaxis

Default (valor predeterminado) 

Export-Counter
    [-Path] <String>
    [-FileFormat <String>]
    [-MaxSize <UInt32>]
    -InputObject <PerformanceCounterSampleSet[]>
    [-Force]
    [-Circular]
    [<CommonParameters>]

Description

El cmdlet Export-Counter exporta los datos del contador de rendimiento (PerformanceCounterSampleSet objetos) para registrar los archivos en el registro de rendimiento binario (.blg), el valor separado por comas (.csv) o el formato de valor separado por tabulaciones (.tsv). Este cmdlet se usa para registrar los datos del contador de rendimiento.

El cmdlet Export-Counter está diseñado para exportar datos devueltos por los cmdlets Get-Counter y Import-Counter.

Este cmdlet solo se ejecuta en Windows 7, Windows Server 2008 R2 y versiones posteriores de Windows.

Ejemplos

EJEMPLO 1: Exportación de datos de contador a un archivo

En este ejemplo se exportan los datos del contador a un archivo BLG.

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

El comando usa el cmdlet Get-Counter para recopilar datos de tiempo de procesador. Usa un operador de canalización (|) para enviar los datos al cmdlet Export-Counter. El comando Export-Counter usa la variable Path para especificar el archivo de salida.

Dado que el conjunto de datos puede ser muy grande, este ejemplo envía los datos a Export-Counter a través de la canalización. Si los datos se guardaron en una variable, puede usar una cantidad desproporcionada de memoria.

Ejemplo 2: Exportación de un archivo a un formato de archivo de contador

En este ejemplo se convierte un archivo CSV en un formato BLG de datos de contador.

El cmdlet Import-Counter importa los datos del contador de rendimiento del archivo Threads.csv. En el ejemplo se supone que este archivo se exportó previamente mediante el cmdlet Export-Counter. Un operador de canalización (|) envía los datos importados al cmdlet Export-Counter. El comando usa el parámetro Path para especificar la ubicación del archivo de salida. Usa los parámetros Circular y MaxSize para dirigir el cmdlet Export-Counter para crear un registro circular que se ajuste a 1 GB. El parámetro MaxSize se expresa en megabytes.

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

Ejemplo 3: Obtener datos de contador de un equipo remoto y guardar los datos en un archivo

En este ejemplo se muestra cómo obtener datos de contadores de rendimiento desde un equipo remoto y guardar los datos en un archivo en el equipo remoto.

El primer comando usa el cmdlet Get-Counter para recopilar datos del contador del conjunto de trabajo de Server01, un equipo remoto. El comando guarda los datos en la variable $C.

El segundo comando usa un operador de canalización (|) para enviar los datos de $C al cmdlet Export-Counter, que lo guarda en el archivo Workingset.blg en el recurso compartido de Perf del equipo Server01.

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Ejemplo 4: Volver a registrar los datos existentes

En este ejemplo se muestra cómo usar los cmdlets Import-Counter y Export-Counter para volver a registrar los datos existentes.

El primer comando usa el cmdlet Import-Counter para importar datos del contador de rendimiento desde el registro de DiskSpace.blg. Guarda los datos en la variable $All. Este archivo contiene ejemplos del contador "LogicalDisk% Espacio libre" en más de 200 equipos remotos de la empresa.

El segundo comando usa el cmdlet Where-Object para seleccionar objetos con CookedValue de menos del 15 (porcentaje). El comando guarda los resultados en la variable $LowSpace.

El tercer comando usa un operador de canalización (|) para enviar los datos de la variable $LowSpace al cmdlet Export-Counter. El comando usa el parámetro Path para indicar que los datos seleccionados se deben registrar en el archivo LowDiskSpace.blg.

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

Parámetros

-Circular

Indica que el archivo de salida es un registro circular con el formato primero en entrar, primero en salir (FIFO). Al incluir este parámetro, se requiere el parámetro MaxSize.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileFormat

Especifica el formato de salida del archivo de registro de salida.

Los valores aceptables para este parámetro son:

  • CSV
  • TSV
  • BLG

El valor predeterminado es BLG.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Sobrescribe y reemplaza un archivo existente si existe en la ubicación especificada por el parámetro path .

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Especifica, como matriz, los datos de contador que se van a exportar. Escriba una variable que contenga los datos o un comando que obtenga los datos, como el cmdlet Get-Counter o Import-Counter.

Propiedades de parámetro

Tipo:

PerformanceCounterSampleSet[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-MaxSize

Especifica el tamaño máximo del archivo de salida en megabytes (MB).

Si se especifica el parámetro circular , cuando el archivo de registro alcanza el tamaño máximo especificado, se eliminan las entradas más antiguas a medida que se agregan las más recientes. Si no se especifica el parámetro circular , cuando el archivo de registro alcanza el tamaño máximo especificado, no se agrega ningún dato nuevo y el cmdlet genera un error de no terminación.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Path

Especifica la ruta de acceso y el nombre de archivo del archivo de salida. Escriba una ruta de acceso relativa o absoluta en el equipo local o una ruta de acceso de convención de nomenclatura uniforme (UNC) a un equipo remoto, como \\Computer\Share\file.blg. Este parámetro es obligatorio.

El formato de archivo viene determinado por el valor del parámetro FileFormat, no por la extensión de nombre de archivo en la ruta de acceso.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PerformanceCounterSampleSet

Puede canalizar los datos del contador de rendimiento de Get-Counter o Import-Counter a este cmdlet.

Salidas

None

Notas

El generador de archivos de registro espera que todos los objetos de entrada tengan la misma ruta de acceso de contador y que los objetos se organizan en orden de tiempo ascendente.

El tipo de contador y la ruta de acceso del primer objeto de entrada determina las propiedades registradas en el archivo de registro. Si otros objetos de entrada no tienen un valor para una propiedad grabada, el campo de propiedad está vacío. Si los objetos tienen valores de propiedad que no se registraron, se omiten los valores de propiedad adicionales.

Es posible que el Monitor de rendimiento no pueda leer todos los registros que Export-Counter genera. Por ejemplo, el Monitor de rendimiento requiere que todos los objetos tengan la misma ruta de acceso y que todos los objetos estén separados por el mismo intervalo de tiempo.

El cmdlet Import-Counter no tiene un parámetro ComputerName. Sin embargo, si el equipo está configurado para Windows PowerShell remoto de Windows PowerShell, puede usar el cmdlet Invoke-Command para ejecutar un comando Import-Counter en un equipo remoto.