Import-Counter

Modul:

Microsoft.PowerShell.Diagnostics Module

Importálja a teljesítményszámláló naplófájljait, és létrehozza a naplóban szereplő egyes számlálómintákat képviselő objektumokat.

Syntax

GetCounterSet (Alapértelmezett)

Import-Counter
    [-Path] <String[]>
    [-StartTime <DateTime>]
    [-EndTime <DateTime>]
    [-Counter <String[]>]
    [-MaxSamples <Int64>]
    [<CommonParameters>]

ListSetSet

Import-Counter
    [-Path] <String[]>
    -ListSet <String[]>
    [<CommonParameters>]

SummarySet

Import-Counter
    [-Path] <String[]>
    [-Summary]
    [<CommonParameters>]

Description

A Import-Counter parancsmag teljesítményszámláló-adatokat importál a teljesítményszámláló naplófájljaiból, és objektumokat hoz létre a fájl minden számlálómintájához. A PerformanceCounterSampleSet által létrehozott objektumok megegyeznek azokkal az objektumokkal, amelyeket Get-Counter a teljesítményszámláló adatainak gyűjtésekor ad vissza.

Adatokat importálhat vesszővel tagolt értékből (.csv), tabulátorral tagolt értékből ( .tsv) és bináris teljesítménynaplóból (.blg) teljesítménynapló-fájlokból. Ha .blg fájlokat használ, az egyes parancsokban legfeljebb 32 fájlt importálhat. Az importált adatok szűréséhez használhatja Importálásszámláló paramétereit.

A Get-Counter és a Export-Counter parancsmagok mellett ez a funkció lehetővé teszi a teljesítményszámláló adatainak gyűjtését, exportálását, importálását, összevonását, szűrését, manipulálására és újraexportálására a Windows PowerShellben.

Példák

1. példa: Az összes számláló adatainak importálása egy fájlból

$Data = Import-Counter -Path ProcessorData.csv

Ez a parancs a ProcessorData.csv fájl összes számlálóadatait a $Data változóba importálja.

2. példa: Adott számlálóadatok importálása fájlból

PS C:\> $I = Import-Counter -Path "ProcessorData.blg" -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"

Ez a parancs csak a "Processor(_total)\Interrupts/sec" számlálóadatokat importálja a ProcessorData.blg fájlból a $I változóba.

3. példa: Adatok kijelölése teljesítményszámlálóból, majd exportálás fájlba

The first command uses **Import-Counter** to import all of the performance counter data from the ProcessorData.blg files. The command saves the data in the $Data variable.
PS C:\> $Data = Import-Counter .\ProcessorData.blg

The second command displays the counter paths in the $Data variable. To get the display shown in the command output, the example uses the Format-Table cmdlet to format as a table the counter paths of the first counter in the $Data variable.
PS C:\> $Data[0].CounterSamples | Format-Table -Property Path

Path
----
\\SERVER01\Processor(_Total)\DPC Rate
\\SERVER01\Processor(1)\DPC Rate
\\SERVER01\Processor(0)\DPC Rate
\\SERVER01\Processor(_Total)\% Idle Time
\\SERVER01\Processor(1)\% Idle Time
\\SERVER01\Processor(0)\% Idle Time
\\SERVER01\Processor(_Total)\% C3 Time
\\SERVER01\Processor(1)\% C3 Time

The third command gets the counter paths that end in "Interrupts/sec" and saves the paths in the $IntCtrs variable. It uses the Where-Object cmdlet to filter the counter paths and the ForEach-Object cmdlet to get only the value of the **Path** property of each selected path object.
PS C:\> $IntCtrs = $Data[0].Countersamples | Where-Object {$_.Path -like "*Interrupts/sec"} | ForEach-Object {$_.Path}

The fourth command displays the selected counter paths in the $IntCtrs variable.
PS C:\> $IntCtrs

\\SERVER01\Processor(_Total)\Interrupts/sec
\\SERVER01\Processor(1)\Interrupts/sec
\\SERVER01\Processor(0)\Interrupts/sec

The fifth command uses the **Import-Counter** cmdlet to import the data. It uses the $IntCtrs variable as the value of the *Counter* parameter to import only data for the counter paths in $IntCtrs.
PS C:\> $I = Import-Counter -Path .\ProcessorData.blg -Counter $intCtrs

The sixth command uses the Export-Counter cmdlet to export the data to the Interrupts.csv file.
PS C:\> $I | Export-Counter -Path .\Interrupts.csv -Format CSV

Ez a példa bemutatja, hogyan választhat ki adatokat a teljesítményszámláló naplófájljából (.blg), majd exportálhatja a kijelölt adatokat egy .csv fájlba. Az első négy parancs lekéri a számláló elérési útját a fájlból, és menti őket a $Data nevű változóba. Az utolsó két parancs importálja a kijelölt adatokat, majd csak a kijelölt adatokat exportálja.

