Export-Counter
Aplica-se a: Windows PowerShell 2.0
O cmdlet Export-Counter toma objetos PerformanceCounterSampleSet e os exporta como arquivos de log de contador.
Sintaxe
Export-Counter [-Path] <string> -InputObject <PerformanceCounterSampleSet[]> [-Circular <switch>] [-FileFormat <string>] [-Force <switch>] [-MaxSize <int>] [<CommonParameters>]
Descrição
O cmdlet Export-Counter exporta dados do contador de desempenho (objetos PerformanceCounterSampleSet) para arquivos de log no formato .blg (log de desempenho binário), .csv (valores separados por vírgula) ou .tsv (valores separados por tabulação). Você pode usar este cmdlet para registrar ou registrar novamente dados de contador de desempenho.
Export-Counter foi desenvolvido para exportar dados retornados pelos cmdlets Get-Counter e Import-Counter.
Observação: Export-Counter é executado somente no Windows 7, no Windows Server 2008 R2 e em versões posteriores do Windows.
Parâmetros
-Circular <switch>
Indica que o arquivo de saída deve ser um log circular no formato PEPS (primeiro a entrar, primeiro a sair). Quando você incluir este parâmetro, o parâmetro MaxSize parâmetro será obrigatório.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-FileFormat <string>
Especifica o formato de saída do arquivo de log de saída. Os valores válidos são CSV, TSV e BLG. O valor padrão é BLG.
Necessário? |
false |
Posição? |
named |
Valor padrão |
BLG |
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Force <switch>
Substitui um arquivo existente, se houver um no local especificado pelo parâmetro Path.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-InputObject <PerformanceCounterSampleSet[]>
Especifica os dados de contador para exportação. Insira uma variável que contenha os dados ou um comando que obtenha os dados, como o comando Get-Counter ou Import-Counter.
Necessário? |
true |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue) |
Aceitar caracteres curinga? |
false |
-MaxSize <int>
Especifica o tamanho máximo do arquivo de saída.
Se o parâmetro Circular for especificado, quando o arquivo de log alcançar 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 alcançar o tamanho máximo especificado, nenhum novo dado será adicionado e o cmdlet gerará um erro de não-encerramento.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Path <string>
Especifique o caminho e o nome do arquivo de saída. Insira um caminho relativo ou absoluto no computador local ou um caminho UNC para um computador remoto, como \\Computador\Compartilhamento\arquivo.blg. Esse parâmetro é obrigatório.
Observação: o formato de arquivo é determinado pelo valor do parâmetro FileFormat, não pela extensão de nome de arquivo no caminho.
Necessário? |
true |
Posição? |
2 |
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 |
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet Você pode canalizar dados do contador de desempenho de Get-Counter ou Import-Counter para Export-Counter. |
Saídas |
Nenhum |
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 estejam organizados em ordem crescente de tempo.
O caminho e o tipo de contador 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 da propriedade será vazio. Se os objetos tiverem valores de propriedade que não foram registrados, os valores de propriedade adicionais serão ignorados.
Talvez o Monitor de Desempenho não consiga ler todos os logs gerados por Export-Counter. Por exemplo, o Monitor de Desempenho requer que todos os objetos tenham o mesmo caminho e que sejam separados pelo mesmo intervalo de tempo.
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># Export-Counter
Descrição
-----------
Este 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 dados para o cmdlet Export-Counter. O comando Export-Counter usa a variável Path para especificar o arquivo de saída.
C:\PS> get-counter "\Processador(*)\% tempo de processador" -max 50 | export-counter -path $home\counters.blg
Como o conjunto de dados pode ser muito grande, o comando envia os dados para Export-Counter pelo pipeline. Se os dados tiverem sido salvos em uma variável, o comando poderá usar uma quantidade de memória desproporcional.
Exemplo 2
C:\PS># Export-Counter
Descrição
-----------
Esses comandos convertem um arquivo CSV no formato BLG de dados de um contador.
O primeiro comando usa o recurso de conversão interno do Windows PowerShell para armazenar o valor de 1 GB (gigabyte) em bytes na variável $1GBinBytes. Quando você digitar um valor seguido de K (kilobyte), MB (megabyte) ou GB, o Windows PowerShell retornará o valor em bytes.
C:\PS> $1GBinBytes = 1GB
O segundo comando usa o cmdlet Import-Counter para importar dados do contador de desempenho do arquivo Threads.csv. O exemplo pressupõe que o arquivo foi exportado previamente 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 a localização do arquivo de saída. Ele usa os parâmetros Circular e MaxSize para direcionar o Export-Counter para criar um log circular que é encapsulado quando atinge 1 GB.
C:\PS> import-counter threads.csv | export-counter -path threadtest.blg -circular -maxsize $1GBinBytes
Exemplo 3
C:\PS># Export-Counter
Descrição
-----------
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 de Server01, um computador remoto. O comando salva os dados na variável $c.
C:\PS> $c = get-counter -computername Server01 -counter "\Processo(*)\Conjunto de trabalho - particular" -maxSamples 20
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 Perf do computador Server01.
C:\PS> $c | export-counter -path \\Server01\Perf\WorkingSet.blg
Exemplo 4
C:\PS># Export-Counter
Descrição
-----------
Este exemplo mostra como usar os cmdlets Import-Counter e Export-Counter para registrar novamente dados existentes.
O primeiro comando usa o cmdlet Import-Counter para importar dados do contador de desempenho do log DiskSpace.blg. Ele salva os dados na variável $all. Esse arquivo contém exemplos do contador "LogicalDisk\% de espaço livre" em mais de 200 computadores remotos na empresa.
C:\PS> $all = import-counter DiskSpace.blg
O segundo comando usa a propriedade CounterSamples do objeto do conjunto de exemplos em $all e o cmdlet Where-Object (alias = "where") para selecionar objetos com CookedValues inferiores a 15 (por cento). O comando salva os resultados na variável $lowSpace.
C:\PS> $lowSpace = $all.countersamples | where {$_.cookedvalues -lt 15}
O terceiro comando usa um operador de pipeline (|) para enviar os dados da variável $lowSpace para o cmdlet Export-Counter. O comando usa a variável path para indicar que os dados selecionados devem ser registrados no arquivo LowDiskSpace.blg.
C:\PS> $lowSpace | export-counter -path LowDiskSpace.blg