Export-Counter

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

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

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

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

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

Este comando exporta dados do contador para um arquivo BLG.

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

Como o conjunto de dados pode ser muito grande, esse comando envia os dados para Export-Counter através do pipeline. Se os dados foram salvos em uma variável, o comando pode usar uma quantidade desproporcional de memória.

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

Este exemplo converte um arquivo CSV em um formato BLG de dados do 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

Este exemplo mostra como obter dados do contador de desempenho de um computador remoto e salvar os dados em um arquivo no computador 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

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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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

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

  O tipo de contador e o caminho do primeiro objeto de entrada determinam as propriedades registradas no arquivo de log. Se outros objetos de entrada não tiverem um valor para uma propriedade registrada, o campo de propriedade estará vazio. Se os objetos tiverem valores de propriedade que não foram registrados, os valores de propriedade extra serão ignorados.

  O Monitor de Desempenho pode não conseguir ler todos os logs gerados do Contador de Exportação. Por exemplo, o Monitor de Desempenho requer que todos os objetos tenham o mesmo caminho e que todos os objetos estejam separados pelo mesmo intervalo de tempo.

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