4. példa: Az összes számlálóútvonal megjelenítése importált számlálókészletek csoportjában

The first command uses the *ListSet* parameter of the **Import-Counter** cmdlet to get all of the counter sets that are represented in a counter data file.
PS C:\> Import-Counter -Path ProcessorData.csv -ListSet *

CounterSetName     : Processor
MachineName        : \\SERVER01
CounterSetType     : MultiInstance
Description        :
Paths              : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}
PathsWithInstances : {\\SERVER01\Processor(_Total)\DPC Rate, \\SERVER01\Processor(1)\DPC Rate, \\SERVER01
\Processor(0)\DPC Rate, \\SERVER01\Processor(_Total)\% Idle Time...}
Counter            : {\\SERVER01\Processor(*)\DPC Rate, \\SERVER01\Processor(*)\% Idle Time, \\SERVER01
\Processor(*)\% C3 Time, \\SERVER01\Processor(*)\% Interrupt Time...}

The second command gets all of the counter paths from the list set.
PS C:\> Import-Counter -Path ProcessorData.csv -ListSet * | ForEach-Object {$_.Paths}

\\SERVER01\Processor(*)\DPC Rate
\\SERVER01\Processor(*)\% Idle Time
\\SERVER01\Processor(*)\% C3 Time
\\SERVER01\Processor(*)\% Interrupt Time
\\SERVER01\Processor(*)\% C2 Time
\\SERVER01\Processor(*)\% User Time
\\SERVER01\Processor(*)\% C1 Time
\\SERVER01\Processor(*)\% Processor Time
\\SERVER01\Processor(*)\C1 Transitions/sec
\\SERVER01\Processor(*)\% DPC Time
\\SERVER01\Processor(*)\C2 Transitions/sec
\\SERVER01\Processor(*)\% Privileged Time
\\SERVER01\Processor(*)\C3 Transitions/sec
\\SERVER01\Processor(*)\DPCs Queued/sec
\\SERVER01\Processor(*)\Interrupts/sec

Ez a példa bemutatja, hogyan jelenítheti meg az összes számláló elérési útját az importált számlálókészletek csoportjában.

5. példa: Számlálóadatok importálása időbélyegek tartományából

The first command lists in a table the time stamps of all of the data in the ProcessorData.blg file.
PS C:\> Import-Counter -Path ".\disk.blg" | Format-Table -Property Timestamp

The second command saves particular time stamps in the $Start and $End variables. The strings are cast to **DateTime** objects.
PS C:\> $Start = [datetime]"7/9/2008 3:47:00 PM"; $End = [datetime]"7/9/2008 3:47:59 PM"

The third command uses the **Import-Counter** cmdlet to get only counter data that has a time stamp between the start and end times (inclusive). The command uses the *StartTime* and *EndTime* parameters of **Import-Counter** to specify the range.
PS C:\> Import-Counter -Path Disk.blg -StartTime $start -EndTime $end

Ez a példa csak azokat a számlálóadatokat importálja, amelyek időbélyeggel vannak elosztva a parancsban megadott kezdőtartományok között.

6. példa: A legrégebbi minták megadott számának importálása teljesítményszámláló naplófájlból

The first command uses the **Import-Counter** cmdlet to import the first (oldest) five samples from the Disk.blg file. The command uses the *MaxSamples* parameter to limit the import to five counter samples.
PS C:\> Import-Counter -Path "Disk.blg" -MaxSamples 5

The second command uses array notation and the Windows PowerShell range operator (..) to get the last five counter samples from the file. These are the five newest samples.
PS C:\> (Import-Counter -Path Disk.blg)[-1 .. -5]

Ez a példa bemutatja, hogyan importálhatja az öt legrégebbi és öt legújabb mintát egy teljesítményszámláló naplófájljából.

7. példa: Számlálóadatok összegzésének lekérése fájlból

PS C:\> Import-Counter "D:\Samples\Memory.blg" -Summary

OldestRecord            NewestRecord            SampleCount
------------            ------------            -----------
7/10/2008 2:59:18 PM    7/10/2008 3:00:27 PM    1000

Ez a parancs a Import-Counter parancsmag Summary paraméterét használja a számlálóadatok összegzésének lekéréséhez a Memory.blg fájlban.

8. példa: Teljesítményszámláló naplófájljának frissítése

The first command uses the *ListSet* parameter of **Import-Counter** to get the counters in OldData.blg, an existing counter log file. The command uses a pipeline operator (|) to send the data to a ForEach-Object command that gets only the values of the **PathsWithInstances** property of each object
PS C:\> $Counters = Import-Counter OldData.blg -ListSet * | ForEach-Object {$_.PathsWithInstances}

