Import-Counter
Importa los archivos de registro del contador de rendimiento y crea los objetos que representan cada ejemplo de contador en el registro.
Sintaxis
GetCounterSet (valor predeterminado)
Import-Counter
[-Path] <String[]>
[-StartTime <DateTime>]
[-EndTime <DateTime>]
[-Counter <String[]>]
[-MaxSamples <Int64>]
[<CommonParameters>]
ListSetSet
Import-Counter
[-Path] <String[]>
-ListSet <String[]>
[<CommonParameters>]
SummarySet
Import-Counter
[-Path] <String[]>
[-Summary]
[<CommonParameters>]
Description
El Import-Counter cmdlet 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 del valor separado por comas (.csv), valores separados por tabulaciones (.tsv) y archivos de registro de rendimiento binario (.blg). Si usa .blg archivos, 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 Get-Counter cmdlets 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.
Ejemplos
Ejemplo 1: Importación de todos los datos de contador desde un archivo
$data = Import-Counter -Path ProcessorData.csv
Este comando importa todos los datos de contador del ProcessorData.csv archivo en la $data variable .
Ejemplo 2: Importación de datos de contadores específicos desde un archivo
$i = Import-Counter -Path "ProcessorData.blg" -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"
Este comando importa solo los datos del ProcessorData.blg contador "Processor(_total)\Interrupts/sec" del archivo en la $i variable .
Ejemplo 3: Seleccionar datos de un contador de rendimiento y exportarlos a un archivo
En este ejemplo se muestra cómo seleccionar datos de un archivo de registro del contador de rendimiento (.blg) y, a continuación, exportar los datos seleccionados a un .csv archivo. 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.
$data = Import-Counter .\ProcessorData.blg
$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
$intCtrs = $Data[0].Countersamples | Where-Object {$_.Path -like "*Interrupts/sec"} | ForEach-Object {$_.Path}
$intCtrs
\\SERVER01\Processor(_Total)\Interrupts/sec
\\SERVER01\Processor(1)\Interrupts/sec
\\SERVER01\Processor(0)\Interrupts/sec
$i = Import-Counter -Path .\ProcessorData.blg -Counter $intCtrs
$i | Export-Counter -Path .\Interrupts.csv -Format CSV
El primer comando usa Import-Counter para importar todos los datos del contador de rendimiento de los ProcessorData.blg archivos. El comando guarda los datos en la variable $data.
El segundo comando muestra las rutas de acceso del contador en la $data variable . Para obtener la presentación que se muestra en la salida del comando, en el ejemplo se usa el Format-Table cmdlet para dar formato a como tabla las rutas de acceso de contador del primer contador de la $data variable.
El tercer comando obtiene las rutas de acceso del contador que terminan en Interrupts/sec y guarda las rutas de acceso en la $intCtrs variable . Usa el Where-Object cmdlet para filtrar las rutas de acceso del contador y el ForEach-Object cmdlet para obtener solo el valor de la propiedad Path de cada objeto de ruta de acceso seleccionado.
El cuarto comando muestra las rutas de acceso de contador seleccionadas en la $intCtrs variable .
El quinto comando usa el Import-Counter cmdlet para importar los datos. Usa la $intCtrs variable como valor del parámetro Counter para importar solo los datos de las rutas de acceso del contador en $intCtrs.
El sexto comando usa el Export-Counter cmdlet para exportar los datos al Interrupts.csv archivo.
Ejemplo 4: Mostrar todas las rutas de acceso de contador en un grupo de conjuntos de contadores importados
En este ejemplo se muestra cómo mostrar todas las rutas de acceso de contador en un grupo de conjuntos de contadores importados.
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...}
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
El primer comando usa el parámetro ListSet del Import-Counter cmdlet para obtener todos los conjuntos de contadores representados en un archivo de datos de contador.
El segundo comando obtiene todas las rutas de acceso de contador del conjunto de listas.
Ejemplo 5: Importación de datos de contadores desde un intervalo de marcas de tiempo
En este ejemplo solo se importan los datos de contador que tienen una marca de tiempo entre los intervalos iniciales especificados en el comando .
Import-Counter -Path ".\disk.blg" | Format-Table -Property Timestamp
$start = [datetime]"7/9/2008 3:47:00 PM"; $end = [datetime]"7/9/2008 3:47:59 PM"
Import-Counter -Path Disk.blg -StartTime $start -EndTime $end
El primer comando muestra en una tabla las marcas de tiempo de todos los datos del ProcessorData.blg archivo.
El segundo comando guarda marcas de tiempo concretas en las $start variables y $end . Las cadenas se convierten en objetos DateTime .
El tercer comando usa el Import-Counter cmdlet para obtener solo los datos de contador que tienen una marca de tiempo entre las horas de inicio y finalización (inclusive). El comando usa los parámetros StartTime y EndTime de Import-Counter para especificar el intervalo.
Ejemplo 6: Importación de un número especificado de los ejemplos más antiguos de un archivo de registro del contador de rendimiento
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.
Import-Counter -Path "Disk.blg" -MaxSamples 5
(Import-Counter -Path Disk.blg)[-1 .. -5]
El primer comando usa el Import-Counter cmdlet para importar los cinco primeros ejemplos (más antiguos) del Disk.blg archivo. El comando usa el parámetro MaxSamples para limitar la importación a cinco ejemplos de contadores.
El segundo comando usa la notación de matriz y el operador de intervalo de Windows PowerShell (..) para obtener los cinco últimos ejemplos de contadores del archivo. Estos son los cinco ejemplos más recientes.
Ejemplo 7: Obtener un resumen de los datos de contador de un archivo
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 Import-Counter cmdlet para obtener un resumen de los datos del contador en el Memory.blg archivo.
Ejemplo 8: Actualización de un archivo de registro del contador de rendimiento
En este ejemplo se actualiza un archivo de registro del contador de rendimiento.
$counters = Import-Counter OldData.blg -ListSet * | ForEach-Object {$_.PathsWithInstances}
Get-Counter -Counter $Counters -MaxSamples 20 | Export-Counter C:\Logs\NewData.blg
El primer comando usa el parámetro ListSet de Import-Counter para obtener los contadores en OldData.blg, un archivo de registro de contador existente. El comando usa un operador de canalización (|) para enviar los datos a un ForEach-Object comando que obtiene solo los valores de la propiedad PathsWithInstances de cada objeto.
El segundo comando obtiene los datos actualizados de los contadores de la $counters variable . Usa el Get-Counter cmdlet para obtener un ejemplo actual y, a continuación, exportar los resultados al NewData.blg archivo.
Ejemplo 9: Importación de datos de registro de rendimiento desde varios archivos y, a continuación, guárdelo
$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 $counters variable . 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.
Parámetros
-Counter
Especifica, como matriz de cadenas, los contadores de rendimiento. De forma predeterminada, Import-Counter importa todos los datos de todos los contadores de los archivos de entrada. Escriba una o varias rutas de acceso de contador. Los caracteres comodín se permiten en la parte instancia de la ruta de acceso.
Cada ruta de acceso de contador tiene el siguiente formato. El ComputerName valor es necesario en la ruta de acceso. Por ejemplo:
\\<ComputerName>\<CounterSet>(<Instance>)\<CounterName>
Por ejemplo:
\\Server01\Processor(2)\% User Time\\Server01\Processor(*)\% Processor Time
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | All counter |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
GetCounterSet
| 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 |
-EndTime
Especifica una fecha y hora de finalización que este cmdlet importa los datos del contador entre el StartTime de Get-Date cmdlet . De forma predeterminada, Import-Counter importa todos los datos de contador en los archivos especificados por el parámetro Path .
Propiedades de parámetro
| Tipo: | DateTime |
| Valor predeterminado: | No end time |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetCounterSet
| 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 |
-ListSet
Especifica los conjuntos de contadores de rendimiento que se representan en los archivos exportados. Los comandos con este parámetro no importan ningún dato.
Escriba uno o varios nombres de conjunto de contadores. Se permiten los caracteres comodín. Para obtener todos los conjuntos de contadores del archivo, escriba Import-Counter -ListSet *.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
ListSetSet
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MaxSamples
Especifica el número máximo de muestras de cada contador que se va a importar. De forma predeterminada, Get-Counter importa todos los datos de los archivos especificados por el parámetro Path .
Propiedades de parámetro
| Tipo: | Int64 |
| Valor predeterminado: | No maximum |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetCounterSet
| 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 las rutas de acceso de archivo de los archivos que se van a importar. Este parámetro es obligatorio.
Escriba la ruta de acceso y el nombre de archivo de un archivo, .csv, .tsvo .blg que exportó mediante el Export-Counter cmdlet . Solo puede especificar uno .csv o .tsv archivo, pero puede especificar varios .blg archivos (hasta 32) en cada comando. También puede canalizar cadenas de ruta de acceso de archivo (entre comillas) a Import-Counter.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
| Alias: | PSPath |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-StartTime
Especifica la fecha y hora de inicio en la que este cmdlet obtiene los datos del contador. Escriba un objeto DateTime , como uno creado por el Get-Date cmdlet . De forma predeterminada, Import-Counter importa todos los datos de contador en los archivos especificados por el parámetro Path .
Propiedades de parámetro
| Tipo: | DateTime |
| Valor predeterminado: | No start time |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
GetCounterSet
| 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 |
-Summary
Indica que este cmdlet obtiene un resumen de los datos importados, en lugar de obtener ejemplos de datos de contador individuales.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
SummarySet
| 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 |
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
String
Puede canalizar las rutas de acceso de registro del contador de rendimiento a este cmdlet.
Salidas
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo
Este cmdlet devuelve un Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Si usa el parámetro
Notas
- 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
Invoke-Commandcmdlet para ejecutar unImport-Countercomando en un equipo remoto.
