Partager via

Import-Counter

  • Référence
Module:
Microsoft.PowerShell.Diagnostics

Importe les fichiers journaux des compteurs de performances et crée les objets qui représentent chaque exemple de compteur dans le journal.

Syntaxe

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

Description

L’applet Import-Counter de commande importe les données du compteur de performances à partir des fichiers journaux des compteurs de performances et crée des objets pour chaque exemple de compteur dans le fichier. Les objets PerformanceCounterSampleSet qu’il crée sont identiques aux objets qui Get-Counter retournent lorsqu’ils collectent des données de compteur de performances.

Vous pouvez importer des données à partir de valeurs séparées par des virgules (.csv), de valeurs séparées par des tabulations (.tsv) et de fichiers journaux de performances binaires (.blg). Si vous utilisez .blg des fichiers, vous pouvez importer jusqu’à 32 fichiers dans chaque commande. Vous pouvez utiliser les paramètres de Import-Counter filtre des données que vous importez.

Outre les applets de commande et Export-Counter les Get-Counter applets de commande, cette fonctionnalité vous permet de collecter, d’exporter, d’importer, de combiner, de filtrer, de manipuler et de réexporter les données du compteur de performances dans Windows PowerShell.

Exemples

Exemple 1 : Importer toutes les données de compteur à partir d’un fichier

$data = Import-Counter -Path ProcessorData.csv

Cette commande importe toutes les données de compteur du ProcessorData.csv fichier dans la $data variable.

Exemple 2 : Importer des données de compteur spécifiques à partir d’un fichier

$i = Import-Counter -Path "ProcessorData.blg" -Counter "\\SERVER01\Processor(_Total)\Interrupts/sec"

Cette commande importe uniquement les données de compteur « Processor(_total)\Interrupts/sec » du ProcessorData.blg fichier dans la $i variable.

Exemple 3 : Sélectionner des données à partir d’un compteur de performances, puis les exporter vers un fichier

Cet exemple montre comment sélectionner des données à partir d’un fichier journal du compteur de performances (.blg), puis exporter les données sélectionnées dans un .csv fichier. Les quatre premières commandes obtiennent les chemins du compteur à partir du fichier et les enregistrent dans la variable nommée $data. Au cours des deux dernières commandes, les données sélectionnées sont importées, puis exportées.

$data = Import-Counter .\ProcessorData.blg
$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

$intCtrs = $Data[0].Countersamples | Where-Object {$_.Path -like "*Interrupts/sec"} | ForEach-Object {$_.Path}
$intCtrs

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

$i = Import-Counter -Path .\ProcessorData.blg -Counter $intCtrs
$i | Export-Counter -Path .\Interrupts.csv -Format CSV

La première commande utilise Import-Counter pour importer toutes les données du compteur de performances à partir des ProcessorData.blg fichiers. La commande enregistre les données dans la $data variable.

La deuxième commande affiche les chemins d’accès du compteur dans la $data variable. Pour obtenir l’affichage affiché dans la sortie de commande, l’exemple utilise l’applet Format-Table de commande pour mettre en forme en tant que tableau les chemins de compteur du premier compteur dans la $data variable.

La troisième commande obtient les chemins d’accès du compteur qui se Interrupts/sec terminent et enregistrent les chemins d’accès dans la $intCtrs variable. Il utilise l’applet Where-Object de commande pour filtrer les chemins de compteur et l’applet ForEach-Object de commande pour obtenir uniquement la valeur de la propriété Path de chaque objet path sélectionné.

La quatrième commande affiche les chemins de compteur sélectionnés dans la $intCtrs variable.

La cinquième commande utilise l’applet Import-Counter de commande pour importer les données. Elle utilise la $intCtrs variable comme valeur du paramètre Counter pour importer uniquement des données pour les chemins de compteur dans $intCtrs.

La sixième commande utilise l’applet Export-Counter de commande pour exporter les données dans le Interrupts.csv fichier.

Exemple 4 : Afficher tous les chemins d’accès des compteurs dans un groupe de jeux de compteurs importés

Cet exemple montre comment afficher tous les chemins de compteur dans un groupe d'ensembles de compteurs importés.

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...}

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

La première commande utilise le paramètre ListSet de l’applet Import-Counter de commande pour obtenir tous les jeux de compteurs représentés dans un fichier de données de compteur.

La deuxième commande obtient tous les chemins d’accès du compteur de l’ensemble de listes.

Exemple 5 : Importer des données de compteur à partir d’une plage d’horodatages

Cet exemple importe uniquement les données de compteur qui ont un horodatage entre les plages de fin spécifiées dans la commande.

Import-Counter -Path ".\disk.blg" | Format-Table -Property Timestamp
$start = [datetime]"7/9/2008 3:47:00 PM"; $end = [datetime]"7/9/2008 3:47:59 PM"
Import-Counter -Path Disk.blg -StartTime $start -EndTime $end

La première commande répertorie dans une table les horodatages de toutes les données du ProcessorData.blg fichier.

La deuxième commande enregistre des horodatages particuliers dans les variables et $end les $start variables. Les chaînes sont converties en objets DateTime .

La troisième commande utilise l’applet Import-Counter de commande pour obtenir uniquement les données de compteur qui ont un horodatage entre les heures de début et de fin (inclusives). La commande utilise les paramètres StartTime et EndTime de Import-Counter pour spécifier la plage.

Exemple 6 : Importer un nombre spécifié d’échantillons les plus anciens à partir d’un fichier journal du compteur de performances

Cet exemple montre comment importer les cinq échantillons les plus anciens et les cinq les plus récents d'un fichier journal de compteurs de performances.