The second command gets updated data for the counters in the $Counters variable. It uses the Get-Counter cmdlet to get a current sample, and then export the results to the NewData.blg file.
PS C:\> Get-Counter -Counter $Counters -MaxSamples 20 | Export-Counter C:\Logs\NewData.blg

Ez a példa frissít egy teljesítményszámláló naplófájlt.

9. példa: Teljesítménynapló adatainak importálása több fájlból, majd mentése

PS C:\> $Counters = "D:\test\pdata.blg", "D:\samples\netlog.blg" | Import-Counter

Ez a parancs két naplóból importálja a teljesítménynapló adatait, és menti az adatokat a $Counters változóba. A parancs egy folyamatkezelővel küldi el a teljesítménynapló elérési útjait az Import-Counter fájlba, amely a megadott elérési utakról importálja az adatokat.

Figyelje meg, hogy minden elérési út idézőjelek közé van zárva, és az útvonalakat vessző választja el egymástól.

Paraméterek

-Counter

Karakterlánctömbként megadja a teljesítményszámlálókat. Alapértelmezés szerint Importálásszámláló importálja az összes adatot a bemeneti fájlok összes számlálójából. Adjon meg egy vagy több számlálóútvonalat. A helyettesítő karakterek az elérési út Példány részében engedélyezettek.

Minden számláló elérési útja a következő formátumú. Az elérési úton a ComputerName érték megadása kötelező. Például:

• \\<ComputerName>\<CounterSet>(<Instance>)\<CounterName>

Például:

• \\Server01\Processor(2)\% User Time
• \\Server01\Processor(*)\% Processor Time

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	All counter
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

GetCounterSet

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

-EndTime

Megadja azt a befejezési dátumot és időt, amelyet ez a parancsmag számlálóadatokat importál a StartTime és ez a paraméter időbélyegei között. Adjon meg egy DateTime objektumot, például a Get-Date parancsmag által létrehozott objektumot. Alapértelmezés szerint Import-Counter importálja az összes számlálóadatot a Elérési út paraméter által megadott fájlokban.

Paramétertulajdonságok

Típus:	DateTime
Alapértelmezett érték:	No end time
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetCounterSet

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

-ListSet

Megadja az exportált fájlokban megjelenített teljesítményszámláló-csoportokat. Az ezzel a paraméterrel rendelkező parancsok nem importálnak adatokat.

Adjon meg egy vagy több számlálókészletnevet. Helyettesítő karakterek használata engedélyezett. A fájl összes számlálókészletének lekéréséhez írja be a Import-Counter -ListSet *.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

ListSetSet

Position:	Named
Kötelező:	True
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

-MaxSamples

Az importálandó számlálók maximális számát adja meg. Alapértelmezés szerint Get-Counter importálja az összes adatot a Elérési út paraméter által megadott fájlokban.

Paramétertulajdonságok

Típus:	Int64
Alapértelmezett érték:	No maximum
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetCounterSet

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 az importálandó fájlok elérési útját. Ez a paraméter kötelező.

Adja meg a Export-Counter parancsmaggal exportált, .csv,, .tsv vagy .blg fájl elérési útját és fájlnevét. Csak egy .csv vagy .tsv fájlt adhat meg, de minden parancsban több .blg fájlt is megadhat (legfeljebb 32). Az import-counterfájlútvonal-sztringeket (idézőjelekkel) is beszúrhatja.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False
Aliasok:	PSPath

Paraméterkészletek

(All)

Position:	0
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

-StartTime

Azt a kezdő dátumot és időpontot adja meg, amelyben ez a parancsmag számlálóadatokat kap. Adjon meg egy DateTime objektumot, például a Get-Date parancsmag által létrehozott objektumot. Alapértelmezés szerint Import-Counter importálja az összes számlálóadatot a Elérési út paraméter által megadott fájlokban.

Paramétertulajdonságok

Típus:	DateTime
Alapértelmezett érték:	No start time
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetCounterSet

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

-Summary

Azt jelzi, hogy ez a parancsmag az importált adatok összegzését kapja meg ahelyett, hogy egyéni számlálóadat-mintákat kérne le.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SummarySet

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

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

String

Ehhez a parancsmaghoz a teljesítményszámláló naplóútvonalait is be lehet csövezni.

Kimenetek

Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo

Ez a parancsmag egy Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSetad vissza. Ha a ListSet paramétert használja, ez a parancsmag egy Microsoft.PowerShell.Commands.GetCounter.CounterSet objektumot ad vissza. Ha a Summary paramétert használja, ez a parancsmag egy Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo objektumot ad vissza.

Jegyzetek

• Ez a parancsmag nem rendelkezik ComputerName paraméterrel. Ha azonban a számítógép windowsos PowerShell-újraküldésre van konfigurálva, a Invoke-Command parancsmaggal futtathat egy Importálásszámláló parancsot egy távoli számítógépen.

Kapcsolódó hivatkozások

• Export-Counter
• Get-Counter