Compartilhar via

Export-Counter

  • Referência
Módulo:
Microsoft.PowerShell.Diagnostics

Exporta dados do contador de desempenho para arquivos de log.

Sintaxe

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

Description

O Export-Counter cmdlet exporta dados do contador de desempenho (objetos PerformanceCounterSampleSet ) para arquivos de log no formato log de desempenho binário (.blg), valor separado por vírgula (.csv) ou valor separado por tabulação (.tsv). Use esse cmdlet para registrar dados do contador de desempenho.

O Export-Counter cmdlet foi projetado para exportar dados retornados pelos Get-Counter cmdlets e Import-Counter .

Esse cmdlet é executado apenas no Windows 7, Windows Server 2008 R2 e versões posteriores do Windows.

Exemplos

EXEMPLO 1: Exportar dados do contador para um arquivo

Este exemplo exporta dados de contador para um arquivo BLG.

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

O comando usa o cmdlet para coletar dados de tempo do Get-Counter processador. Ele usa um operador de pipeline (|) para enviar os dados para o Export-Counter cmdlet. O Export-Counter comando usa a variável Path para especificar o arquivo de saída.

Como o conjunto de dados pode ser muito grande, este exemplo envia os dados para Export-Counter por meio do pipeline. Se os dados foram salvos em uma variável, você pode usar uma quantidade desproporcional de memória.

Exemplo 2: Exportar um arquivo para um formato de arquivo de contador

Este exemplo converte um arquivo CSV em um formato BLG de dados de contador.

O Import-Counter cmdlet importa dados do contador de desempenho do Threads.csv arquivo. O exemplo pressupõe que esse arquivo foi exportado anteriormente usando o Export-Counter cmdlet. Um operador de pipeline (|) envia os dados importados para o Export-Counter cmdlet. O comando usa o parâmetro Path para especificar o local do arquivo de saída. Ele usa os parâmetros Circular e MaxSize para direcionar o Export-Counter cmdlet para criar um log circular que é encapsulado em 1 GB. O parâmetro MaxSize é expresso em megabytes.

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

Exemplo 3: Obter dados do contador de um computador remoto e salvar os dados em um arquivo

Este exemplo mostra como obter dados do contador de desempenho de um computador remoto e salva os dados em um arquivo no computador remoto.

O primeiro comando usa o Get-Counter cmdlet para coletar dados do contador do conjunto de trabalho do Server01, um computador remoto. O comando salva os dados na $C variável.

O segundo comando usa um operador de pipeline (|) para enviar os dados $C para o Export-Counter cmdlet, que os salva no Workingset.blg arquivo no Perf compartilhamento do computador Server01.

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Exemplo 4: registrar novamente os dados existentes

Este exemplo mostra como usar os cmdlets and Export-Counter para registrar novamente os Import-Counter dados existentes.

O primeiro comando usa o Import-Counter cmdlet para importar dados do contador de desempenho do DiskSpace.blg log. Ele salva os $All dados na variável. Esse arquivo contém exemplos do contador "LogicalDisk% Free Space" em mais de 200 computadores remotos na empresa.

O segundo comando usa o Where-Object cmdlet para selecionar objetos com CookedValue inferior a 15 (por cento). O comando salva os resultados na $LowSpace variável.

O terceiro comando usa um operador de pipeline (|) para enviar os dados na $LowSpace variável para o Export-Counter cmdlet. O comando usa o parâmetro Path para indicar que os dados selecionados devem ser registrados no LowDiskSpace.blg arquivo.

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

Parâmetros

-Circular

Indica que o arquivo de saída é um log circular com o formato FIFO (primeiro a entrar, primeiro a sair). Quando você inclui esse parâmetro, o parâmetro MaxSize é necessário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileFormat

Especifica o formato de saída do arquivo de log de saída.

Os valores aceitáveis para esse parâmetro são:

  • CSV
  • TSV
  • BLG

O valor padrão é BLG.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Substitui e substitui um arquivo existente se houver um no local especificado pelo parâmetro Path .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica, como uma matriz, os dados do contador a serem exportados. Insira uma variável que contenha os dados ou um comando que obtenha os dados, como o Get-Counter cmdlet ou Import-Counter .

Tipo:PerformanceCounterSampleSet[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaxSize

Especifica o tamanho máximo do arquivo de saída em megabytes (MB).

Se o parâmetro Circular for especificado, quando o arquivo de log atingir o tamanho máximo especificado, as entradas mais antigas serão excluídas à medida que as mais novas forem adicionadas. Se o parâmetro Circular não for especificado, quando o arquivo de log atingir o tamanho máximo especificado, nenhum novo dado será adicionado e o cmdlet gerará um erro de não encerramento.

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Especifica o caminho e o nome do arquivo de saída. Insira um caminho relativo ou absoluto no computador local ou um caminho UNC (Uniform Naming Convention) para um computador remoto, como \\Computer\Share\file.blg. Este parâmetro é obrigatório.

O formato do arquivo é determinado pelo valor do parâmetro FileFormat , não pela extensão do nome do arquivo no caminho.

Tipo:String
Aliases:PSPath
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PerformanceCounterSampleSet

Você pode canalizar dados do contador de desempenho de Get-Counter ou Import-Counter para esse cmdlet.

Saídas

None

Observações

O gerador de arquivo de log espera que todos os objetos de entrada tenham o mesmo caminho de contador e que os objetos sejam organizados em ordem temporal crescente.

O caminho e o tipo de contador do primeiro objeto de entrada determina as propriedades registradas no arquivo de log. Se outros objetos de entrada não tiverem um valor para uma propriedade gravada, o campo de propriedade fica vazio. Se os objetos têm valores de propriedade não registrados, os valores de propriedade extra são ignorados.

O Monitor de Desempenho pode não ser capaz de ler todos os logs Export-Counter gerados. Por exemplo, o Monitor de Desempenho requer que todos os objetos tenham o mesmo caminho e que todos os objetos sejam separados pelo mesmo intervalo de tempo.

O Import-Counter cmdlet não tem um parâmetro ComputerName . No entanto, se o computador estiver configurado para Windows PowerShell remoto, você poderá usar o Invoke-Command cmdlet para executar um Import-Counter comando em um computador remoto.