Import-Counter

Import-Counter
    [-Path] <String[]>
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-Counter <String[]>]
    [-MaxSamples <Int64>]
    [<CommonParameters>]

Import-Counter
    [-Path] <String[]>
    -ListSet <String[]>
    [<CommonParameters>]

Import-Counter
    [-Path] <String[]>
    [-Summary]
    [<CommonParameters>]

El cmdlet Import-Counter importa los datos del contador de rendimiento de los archivos de registro del contador de rendimiento y crea objetos para cada ejemplo de contador en el archivo. Los objetos performanceCounterSampleSet que crea son idénticos a los objetos que get-counter devuelve cuando recopila datos del contador de rendimiento.

Puede importar datos de valores separados por comas (.csv), valores separados por tabulaciones ( .tsv) y archivos de registro de rendimiento binario (.blg). Si usa archivos .blg, puede importar hasta 32 archivos en cada comando. Puede usar los parámetros de import-Counter para filtrar los datos que importe.

Junto con los cmdlets Get-Counter y Export-Counter, esta característica le permite recopilar, exportar, importar, combinar, filtrar, manipular y volver a exportar datos del contador de rendimiento en Windows PowerShell.

$Data = Import-Counter -Path ProcessorData.csv

Este comando importa todos los datos de contador del archivo ProcessorData.csv en la variable $Data.

PS C:\> $I = Import-Counter -Path "ProcessorData.blg" -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"

Este comando importa solo los "Processor(_total)\Interrupts/sec" datos de contador del archivo ProcessorData.blg en la variable $I.

The first command uses **Import-Counter** to import all of the performance counter data from the ProcessorData.blg files. The command saves the data in the $Data variable.
PS C:\> $Data = Import-Counter .\ProcessorData.blg

The second command displays the counter paths in the $Data variable. To get the display shown in the command output, the example uses the Format-Table cmdlet to format as a table the counter paths of the first counter in the $Data variable.
PS C:\> $Data[0].CounterSamples | Format-Table -Property Path

Path
----
\\SERVER01\Processor(_Total)\DPC Rate
\\SERVER01\Processor(1)\DPC Rate
\\SERVER01\Processor(0)\DPC Rate
\\SERVER01\Processor(_Total)\% Idle Time
\\SERVER01\Processor(1)\% Idle Time
\\SERVER01\Processor(0)\% Idle Time
\\SERVER01\Processor(_Total)\% C3 Time
\\SERVER01\Processor(1)\% C3 Time

The third command gets the counter paths that end in "Interrupts/sec" and saves the paths in the $IntCtrs variable. It uses the Where-Object cmdlet to filter the counter paths and the ForEach-Object cmdlet to get only the value of the **Path** property of each selected path object.
PS C:\> $IntCtrs = $Data[0].Countersamples | Where-Object {$_.Path -like "*Interrupts/sec"} | ForEach-Object {$_.Path}

The fourth command displays the selected counter paths in the $IntCtrs variable.
PS C:\> $IntCtrs

\\SERVER01\Processor(_Total)\Interrupts/sec
\\SERVER01\Processor(1)\Interrupts/sec
\\SERVER01\Processor(0)\Interrupts/sec

The fifth command uses the **Import-Counter** cmdlet to import the data. It uses the $IntCtrs variable as the value of the *Counter* parameter to import only data for the counter paths in $IntCtrs.
PS C:\> $I = Import-Counter -Path .\ProcessorData.blg -Counter $intCtrs

The sixth command uses the Export-Counter cmdlet to export the data to the Interrupts.csv file.
PS C:\> $I | Export-Counter -Path .\Interrupts.csv -Format CSV

En este ejemplo se muestra cómo seleccionar datos de un archivo de registro de contador de rendimiento (.blg) y, a continuación, exportar los datos seleccionados a un archivo de .csv. Los cuatro primeros comandos obtienen las rutas de acceso de contador del archivo y las guardan en la variable denominada $Data. Los dos últimos comandos importan los datos seleccionados y, a continuación, exportan solo los datos seleccionados.

The first command uses the *ListSet* parameter of the **Import-Counter** cmdlet to get all of the counter sets that are represented in a counter data file.
PS C:\> Import-Counter -Path ProcessorData.csv -ListSet *

CounterSetName     : Processor
MachineName        : \\SERVER01
CounterSetType     : MultiInstance
Description        :
Paths              : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}
PathsWithInstances : {\\SERVER01\Processor(_Total)\DPC Rate, \\SERVER01\Processor(1)\DPC Rate, \\SERVER01
\Processor(0)\DPC Rate, \\SERVER01\Processor(_Total)\% Idle Time...}
Counter            : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}

