Export-Counter
Exporta dados do contador de desempenho para arquivos de log.
Sintaxe
Default (Default)
Export-Counter
[-Path] <String>
[-FileFormat <String>]
[-MaxSize <UInt32>]
-InputObject <PerformanceCounterSampleSet[]>
[-Force]
[-Circular]
[<CommonParameters>]
Description
O cmdlet Export-Counter exporta dados do contador de desempenho (objetos PerformanceCounterSampleSet) para registrar arquivos no log de desempenho binário (.blg), valor separado por vírgulas (.csv) ou formato de valor separado por tabulação (.tsv). Use 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.
Exemplos
EXEMPLO 1: Exportar dados de 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 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, 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 cmdlet Import-Counter importa dados do contador de desempenho do arquivo Threads.csv. O exemplo presume que esse arquivo foi exportado anteriormente usando o cmdlet Export-Counter. Um operador de pipeline (|) envia os dados importados para o cmdlet Export-Counter. 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 cmdlet Export-Counter para criar um log circular que encapsula 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 de contador de um computador remoto e salvar os dados em um arquivo
Este exemplo mostra como obter dados de contador de desempenho de um computador remoto e salvar os dados em um arquivo no computador remoto.
O primeiro comando usa o cmdlet Get-Counter para coletar dados de contador do conjunto de trabalho do Server01, um computador remoto. O comando salva os dados na variável $C.
O segundo comando usa um operador de pipeline (|) para enviar os dados em $C para o cmdlet Export-Counter, que os salva no arquivo Workingset.blg no compartilhamento de Perf 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 Import-Counter e Export-Counter para registrar novamente os dados existentes.
O primeiro comando usa o cmdlet Import-Counter para importar dados do contador de desempenho do log de DiskSpace.blg. Ele salva os dados na variável $All. Esse arquivo contém exemplos do contador "LogicalDisk% Free Space" em mais de 200 computadores remotos na empresa.
O segundo comando usa o cmdlet Where-Object para selecionar objetos com CookedValue inferior a 15 (porcentagem). O comando salva os resultados na variável $LowSpace.
O terceiro comando usa um operador de pipeline (|) para enviar os dados na variável $LowSpace para o cmdlet Export-Counter. O comando usa o parâmetro Path para indicar que os dados selecionados devem ser registrados no arquivo LowDiskSpace.blg.
$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 e sair). Quando você inclui esse parâmetro, o parâmetro MaxSize é necessário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FileFormat
Especifica o formato de saída do arquivo de log de saída.
Os valores aceitáveis para este parâmetro são:
CSVTSVBLG
O valor padrão é BLG.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Substitui e substitui um arquivo existente se houver um no local especificado pelo parâmetro caminho
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 obtém os dados, como o cmdlet Get-Counter ou Import-Counter.
Propriedades do parâmetro
| Tipo: | |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 recentes 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 terminação.
Propriedades do parâmetro
| Tipo: | UInt32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 (Convenção de Nomenclatura Uniforme) para um computador remoto, como \\Computer\Share\file.blg. Este parâmetro é obrigatório.
O formato de arquivo é determinado pelo valor do parâmetro FileFormat, não pela extensão de nome de arquivo no caminho.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
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.
Entradas
PerformanceCounterSampleSet
Você pode redirecionar dados do contador de desempenho de Get-Counter ou Import-Counter para esse cmdlet.
Saídas
None
Observações
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 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.
