Compartir a través de

Export-Counter

  • Referencia
Módulo:
Microsoft.PowerShell.Diagnostics

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

Sintaxis

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

Description

El Export-Counter cmdlet exporta los datos del contador de rendimiento (objetos PerformanceCounterSampleSet ) para registrar 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 Export-Counter cmdlet está diseñado para exportar datos devueltos por los Get-Counter cmdlets 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 Get-Counter cmdlet para recopilar datos de tiempo de procesador. Usa un operador de canalización (|) para enviar los datos al Export-Counter cmdlet . El Export-Counter comando 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 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 Import-Counter cmdlet importa los datos del contador de rendimiento del Threads.csv archivo. En el ejemplo se supone que este archivo se exportó anteriormente mediante el Export-Counter cmdlet . Un operador de canalización (|) envía los datos importados al Export-Counter cmdlet . 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 Export-Counter cmdlet 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 los datos de contador de rendimiento desde un equipo remoto y guardar esos datos en un archivo en el equipo remoto.

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

El segundo comando usa un operador de canalización (|) para enviar los datos al Export-Counter $C cmdlet , que lo guarda en el archivo en el Workingset.blg Perf recurso compartido 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 Import-Counter cmdlets y Export-Counter para volver a registrar los datos existentes.

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

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

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

$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). Cuando se incluye este parámetro, se requiere el parámetro MaxSize .

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FileFormat

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

Los valores permitidos para este parámetro son los siguientes:

  • CSV
  • TSV
  • BLG

El valor predeterminado es BLG.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 Get-Counter cmdlet o Import-Counter .

Tipo:PerformanceCounterSampleSet[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso y el nombre 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.

Tipo:String
Alias:PSPath
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

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 contador y que los objetos estén organizados en orden temporal ascendente.

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

es posible que Monitor de rendimiento no puedan leer todos los registros que Export-Counter genera. Por ejemplo, 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 Import-Counter cmdlet no tiene un parámetro ComputerName . Sin embargo, si el equipo está configurado para Windows PowerShell remoto de Windows PowerShell, puede usar el Invoke-Command cmdlet para ejecutar un Import-Counter comando en un equipo remoto.