The second command gets all of the counter paths from the list set.
PS C:\> Import-Counter -Path ProcessorData.csv -ListSet * | ForEach-Object {$_.Paths}

\\SERVER01\Processor(*)\DPC Rate
\\SERVER01\Processor(*)\% Idle Time
\\SERVER01\Processor(*)\% C3 Time
\\SERVER01\Processor(*)\% Interrupt Time
\\SERVER01\Processor(*)\% C2 Time
\\SERVER01\Processor(*)\% User Time
\\SERVER01\Processor(*)\% C1 Time
\\SERVER01\Processor(*)\% Processor Time
\\SERVER01\Processor(*)\C1 Transitions/sec
\\SERVER01\Processor(*)\% DPC Time
\\SERVER01\Processor(*)\C2 Transitions/sec
\\SERVER01\Processor(*)\% Privileged Time
\\SERVER01\Processor(*)\C3 Transitions/sec
\\SERVER01\Processor(*)\DPCs Queued/sec
\\SERVER01\Processor(*)\Interrupts/sec

En este ejemplo se muestra cómo mostrar todas las rutas de acceso de contador en un grupo de conjuntos de contadores importados.

The first command lists in a table the time stamps of all of the data in the ProcessorData.blg file.
PS C:\> Import-Counter -Path ".\disk.blg" | Format-Table -Property Timestamp

The second command saves particular time stamps in the $Start and $End variables. The strings are cast to **DateTime** objects.
PS C:\> $Start = [datetime]"7/9/2008 3:47:00 PM"; $End = [datetime]"7/9/2008 3:47:59 PM"

The third command uses the **Import-Counter** cmdlet to get only counter data that has a time stamp between the start and end times (inclusive). The command uses the *StartTime* and *EndTime* parameters of **Import-Counter** to specify the range.
PS C:\> Import-Counter -Path Disk.blg -StartTime $start -EndTime $end

En este ejemplo solo se importan los datos del contador que tienen una marca de tiempo entre los intervalos iniciales especificados en el comando .

The first command uses the **Import-Counter** cmdlet to import the first (oldest) five samples from the Disk.blg file. The command uses the *MaxSamples* parameter to limit the import to five counter samples.
PS C:\> Import-Counter -Path "Disk.blg" -MaxSamples 5

The second command uses array notation and the Windows PowerShell range operator (..) to get the last five counter samples from the file. These are the five newest samples.
PS C:\> (Import-Counter -Path Disk.blg)[-1 .. -5]

En este ejemplo se muestra cómo importar los cinco ejemplos más antiguos y cinco más recientes de un archivo de registro del contador de rendimiento.

PS C:\> Import-Counter "D:\Samples\Memory.blg" -Summary

OldestRecord            NewestRecord            SampleCount
------------            ------------            -----------
7/10/2008 2:59:18 PM    7/10/2008 3:00:27 PM    1000

Este comando usa el parámetro Summary del cmdlet Import-Counter para obtener un resumen de los datos del contador en el archivo Memory.blg.

The first command uses the *ListSet* parameter of **Import-Counter** to get the counters in OldData.blg, an existing counter log file. The command uses a pipeline operator (|) to send the data to a ForEach-Object command that gets only the values of the **PathsWithInstances** property of each object
PS C:\> $Counters = Import-Counter OldData.blg -ListSet * | ForEach-Object {$_.PathsWithInstances}

The second command gets updated data for the counters in the $Counters variable. It uses the Get-Counter cmdlet to get a current sample, and then export the results to the NewData.blg file.
PS C:\> Get-Counter -Counter $Counters -MaxSamples 20 | Export-Counter C:\Logs\NewData.blg

En este ejemplo se actualiza un archivo de registro del contador de rendimiento.

PS C:\> $Counters = "D:\test\pdata.blg", "D:\samples\netlog.blg" | Import-Counter

Este comando importa los datos del registro de rendimiento de dos registros y guarda los datos en la variable $Counters. El comando usa un operador de canalización para enviar las rutas de acceso del registro de rendimiento a Import-Counter, que importa los datos de las rutas de acceso especificadas.

Observe que cada ruta de acceso está entre comillas y que las rutas de acceso se separan entre sí por una coma.

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 las rutas de acceso de registro del contador de rendimiento a este cmdlet.

Este cmdlet devuelve un Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Si usa el parámetro ListSet, este cmdlet devuelve un objeto Microsoft.PowerShell.Commands.GetCounter.CounterSet. Si usa el parámetro Summary de , este cmdlet devuelve un objeto Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo.

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