Export-Counter

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

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

El cmdlet export-Counter de 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.

PS C:\> Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $home\Counters.blg

Este comando exporta los datos del contador a un archivo 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 comando envía los datos a export-Counter a través de la canalización. Si los datos se guardaron en una variable, el comando podría usar una cantidad desproporcionada de memoria.

The first command uses the built-in Windows PowerShell conversion feature to store the value of 1 gigabyte (GB) in bytes in the $1GBInBytes variable. When you type a value followed by K (kilobyte), MB (megabyte), or GB, Windows PowerShell returns the value in bytes.
PS C:\> $1GBInBytes = 1GB

The second command uses the Import-Counter cmdlet to import performance counter data from the Threads.csv file. The example presumes that this file was previously exported by using the **Export-Counter** cmdlet. A pipeline operator (|) sends the imported data to the **Export-Counter** cmdlet. The command uses the *Path* parameter to specify the location of the output file. It uses the *Circular* and *MaxSize* parameters to direct the **Export-Counter** cmdlet to create a circular log that wraps at 1 GB.
PS C:\> Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBinBytes

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

The first command uses the Get-Counter cmdlet to collect working set counter data from Server01, a remote computer. The command saves the data in the $C variable.
PS C:\> $C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples 20

The second command uses a pipeline operator (|) to send the data in $C to the **Export-Counter** cmdlet, which saves it in the Workingset.blg file in the Perf share of the Server01 computer.
PS C:\> $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

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.

The first command uses the **Import-Counter** cmdlet to import performance counter data from the DiskSpace.blg log. It saves the data in the $All variable. This file contains samples of the "LogicalDisk\% Free Space" counter on more than 200 remote computers in the enterprise.
PS C:\> $All = Import-Counter DiskSpace.blg

The second command uses the **CounterSamples** property of the sample set object in $All and the Where-Object cmdlet (alias = "where") to select objects with **CookedValues** of less than 15 (percent). The command saves the results in the $LowSpace variable.
PS C:\> $LowSpace = $All.CounterSamples | where {$_.CookedValues -lt 15}

The third command uses a pipeline operator (|) to send the data in the $LowSpace variable to the **Export-Counter** cmdlet. The command uses the *Path* parameter to indicate that the selected data should be logged in the LowDiskSpace.blg file.
PS C:\> $LowSpace | Export-Counter -Path LowDiskSpace.blg

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

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.

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

• 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.