Importa arquivos de log de contador de desempenho (.blg, .csv, .tsv) e cria os objetos que representam cada exemplo de contador no log.
Sintaxe
Import-Counter [-Path] <string[]> [-Counter <string[]>] [-EndTime <DateTime>] [-MaxSamples <Int64>] [-StartTime <DateTime>] [<CommonParameters>] Import-Counter [-Path] <string[]> -ListSet <string[]> [<CommonParameters>] Import-Counter [-Path] <string[]> -Summary <switch> [<CommonParameters>]
Descrição
O cmdlet Import-Counter importa dados de contador de desempenho de arquivos de log de contadores de desempenho e cria objetos para cada exemplo do contador no arquivo. Os objetos PerformanceCounterSampleSet que ele cria são idênticos aos objetos que Get-Counter retorna quando coleta dados de contador de desempenho.
Você pode importar dados de arquivos de log de desempenho separados por vírgulas (.csv), separados por tabulação (.tsv) e de log de desempenho binário (.blg). Se você estiver usando arquivos .blg, poderá importar vários arquivos (até 32 arquivos diferentes) em cada comando. E pode usar os parâmetros de Import-Counter para filtrar os dados importados.
Junto com Get-Counter e Export-Counter, esse recurso permite coletar, exportar, importar, combinar, filtrar, manipular e reexportar dados de contador de desempenho no Windows PowerShell.
Parâmetros
-Counter <string[]>
Importa dados apenas para os contadores de desempenho especificados. Por padrão, Import-Counter importa todos os dados de todos os contadores nos arquivos de entrada. Insira um ou mais caminhos de contador. Curingas são permitidos na parte Instance do caminho.
Cada caminho de contador tem o seguinte formato: Observe que o valor ComputerName é obrigatório no caminho, até mesmo no computador local.
"\\<ComputerName>\<CounterSet>(<Instance>)\<CounterName>"
Por exemplo:
"\\Server01\Processor(2)\% User Time"
"\Processor(*)\% Processor Time
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
true |
-EndTime <DateTime>
Importa apenas dados de contador com um carimbo de data/hora menor ou igual à data e à hora especificadas. Insira um objeto DateTime, como aquele retornado pelo cmdlet Get-Date. Por padrão, Import-Counter importa todos os dados de contador nos arquivos especificados pelo parâmetro Path.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-ListSet <string[]>
Obtém os conjuntos de contadores de desempenho representados nos arquivos exportados. Os comandos com esse parâmetro não importam nenhum dado.
Insira um ou mais nomes de conjuntos de contadores. Os caracteres curinga são permitidos. Para obter todos os conjuntos de contadores no arquivo, digite "import-counter - listset *".
|
Necessário? |
true |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
true |
-MaxSamples <Int64>
Especifica o número máximo de exemplos de cada contador para importação. Por padrão, Get-Counter importa todos os dados nos arquivos especificados pelo parâmetro Path.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica os caminhos dos arquivos que serão importados. Esse parâmetro é obrigatório.
Insira o caminho e o nome de um arquivo .csv, .tsv ou .blg que você exportou usando o cmdlet Export-Counter. É possível especificar somente um arquivo .csv ou .tsv, mas pode-se especificar vários arquivos .blg (até 32) em cada comando. Você também pode enviar por pipe cadeias de caracteres de caminho de arquivo (entre aspas) para Import-Counter.
|
Necessário? |
true |
|
Posição? |
2 |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
true (ByValue) |
|
Aceitar caracteres curinga? |
true |
-StartTime <DateTime>
Importa apenas dados do contador com um carimbo de data/hora maior ou igual à data e à hora especificadas. Insira um objeto DateTime, como aquele retornado pelo cmdlet Get-Date. Por padrão, Import-Counter importa todos os dados de contador nos arquivos especificados pelo parâmetro Path.
|
Necessário? |
false |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
-Summary <switch>
Obtém um resumo dos dados importados, em vez de obter amostras de dados de contador individuais.
|
Necessário? |
true |
|
Posição? |
named |
|
Valor padrão |
|
|
Aceitar entrada do pipeline? |
false |
|
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
|
Entradas |
System.String Você pode canalizar caminhos de log do contador para Import-Counter. |
|
Saídas |
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo Por padrão, Import-Counter retorna Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Se você usar o parâmetro ListSet, Import-Command retornará um objeto Microsoft.PowerShell.Commands.GetCounter.CounterSet. Se você usar o parâmetro Summary, Import-Command retornará um objeto Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo. |
Observações
O cmdlet Import-Counter não tem um parâmetro ComputerName. Porém, se o computador for configurado para comunicação remota do Windows PowerShell, você poderá usar o cmdlet Invoke-Command para executar um comando Import-Counter em um computador remoto.
Exemplo 1
C:\PS># Import-Counter Descrição ----------- Este comando importa todos os dados de contador do arquivo ProcessorData.csv para a variável $data. C:\PS> $data = import-counter -path ProcessorData.csv
Exemplo 2
C:\PS># Import-Counter Descrição ----------- Este comando importa apenas os dados de contador Processor(_total)\Interrupts\sec do arquivo ProcessorData.blg para a variável $i. C:\PS> $i = import-counter -path ProcessorData.blg -counter "\\SERVER01\Processor(_Total)\Interrupts/sec"
Exemplo 3
C:\PS># Import-Counter
Descrição
-----------
Este exemplo mostra como selecionar dados de um arquivo de log de contador de desempenho (.blg) e exportar os dados selecionados para um arquivo .csv.
Os primeiros quatro comandos obtêm os caminhos do contador do arquivo e os salva em uma variável. Os dois últimos comandos importam dados selecionados e exportam apenas os dados selecionados.
O primeiro comando usa Import-Counter para importar todos os dados de contador de desempenho dos arquivos ProcessorData.blg. O comando salva os dados na variável $data.
C:\PS> $data = import-counter .\processordata.blg
O segundo comando exibe os caminhos de contador na variável $data. A exibição é mostrada na saída do comando.
C:\PS> $data[0].countersamples | format-table 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
...
O terceiro comando obtém os caminhos do contador que terminam em "Interrupts/sec" e salva os caminhos na variável $IntCtrs.
C:\PS> $IntCtrs = $data[0].countersamples | where {$_.path -like "*interrupts/sec"} | foreach {$_.path}
O quarto comando exibe os caminhos de contador selecionados.
C:\PS> $IntCtrs
\\SERVER01\Processor(_Total)\Interrupts/sec
\\SERVER01\Processor(1)\Interrupts/sec
\\SERVER01\Processor(0)\Interrupts/sec
O quinto comando usa o cmdlet Import-Counter para importar os dados. Ele usa o parâmetro Counter com a variável $IntCtrs para importar apenas dados para os caminhos de contador em $IntCtrs.
C:\PS> $i = import-counter -path .\processordata.blg -counter $intCtrs
O sexto comando usa o cmdlet Export-Counter para exportar os dados.
C:\PS> $i | export-counter -path .\interrupts.csv -format CSV
Exemplo 4
C:\PS># Import-Counter
Descrição
-----------
Este exemplo mostra como exibir todos os caminhos de contador em um grupo de conjuntos de contadores importados.
O primeiro comando usa o parâmetro ListSet para obter todos os conjuntos de contador que são representados em um arquivo de dados de contador.
C:\PS> 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...}
O segundo comando obtém todos os caminhos de contador do conjunto de listas.
C:\PS> import-counter -path processordata.csv -listset * | foreach {$_.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
Exemplo 5
C:\PS># Import-Counter Descrição ----------- Este exemplo importa apenas os dados de contador que têm um carimbo de data/hora entre os intervalos de início e término especificados no comando. O primeiro comando lista os carimbos de data/hora de todos os dados no arquivo ProcessorData.blg. C:\PS> import-counter -path .\disk.blg | format-table timestamp O segundo e o terceiro comandos salvam carimbos de data/hora específicos nas variáveis $start e $end. As cadeias de caracteres são convertidas em objetos DateTime. C:\PS> $start = [datetime]"7/9/2008 3:47:00 PM" C:\PS> $end = [datetime]"7/9/2008 3:47:59 PM" O quarto comando usa Import-Counter para obter somente dados de contador que têm um carimbo de data/hora entre as horas de início e término (inclusive). O comando usa os parâmetros StartTime e EndTime para especificar o intervalo. C:\PS> $t-data = import-counter -path disk.blg -starttime $start -endtime $end
Exemplo 6
C:\PS># Import-Counter Descrição ----------- Este exemplo mostra como importar as cinco amostras mais antigas e as cinco mais recentes de um arquivo de log de contador de desempenho. O primeiro comando usa o cmdlet Import-Counter para importar dados do arquivo Disk.blg. O comando usa o parâmetro MaxSamples para limitar a importação a cinco amostras de contador. Este comando obtém as primeiras cinco amostras (mais antigas) no arquivo. C:\PS> import-counter -path disk.blg -maxSamples 5 O segundo comando usa notação matricial e o operador de intervalo do Windows PowerShell (..) para obter as últimas cinco amostras de contador do arquivo. Estas são as cinco amostras mais recentes. C:\PS> (import-counter -path disk.blg)[-1 .. -5]
Exemplo 7
C:\PS># Import-Counter Descrição ----------- Este comando usa o parâmetro Summary para obter um resumo dos dados de contador do arquivo Memory.blg. C:\PS> 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
Exemplo 8
C:\PS># Import-Counter
Descrição
-----------
Este exemplo atualiza um arquivo de log de contador de desempenho.
O primeiro comando usa o parâmetro ListSet de Import-Counter para obter os contadores em OldData.blg, um arquivo de log de contador existente. O comando usa um operador de pipeline (|) para enviar dados a um comando Foreach-Object que obtém somente os valores da propriedade PathsWithInstances de cada objeto.
C:\PS> $counters = import-counter olddata.blg -ListSet * | foreach {$_.PathsWithInstances}
O segundo comando usa esses mesmos contadores em um novo comando Get-Counter para obter uma amostra atual e exportá-la para o arquivo NewData.blg.
C:\PS> get-counter -counter $counters -maxSamples 20 | export-counter c:\Logs\newdata.blg
Exemplo 9
C:\PS># Import-Counter Descrição ----------- Este comando importa dados de log de desempenho de dois logs e salva os dados na variável $counters. O comando usa um operador de pipeline para enviar caminhos de log de desempenho para Import-Counter. C:\PS> $counters = "d:\test\pdata.blg", "d:\samples\netlog.blg" | import-counter Observe que cada caminho está entre aspas e que os caminhos são separados um do outro por uma vírgula.
See Also