Il cmdlet Export-Counter accetta gli oggetti PerformanceCounterSampleSet e li esporta come file del registro dei contatori.
Sintassi
Export-Counter [-Path] <string> -InputObject <PerformanceCounterSampleSet[]> [-Circular <switch>] [-FileFormat <string>] [-Force <switch>] [-MaxSize <int>] [<CommonParameters>]
Descrizione
Il cmdlet Export-Counter esporta i dati del contatore delle prestazioni (oggetti PerformanceCounterSampleSet) in file di registro nel formato del registro delle prestazioni binario (blg), nel formato csv (valori delimitati da virgole) o nel formato tsv (valori delimitati da tabulazioni). È possibile utilizzare questo cmdlet per registrare o registrare nuovamente dati del contatore delle prestazioni.
Export-Counter è progettato per esportare dati restituiti dai cmdlet Get-Counter e Import-Counter.
Nota: Export-Counter può essere eseguito solo in Windows 7, Windows Server 2008 R2 e versioni successive di Windows.
Parametri
-Circular <switch>
Indica che il file di output deve essere un registro circolare nel formato FIFO (first in, first out). Quando si include questo parametro, il parametro MaxSize è obbligatorio.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-FileFormat <string>
Specifica il formato di output del file del registro di output. I valori validi sono CSV, TSV e BLG. Il valore predefinito è BLG.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
BLG |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Force <switch>
Sovrascrive e sostituisce un file esistente se ne esiste uno nel percorso specificato dal parametro Path.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-InputObject <PerformanceCounterSampleSet[]>
Specifica i dati del contatore da esportare. Immettere una variabile che contiene i dati o un comando che consenta di ottenere i dati, ad esempio Get-Counter o Import-Counter.
Obbligatorio? |
true |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByValue) |
Accettare caratteri jolly? |
false |
-MaxSize <int>
Specifica la dimensione massima del file di output.
Se viene specificato il parametro Circular, quando il file di registro raggiunge la dimensione massima specificata, le voci meno recenti vengono eliminate man mano che vengono aggiunte quelle più recenti. Se il parametro Circular non è specificato, quando il file di registro raggiunge la dimensione massima specificata, i nuovi dati non vengono aggiunti e il cmdlet genera un errore non fatale.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Path <string>
Specifica il percorso e il nome del file di output. Immettere un percorso relativo o assoluto nel computer locale o un percorso UNC (Uniform Naming Convention) di un computer remoto, ad esempio \\Computer\Share\file.blg. Questo parametro è obbligatorio.
Nota: il formato del file è determinato dal valore del parametro FileFormat, non dall'estensione di file nel percorso.
Obbligatorio? |
true |
Posizione? |
2 |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet È possibile reindirizzare i dati dei contatori delle prestazioni da Get-Counter o Import-Counter a Export-Counter. |
Output |
Nessuno |
Note
Il generatore di file di registro prevede che tutti gli oggetti di input dispongano dello stesso percorso di contatore e che gli oggetti vengono disposti in ordine di tempo crescente.
Il tipo di contatore e il percorso del primo oggetto di input determinano le proprietà registrate nel file di registro. Se altri oggetti di input non dispongono di un valore per una proprietà registrata, il campo della proprietà è vuoto. Se gli oggetti dispongono di valori di proprietà non registrati, i valori aggiuntivi delle proprietà vengono ignorati.
Performance Monitor potrebbe non essere in grado di leggere tutti i registri generati da Export-Counter. Ad esempio, Performance Monitor richiede che tutti gli oggetti dispongano dello stesso percorso e che siano separati dallo stesso intervallo di tempo.
Il cmdlet Import-Counter non dispone di un parametro ComputerName. Tuttavia, se il computer è configurato per la comunicazione remota di Windows PowerShell, è possibile utilizzare il cmdlet Invoke-Command per eseguire un comando Import-Counter in un computer remoto.
Esempio 1
C:\PS># Export-Counter Descrizione ----------- Questo comando esporta i dati dei contatori in un file con estensione blg. Nel comando viene utilizzato il cmdlet Get-Counter per raccogliere dati sul tempo del processore. Viene utilizzato un operatore pipeline (|) per inviare i dati al cmdlet Export-Counter. Il comando Export-Counter utilizza la variabile Path per specificare il file di output. C:\PS> get-counter "\Processor(*)\% Processor Time" -max 50 | export-counter -path $home\counters.blg Poiché il set di dati potrebbe essere di grandi dimensioni, questo comando invia i dati a Export-Counter attraverso la pipeline. Se i dati sono stati salvati in una variabile, il comando potrebbe utilizzare una quantità di memoria sproporzionata.
Esempio 2
C:\PS># Export-Counter Descrizione ----------- Questi comandi convertono un file CSV nel formato BLG dei dati del contatore. Il primo comando utilizza la funzionalità di conversione predefinita di Windows PowerShell per archiviare il valore di 1 gigabtye (GB) in byte nella variabile $1GBinBytes. Quando si digita un valore seguito da K (kilobyte), MB (megabyte) o GB, Windows PowerShell restituisce il valore in byte. C:\PS> $1GBinBytes = 1GB Il secondo comando utilizza il cmdlet Import-Counter per importare i dati del contatore delle prestazioni dal file Threads.csv. Nell'esempio si presume che questo file sia stato precedentemente esportato tramite il cmdlet Export-Counter. Un operatore pipeline (|) invia i dati importati al cmdlet Export-Counter. In questo comando viene utilizzato il parametro Path per specificare la posizione del file di output. Vengono utilizzati i parametri Circular e MaxSize per indicare a Export-Counter di creare un registro circolare che esegua il wrapping a 1 GB. C:\PS> import-counter threads.csv | export-counter -path threadtest.blg -circular -maxsize $1GBinBytes
Esempio 3
C:\PS># Export-Counter Descrizione ----------- In questo esempio viene illustrato come ottenere dati del contatore delle prestazioni da un computer remoto e salvare i dati in un file nel computer remoto. Il primo comando utilizza il cmdlet Get-Counter per raccogliere dati del contatore del working set da Server01, un computer remoto. Il comando salva i dati nella variabile $c. C:\PS> $c = get-counter -computername Server01 -counter "\Process(*)\Working Set - Private" -maxSamples 20 Il secondo comando utilizza un operatore pipeline (|) per inviare i dati in $c al cmdlet Export-Counter che li salva nel file Workingset.blg nella condivisione Perf nel computer Server01. C:\PS> $c | export-counter -path \\Server01\Perf\WorkingSet.blg
Esempio 4
C:\PS># Export-Counter Descrizione ----------- In questo esempio viene illustrato come utilizzare i cmdlet Import-Counter e Export-Counter per registrare nuovamente dati esistenti. Il primo comando utilizza il cmdlet Import-Counter per importare i dati del contatore delle prestazioni dal registro DiskSpace.blg. I dati vengono salvati nella variabile $all. Questo file contiene esempi del contatore "LogicalDisk\% Free Space" in più di 200 computer remoti dell'organizzazione. C:\PS> $all = import-counter DiskSpace.blg Il secondo comando utilizza la proprietà CounterSamples dell'oggetto set di esempi in $all e il cmdlet Where-Object (alias = "where") per selezionare oggetti con valori CookedValues inferiori a 15 (%). I risultati vengono salvati nella variabile $lowSpace. C:\PS> $lowSpace = $all.countersamples | where {$_.cookedvalues -lt 15} Nel terzo comando viene utilizzato un operatore pipeline (|) per inviare i dati nella variabile $lowSpace al cmdlet Export-Counter. Il comando utilizza la variabile path per indicare che i dati selezionati devono essere registrati nel file LowDiskSpace.blg. C:\PS> $lowSpace | export-counter -path LowDiskSpace.blg
Vedere anche