Export-Counter
Esporta i dati dei contatori delle prestazioni nei file di log.
Sintassi
Default (Impostazione predefinita)
Export-Counter
[-Path] <String>
[-FileFormat <String>]
[-MaxSize <UInt32>]
-InputObject <PerformanceCounterSampleSet[]>
[-Force]
[-Circular]
[<CommonParameters>]
Descrizione
Il cmdlet Export-Counter esporta i dati del contatore delle prestazioni (PerformanceCounterSampleSet oggetti) 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 cmdlet Export-Counter è progettato per esportare i dati restituiti dai cmdlet Get-Counter 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 cmdlet Get-Counter per raccogliere i dati in fase di elaborazione. Usa un operatore pipeline (|) per inviare i dati al cmdlet Export-Counter. Il comando Export-Counter usa la variabile Percorso per specificare il file di output.
Poiché il set di dati potrebbe essere molto grande, questo esempio invia i dati a Export-Counter tramite 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 cmdlet Import-Counter importa i dati del contatore delle prestazioni dal file Threads.csv. Nell'esempio si presuppone che questo file sia stato esportato in precedenza usando il cmdlet Export-Counter. Un operatore pipeline (|) invia i dati importati al cmdlet Export-Counter. Il comando usa il parametro percorso per specificare il percorso del file di output. Usa i parametri Circular e MaxSize per indirizzare il cmdlet Export-Counter per creare un log circolare che esegue il wrapping a 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
In questo esempio viene illustrato come ottenere i dati del contatore delle prestazioni da un computer remoto e salvare i dati in un file nel computer remoto.
Il primo comando usa il cmdlet Get-Counter per raccogliere i dati del contatore del working set da Server01, un computer remoto. Il comando salva i dati nella variabile $C.
Il secondo comando usa un operatore pipeline (|) per inviare i dati in $C al cmdlet Export-Counter, che lo salva nel file Workingset.blg nella condivisione Perf 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 cmdlet Import-Counter e Export-Counter per registrare nuovamente i dati esistenti.
Il primo comando usa il cmdlet Import-Counter per importare i dati del contatore delle prestazioni dal log DiskSpace.blg. Salva i dati nella variabile $All. Questo file contiene esempi del contatore "LogicalDisk% Free Space" su più di 200 computer remoti dell'organizzazione.
Il secondo comando usa il cmdlet Where-Object per selezionare gli oggetti con CookedValue minore di 15 (percentuale). Il comando salva i risultati nella variabile $LowSpace.
Il terzo comando usa un operatore pipeline (|) per inviare i dati nella variabile $LowSpace al cmdlet Export-Counter. Il comando usa il parametro Path per indicare che i dati selezionati devono essere registrati nel file LowDiskSpace.blg.
$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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-FileFormat
Specifica il formato di output del file di log di output.
I valori accettabili per questo parametro sono:
CSVTSVBLG
Il valore predefinito è BLG.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Sovrascrive e sostituisce un file esistente se ne esiste uno nel percorso specificato dal parametro Path.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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 cmdlet Get-Counter o Import-Counter.
Proprietà dei parametri
| Tipo: | |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MaxSize
Specifica le dimensioni massime del file di output in megabyte (MB).
Se viene specificato il parametro circolare, 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 circolare non viene specificato, quando il file di log raggiunge le dimensioni massime specificate, non vengono aggiunti nuovi dati e il cmdlet genera un errore non irreversibile.
Proprietà dei parametri
| Tipo: | UInt32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PSPath |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
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 abbiano lo stesso percorso del contatore e che gli oggetti siano disposti in ordine cronologico crescente.
Il tipo di contatore e il percorso del primo oggetto di input determinano le proprietà registrate nel file di log. Se altri oggetti di input non hanno un valore per una proprietà registrata, il campo della proprietà è vuoto. Se gli oggetti hanno valori di proprietà non registrati, i valori delle proprietà aggiuntivi vengono ignorati.
Performance Monitor potrebbe non essere in grado di leggere tutti i log generati Export-Counter. Ad esempio, Performance Monitor richiede che tutti gli oggetti abbiano lo stesso percorso e che tutti gli oggetti siano separati dallo stesso intervallo di tempo.
Il cmdlet Import-Counter non dispone di un parametro ComputerName. Tuttavia, se il computer è configurato per Windows PowerShell windows PowerShell remoto, è possibile usare il cmdlet Invoke-Command per eseguire un comando Import-Counter in un computer remoto.
