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 registrar arquivos no log de desempenho binário (.blg), no valor separado por vírgulas (.csv) ou no formato de valor separado por tabulação (.tsv). Você pode usar esse cmdlet para registrar dados do contador de desempenho em log.

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

Esse cmdlet é executado somente 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

Esse comando exporta dados de 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 do Export-Counter. O comando Export-Counter usa a variável caminho para especificar o arquivo de saída.

Como o conjunto de dados pode ser muito grande, esse comando envia os dados para do Contador de Exportação por meio do pipeline. Se os dados foram salvos em uma variável, o comando poderá 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 de 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 de 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 redirecionar dados do contador de desempenho de get-counter ou de contador de importação 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 Export-Counter. 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 cmdlet do Contador de Importação 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.