Condividi tramite

Export-Counter

  • Riferimento
Modulo:
Microsoft.PowerShell.Diagnostics

Esporta i dati dei contatori delle prestazioni nei file di log.

Sintassi

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

Descrizione

Il Export-Counter cmdlet esporta i dati del contatore delle prestazioni (oggetti PerformanceCounterSampleSet ) nei file di log delle prestazioni binari (.blg), il valore delimitato da virgole (.csv) o il formato con valori delimitati da tabulazioni (.tsv). Questo cmdlet consente di registrare i dati del contatore delle prestazioni.

Il Export-Counter cmdlet è progettato per esportare i dati restituiti dai Get-Counter cmdlet e Import-Counter .

Questo cmdlet viene eseguito solo in Windows 7, Windows Server 2008 R2 e versioni successive di Windows.

Esempio

ESEMPIO 1: Esportare i dati dei contatori in un file

In questo esempio vengono esportati i dati dei contatori in un file BLG.

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

Il comando usa il Get-Counter cmdlet per raccogliere i dati in fase di elaborazione. Usa un operatore pipeline (|) per inviare i dati al Export-Counter cmdlet . Il Export-Counter comando usa la variabile Path per specificare il file di output.

Poiché il set di dati potrebbe essere molto grande, questo esempio invia i dati attraverso Export-Counter la pipeline. Se i dati sono stati salvati in una variabile, è possibile usare una quantità sproporzionata di memoria.

Esempio 2: Esportare un file in un formato di file contatore

In questo esempio viene convertito un file CSV in un formato BLG dati contatore.

Il Import-Counter cmdlet importa i dati del contatore delle prestazioni dal Threads.csv file . Nell'esempio si presuppone che questo file sia stato esportato in precedenza usando il Export-Counter cmdlet . Un operatore pipeline (|) invia i dati importati al Export-Counter cmdlet . Il comando usa il parametro Path per specificare il percorso del file di output. Usa i parametri Circular e MaxSize per indirizzare il Export-Counter cmdlet per creare un log circolare che esegue il wrapping di 1 GB. Il parametro MaxSize è espresso in megabyte.

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

Esempio 3: Recuperare i dati dei contatori da un computer remoto e salvare i dati in un file

Questo esempio mostra come ottenere i dati dei contatori delle prestazioni da un computer remoto e come salvare i dati in un file nel computer remoto.

Il primo comando usa il Get-Counter cmdlet per raccogliere i dati del contatore del working set da Server01, un computer remoto. Il comando salva i dati nella $C variabile.

Il secondo comando usa un operatore pipeline (|) per inviare i dati nel Export-Counter$C cmdlet , che lo salva nel Workingset.blg file nella Perf condivisione del computer Server01.

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Esempio 4: Registrare nuovamente i dati esistenti

In questo esempio viene illustrato come usare i Import-Counter cmdlet e Export-Counter per registrare nuovamente i dati esistenti.

Il primo comando usa il Import-Counter cmdlet per importare i dati del DiskSpace.blg contatore delle prestazioni dal log. Salva i dati nella $All variabile. Questo file contiene esempi del contatore "LogicalDisk% Free Space" su più di 200 computer remoti nell'organizzazione.

Il secondo comando usa il Where-Object cmdlet per selezionare gli oggetti con CookedValue minore di 15 (percentuale). Il comando salva i risultati nella $LowSpace variabile.

Il terzo comando usa un operatore pipeline (|) per inviare i dati nella $LowSpace variabile al Export-Counter cmdlet . Il comando usa il parametro Path per indicare che i dati selezionati devono essere registrati nel LowDiskSpace.blg file.

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

Parametri

-Circular

Indica che il file di output è un log circolare con il formato FIFO (First Out). Quando si include questo parametro, è necessario il parametro MaxSize .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileFormat

Specifica il formato di output del file di log di output.

I valori validi per questo parametro sono:

  • CSV
  • TSV
  • BLG

Il valore predefinito è BLG.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Sovrascrive e sostituisce un file esistente, se presente nel percorso specificato dal parametro Path .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifica, come matrice, i dati del contatore da esportare. Immettere una variabile contenente i dati o un comando che ottiene i dati, ad esempio il Get-Counter cmdlet o Import-Counter .

Type:PerformanceCounterSampleSet[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxSize

Specifica le dimensioni massime del file di output in megabyte (MB).

Se viene specificato il parametro Circular , quando il file di log raggiunge le dimensioni massime specificate, le voci meno recenti vengono eliminate man mano che vengono aggiunte quelle più recenti. Se il parametro Circular non viene specificato, quando il file di log raggiunge la dimensione massima specificata, non vengono aggiunti nuovi dati e il cmdlet genera un errore non irreversibile.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifica il percorso e il nome file del file di output. Immettere un percorso relativo o assoluto nel computer locale o un percorso UNC (Uniform Naming Convention) a un computer remoto, ad esempio \\Computer\Share\file.blg. Questo parametro è obbligatorio.

Il formato del file è determinato dal valore del parametro FileFormat , non dall'estensione del nome file nel percorso.

Type:String
Aliases:PSPath
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

PerformanceCounterSampleSet

È possibile inviare tramite pipe i dati del contatore delle prestazioni da Get-Counter o Import-Counter a questo cmdlet.

Output

None

Note

Il generatore di file di log prevede che tutti gli oggetti di input presentino lo stesso percorso del contatore e che gli oggetti siano disposti in ordine di tempo crescente.

Il tipo e il percorso del contatore del primo oggetto di input determinano le proprietà registrate nel file di log. Se altri oggetti di input non presentano un valore per una proprietà registrata, il campo della proprietà è vuoto. Se gli oggetti hanno valori di proprietà che non sono stati registrati, i valori di proprietà aggiuntivi vengono ignorati.

Monitor prestazioni potrebbe non essere in grado di leggere tutti i log generatiExport-Counter. Ad esempio, Monitor prestazioni richiede che tutti gli oggetti abbiano lo stesso percorso e che tutti gli oggetti siano separati dallo stesso intervallo di tempo.

Il Import-Counter cmdlet non dispone di un parametro ComputerName . Tuttavia, se il computer è configurato per Windows PowerShell windows PowerShell remoto, è possibile usare il Invoke-Command cmdlet per eseguire un Import-Counter comando in un computer remoto.