Import-Counter -Path "Disk.blg" -MaxSamples 5
(Import-Counter -Path Disk.blg)[-1 .. -5]

La première commande utilise l’applet Import-Counter de commande pour importer les cinq premiers exemples (les plus anciens) à partir du Disk.blg fichier. La commande utilise le paramètre MaxSamples pour limiter l’importation à cinq exemples de compteurs.

La deuxième commande utilise la notation de tableau et l’opérateur de plage Windows PowerShell (..) pour obtenir les cinq derniers exemples de compteurs du fichier. Il s’agit des cinq échantillons les plus récents.

Exemple 7 : Obtenir un résumé des données de compteur à partir d’un fichier

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

Cette commande utilise le paramètre Summary de l’applet Import-Counter de commande pour obtenir un résumé des données du compteur dans le Memory.blg fichier.

Exemple 8 : Mettre à jour un fichier journal du compteur de performances

Cet exemple met à jour un fichier journal de compteurs de performances.

$counters = Import-Counter OldData.blg -ListSet * | ForEach-Object {$_.PathsWithInstances}
Get-Counter -Counter $Counters -MaxSamples 20 | Export-Counter C:\Logs\NewData.blg

La première commande utilise le paramètre ListSet pour Import-Counter obtenir les compteurs dans OldData.blg, un fichier journal de compteur existant. La commande utilise un opérateur de pipeline (|) pour envoyer les données à une ForEach-Object commande qui obtient uniquement les valeurs de la propriété PathsWithInstances de chaque objet

La deuxième commande obtient des données mises à jour pour les compteurs de la $counters variable. Il utilise l’applet Get-Counter de commande pour obtenir un exemple actuel, puis exportez les résultats dans le NewData.blg fichier.

Exemple 9 : Importer des données du journal des performances à partir de plusieurs fichiers, puis l’enregistrer

$counters = "D:\test\pdata.blg", "D:\samples\netlog.blg" | Import-Counter

Cette commande importe les données du journal des performances à partir de deux journaux et enregistre les données dans la $counters variable. Cette commande utilise un opérateur pipeline pour envoyer les chemins d'accès des journaux de performances à Import-Counter, qui importe les données à partir des chemins d'accès spécifiés.

Notez que chaque chemin d'accès est placé entre guillemets et que les chemins d'accès sont séparés par une virgule.

Paramètres

-Counter

Spécifie, en tant que tableau de chaînes, les compteurs de performances. Par défaut, Import-Counter importe toutes les données de tous les compteurs dans les fichiers d’entrée. Entrez un ou plusieurs chemins de compteur. Les caractères génériques sont autorisés dans la partie Instance du chemin d'accès.

Chaque chemin de compteur a le format ci-après. La ComputerName valeur est requise dans le chemin d’accès. Exemple :

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

Par exemple :

  • \\Server01\Processor(2)\% User Time
  • \\Server01\Processor(*)\% Processor Time
Type:String[]
Position:Named
Valeur par défaut:All counter
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-EndTime

Spécifie une date et une heure de fin que cette applet de commande importe les données de compteur entre StartTime et ce horodatage de paramètre. Entrez un objet DateTime , tel qu’un objet créé par l’applet de Get-Date commande. Par défaut, Import-Counter importe toutes les données de compteur dans les fichiers spécifiés par le paramètre Path .

Type:DateTime
Position:Named
Valeur par défaut:No end time
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ListSet

Spécifie les jeux de compteurs de performances représentés dans les fichiers exportés. Les commandes contenant ce paramètre n'importent pas de données.

Entrez un ou plusieurs noms d'ensemble de compteurs. Les caractères génériques sont autorisés. Pour obtenir tous les jeux de compteurs dans le fichier, tapez Import-Counter -ListSet *.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-MaxSamples

Spécifie le nombre maximal d'échantillons de chaque compteur à importer. Par défaut, Get-Counter importe toutes les données dans les fichiers spécifiés par le paramètre Path .

Type:Int64
Position:Named
Valeur par défaut:No maximum
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie les chemins d'accès des fichiers à importer. Ce paramètre est obligatoire.

Entrez le chemin d’accès et le nom de fichier d’un, .csvou .tsv.blg fichier que vous avez exportés à l’aide de l’applet Export-Counter de commande. Vous ne pouvez spécifier qu’un .csv seul ou .tsv fichier, mais vous pouvez spécifier plusieurs .blg fichiers (jusqu’à 32) dans chaque commande. Vous pouvez également diriger des chaînes de chemin d’accès de fichier (entre guillemets) vers Import-Counter.

Type:String[]
Alias:PSPath
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-StartTime

Spécifie la date et l’heure de début dans lesquelles cette applet de commande obtient les données de compteur. Entrez un objet DateTime , tel qu’un objet créé par l’applet de Get-Date commande. Par défaut, Import-Counter importe toutes les données de compteur dans les fichiers spécifiés par le paramètre Path .

Type:DateTime
Position:Named
Valeur par défaut:No start time
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Summary

Indique que cette applet de commande obtient un résumé des données importées, au lieu d’obtenir des exemples de données de compteur individuels.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger les chemins du journal des compteurs de performances vers cette applet de commande.

Sorties

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

Cette applet de commande retourne un Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Si vous utilisez le paramètre ListSet , cette applet de commande renvoie un objet Microsoft.PowerShell.Commands.GetCounter.CounterSet . Si vous utilisez le paramètre Summary , cette applet de commande renvoie un objet Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo .

Notes

  • Cette applet de commande n’a pas de paramètre ComputerName . Toutefois, si l’ordinateur est configuré pour la communication à distance Windows PowerShell, vous pouvez utiliser l’applet Invoke-Command de commande pour exécuter une Import-Counter commande sur un ordinateur distant.