Export-Counter
Exporta dados do contador de desempenho para arquivos de log.
Sintaxe
Default (Predefinição)
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 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.
Exemplos
Exemplo 1: Exportar dados do contador para um arquivo
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
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.
Exemplo 2: Exportar um ficheiro para um formato de ficheiro de contador
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.
Exemplo 3: Obter dados do contador de um computador remoto e salvar os dados em um arquivo
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.
Exemplo 4: Registar novamente os dados existentes
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.
Parâmetros
-Circular
Indica que o arquivo de saída é um log circular com formato FIFO (primeiro a entrar, primeiro a sair). Quando você inclui esse parâmetro, o parâmetro MaxSize é necessário.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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:
- CSV
- TSV
- BLG
O valor padrão é BLG.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | BLG |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Force
Substitui e substitui um arquivo existente se existir no local especificado pelo parâmetro Path.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 ou cmdlet Import-Counter.
Propriedades dos parâmetros
| Tipo: | PerformanceCounterSampleSet[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-MaxSize
Especifica o tamanho máximo do arquivo de saída.
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 dos parâmetros
| Tipo: | UInt32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 canalizar dados do contador de desempenho de Get-Counter ou Import-Counter para este cmdlet.
Saídas
None
Notas
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.