Export-Counter
A teljesítményszámláló adatait naplófájlba exportálja.
Syntax
Default (Alapértelmezett)
Export-Counter
[-Path] <String>
[-FileFormat <String>]
[-MaxSize <UInt32>]
-InputObject <PerformanceCounterSampleSet[]>
[-Force]
[-Circular]
[<CommonParameters>]
Description
Az Export-Counter parancsmag a teljesítményszámláló adatait (PerformanceCounterSampleSet objektumokat) bináris teljesítménynaplóban (.blg), vesszővel tagolt értékben (.csv) vagy tabulátorral elválasztott (.tsv) formátumban exportálja a naplófájlba. Ezzel a parancsmaggal naplózhatja a teljesítményszámláló adatait.
Az Export-Counter parancsmag a Get-Counter és Import-Counter parancsmagok által visszaadott adatok exportálására szolgál.
Ez a parancsmag csak a Windows 7, a Windows Server 2008 R2 és a Windows újabb verzióiban fut.
Példák
1. példa: Számlálóadatok exportálása fájlba
PS C:\> Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $home\Counters.blg
Ez a parancs exportálja a számlálóadatokat egy BLG-fájlba.
A parancs a Get-Counter parancsmaggal gyűjti össze a processzoridő adatait. Egy folyamatkezelő (|) használatával küldi el az adatokat a Export-Counter parancsmagnak. Az Export-Counter parancs a Elérési út változót használja a kimeneti fájl megadásához.
Mivel az adathalmaz nagyon nagy lehet, ez a parancs elküldi az adatokat Exportálásszámláló a folyamaton keresztül. Ha az adatok egy változóba lettek mentve, a parancs aránytalan mennyiségű memóriát használhat.
2. példa: Fájl exportálása számlálófájlformátumba
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
Ez a példa átalakít egy CSV-fájlt számlálóadatok BLG-formátumává.
3. példa: Számlálóadatok lekérése távoli számítógépről, és adatok mentése fájlba
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
Ez a példa bemutatja, hogyan kérhet le teljesítményszámláló adatokat egy távoli számítógépről, és hogyan mentheti az adatokat egy fájlba a távoli számítógépen.
4. példa: Meglévő adatok újbóli naplózása
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
Ez a példa bemutatja, hogyan használhatja a Import-Counter és Export-Counter parancsmagokat a meglévő adatok újbóli naplózásához.
Paraméterek
-Circular
Azt jelzi, hogy a kimeneti fájl egy körkörös napló, elsőként kifelé (FIFO) formátummal. Ha ezt a paramétert használja, a MaxSize paraméterre van szükség.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-FileFormat
Megadja a kimeneti naplófájl kimeneti formátumát.
A paraméter elfogadható értékei a következők:
- CSV
- TSV
- BLG
Az alapértelmezett érték a BLG.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | BLG |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Felülírja és lecseréli a meglévő fájlt, ha az Elérési út paraméter által megadott helyen található.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InputObject
Tömbként megadja az exportálandó számlálóadatokat. Adjon meg egy változót, amely tartalmazza az adatokat, vagy egy olyan parancsot, amely lekéri az adatokat, például a Get-Counter vagy Import-Counter parancsmagot.
Paramétertulajdonságok
| Típus: | PerformanceCounterSampleSet[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-MaxSize
A kimeneti fájl maximális méretét adja meg.
Ha a Körkörös paraméter van megadva, akkor amikor a naplófájl eléri a megadott maximális méretet, a rendszer az újabbak hozzáadásakor törli a legrégebbi bejegyzéseket. Ha a körkörös paraméter nincs megadva, akkor amikor a naplófájl eléri a megadott maximális méretet, a rendszer nem ad hozzá új adatokat, és a parancsmag nem végződő hibát okoz.
Paramétertulajdonságok
| Típus: | UInt32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Path
Megadja a kimeneti fájl elérési útját és fájlnevét. Adjon meg egy relatív vagy abszolút elérési utat a helyi számítógépen, vagy adjon meg egy egységes elnevezési konvenciós (UNC) elérési utat egy távoli számítógéphez, például \\Computer\Share\file.blg. Ez a paraméter kötelező.
A fájlformátumot a FileFormat paraméter értéke határozza meg, nem pedig az elérési út fájlnévkiterjesztése.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | PSPath |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PerformanceCounterSampleSet
Ehhez a parancsmaghoz Get-Counter vagy Import-Counter adhatja meg a teljesítményszámláló adatait.
Kimenetek
None
Jegyzetek
A naplófájlgenerátor arra számít, hogy minden bemeneti objektumnak ugyanaz a számlálóútvonala, és hogy az objektumok növekvő időrendben vannak elrendezve.
Az első bemeneti objektum számlálótípusa és elérési útja határozza meg a naplófájlban rögzített tulajdonságokat. Ha más bemeneti objektumok nem rendelkeznek rögzített tulajdonság értékével, a tulajdonságmező üres. Ha az objektumok nem rögzített tulajdonságértékekkel rendelkeznek, a rendszer figyelmen kívül hagyja a további tulajdonságértékeket.
Előfordulhat, hogy a Teljesítményfigyelő nem tudja beolvasni az összes naplót, amelyet Exportálásszámláló generál. A Teljesítményfigyelő például megköveteli, hogy minden objektum elérési útja azonos legyen, és az összes objektumot azonos időintervallum választja el egymástól.
Az Import-Counter parancsmag nem rendelkezik ComputerName paraméterrel. Ha azonban a számítógép a távoli Windows PowerShell Windows PowerShellhez van konfigurálva, a Invoke-Command parancsmaggal futtathat egy Import-Counter parancsot egy távoli számítógépen.