Importe des fichiers journaux de compteur de performance (.blg, .csv, .tsv) et crée les objets qui représentent chaque échantillon de compteur dans le journal.

Syntaxe

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

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

Import-Counter [-Path] <string[]> -Résumé <switch> [<CommonParameters>]

Description

L'applet de commande Import-Counter importe des données de compteur de performance à partir de fichiers journaux de compteur de performance et crée des objets pour chaque échantillon de compteur dans le fichier. Les objets PerformanceCounterSampleSet qu'elle crée sont identiques aux objets que Get-Counter retourne lorsqu'elle collecte des données de compteur de performance.

Vous pouvez importer des données à partir de fichiers journaux de performance binaires (.blg), dont les valeurs sont séparées par des virgules (.csv) ou séparées par des tabulations (.tsv). Si vous utilisez des fichiers .blg, vous pouvez importer plusieurs fichiers (jusqu'à 32 fichiers différents) dans chaque commande. De même, vous pouvez utiliser les paramètres d'Import-Counter pour filtrer les données que vous importez.

Avec Get-Counter et Export-Counter, cette fonctionnalité vous permet de collecter, exporter, importer, combiner, filtrer, manipuler et réexporter des données de compteur de performance au sein de Windows PowerShell.

Paramètres

-Counter <string[]>

Importe des données uniquement pour les compteurs de performance spécifiés. Par défaut, Import-Counter importe toutes les données à partir de tous les compteurs dans les fichiers d'entrée. Entrez un ou plusieurs chemins d'accès de compteurs. Les caractères génériques sont autorisés dans la partie Instance du chemin d'accès.

Chaque chemin d'accès de compteur présente la forme ci-dessous. Remarquez que la valeur NomOrdinateur est obligatoire dans le chemin d'accès, même sur l'ordinateur local.

"\\<NomOrdinateur>\<EnsembleCompteurs>(<Instance>)\<NomCompteur>"

Par exemple :

"\\Server01\Processor(2)\% User Time"

"\Processor(*)\% Processor Time

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

true

-EndTime <DateTime>

Importe uniquement les données de compteur avec un horodatage inférieur ou égal aux date et heure spécifiées. Entrez un objet DateTime, tel qu'un objet créé par l'applet de commande Get-Date. Par défaut, Import-Counter importe toutes les données de compteur dans les fichiers spécifiés par le paramètre Path.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ListSet <string[]>

Obtient les ensembles de compteurs de performance représentés dans les fichiers exportés. Les commandes avec ce paramètre n'importent pas de données.

Entrez un ou plusieurs noms d'ensembles de compteurs. Les caractères génériques sont autorisés. Pour obtenir tous les ensembles de compteurs dans le fichier, tapez « import-counter -listset * ».

Obligatoire ?

true

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

true

-MaxSamples <Int64>

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.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Path <string[]>

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 fichier .csv, .tsv ou .blg que vous avez exporté à l'aide de l'applet de commande Export-Counter. Vous pouvez spécifier un seul fichier .csv ou .tsv, mais vous pouvez spécifier plusieurs fichiers .blg (jusqu'à 32) dans chaque commande. Vous pouvez également diriger des chaînes de chemin d'accès de fichier (entre guillemets) vers Import-Counter.

Obligatoire ?

true

Position ?

2

Valeur par défaut

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

true

-StartTime <DateTime>

Importe uniquement les données de compteur avec un horodatage supérieur ou égal aux date et heure spécifiées. Entrez un objet DateTime, tel qu'un objet créé par l'applet de commande Get-Date. Par défaut, Import-Counter importe toutes les données de compteur dans les fichiers spécifiés par le paramètre Path.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Résumé <switch>

Obtient un résumé des données importées, au lieu d'obtenir des échantillons de données de compteur individuels.

Obligatoire ?

true

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.String

Vous pouvez diriger les chemins d'accès des journaux de compteur de performance vers Import-Counter.

Sorties

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

Par défaut, Import-Counter retourne un objet Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Si vous utilisez le paramètre ListSet, Import-Command retourne un objet Microsoft.PowerShell.Commands.GetCounter.CounterSet. Si vous utilisez le paramètre Summary, Import-Command retourne un objet Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo.

Remarques

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

Exemple 1

C:\PS># Import-Counter

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

C:\PS> $data = import-counter -path ProcessorData.csv






Exemple 2

C:\PS># Import-Counter

Description
-----------
Cette commande importe seulement les données du compteur Processor(_total)\Interruptions/s à partir du fichier ProcessorData.blg dans la variable $i.

C:\PS> $i = import-counter -path ProcessorData.blg -counter "\\SERVER01\Processor(_Total)\Interrupts/sec"






Exemple 3

C:\PS># Import-Counter

Description
-----------
Cet exemple montre comment sélectionner des données à partir d'un fichier journal de compteur de performance (.blg), puis les exporter vers un fichier .csv. 

Les quatre premières commandes obtiennent les chemins d'accès de compteurs à partir du fichier et les enregistrent dans une variable. Les deux dernières commandes importent les données sélectionnées, puis exportent uniquement les données sélectionnées.


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

C:\PS> $data = import-counter .\processordata.blg



La deuxième commande affiche les chemins d'accès des compteurs dans la variable $data. L'affichage figure dans la sortie de la commande.

C:\PS> $data[0].countersamples | format-table 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
...


La troisième commande obtient les chemins d'accès des compteurs qui se terminent par « Interruptions/s » et enregistre les chemins d'accès dans la variable $IntCtrs.

C:\PS> $IntCtrs = $data[0].countersamples | where {$_.path -like "*interrupts/sec"} | foreach {$_.path}



La quatrième commande affiche les chemins d'accès des compteurs sélectionnés.

C:\PS> $IntCtrs

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



La cinquième commande utilise l'applet de commande Import-Counter pour importer les données. Elle utilise le paramètre Counter avec la variable $IntCtrs pour importer uniquement les données des chemins d'accès des compteurs dans $IntCtrs.

C:\PS> $i = import-counter -path .\processordata.blg -counter $intCtrs
    


La sixième commande utilise l'applet de commande Export-Counter pour exporter les données. 

C:\PS> $i | export-counter -path .\interrupts.csv -format CSV






Exemple 4

C:\PS># Import-Counter

Description
-----------
Cet exemple indique comment afficher tous les chemins d'accès de compteurs dans un groupe d'ensembles de compteurs importés. 

La première commande utilise le paramètre ListSet pour obtenir tous les ensembles de compteurs représentés dans un fichier de données de compteur.

C:\PS> 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...}



La deuxième commande obtient tous les chemins d'accès de compteurs de la liste définie.

C:\PS> import-counter -path processordata.csv -listset * | foreach {$_.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






Exemple 5

C:\PS># Import-Counter

Description
-----------
Cet exemple importe uniquement les données de compteur qui ont un horodatage compris entre les plages de début et de fin spécifiées dans la commande.

La première commande répertoire les horodatages de toutes les données du fichier ProcessorData.blg.

  C:\PS> import-counter -path .\disk.blg | format-table timestamp


Les deuxième et troisième commandes enregistrent des horodatages particuliers dans les variables $start et $end. Les chaînes sont transtypées en objets DateTime.

  C:\PS> $start = [datetime]"7/9/2008 3:47:00 PM"
  C:\PS> $end = [datetime]"7/9/2008 3:47:59 PM"


La quatrième commande utilise Import-Counter pour obtenir uniquement des données de compteur qui ont un horodatage compris entre les heures de début et de fin (incluses). La commande utilise les paramètres StartTime et EndTime pour spécifier cette plage.

  C:\PS> $t-data = import-counter -path disk.blg -starttime $start -endtime $end






Exemple 6

C:\PS># Import-Counter

Description
-----------
Cet exemple indique comment importer les cinq plus anciens et cinq plus récents échantillons d'un fichier journal de compteur de performance.

La première commande utilise l'applet de commande Import-Counter pour importer des données à partir du fichier Disk.blg. Elle utilise le paramètre MaxSamples pour limiter l'importation à cinq échantillons de compteur. Cette commande place les cinq premiers (plus anciens) échantillons dans le fichier.

C:\PS> import-counter -path disk.blg -maxSamples 5

La deuxième commande utilise une notation sous forme de tableau et l'opérateur de plage Windows PowerShell (..) pour obtenir les cinq derniers échantillons de compteur du fichier. Il s'agit des cinq échantillons les plus récents.

C:\PS> (import-counter -path disk.blg)[-1 .. -5]






Exemple 7

C:\PS># Import-Counter

Description
-----------
Cette commande utilise le paramètre Summary pour obtenir un résumé des données de compteur du fichier Memory.blg.

C:\PS> 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






Exemple 8

C:\PS># Import-Counter

Description
-----------
Cet exemple met à jour un fichier journal de compteur de performance. 

La première commande utilise le paramètre ListSet d'Import-Counter pour placer 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 commande Foreach-Object qui obtient uniquement les valeurs de la propriété PathsWithInstances de chaque objet.

C:\PS> $counters = import-counter olddata.blg -ListSet * | foreach {$_.PathsWithInstances}


La deuxième commande utilise ces mêmes compteurs dans une nouvelle commande Get-Counter pour obtenir un échantillon actuel et l'exporter vers le fichier NewData.blg.

C:\PS> get-counter -counter $counters -maxSamples 20 | export-counter c:\Logs\newdata.blg






Exemple 9

C:\PS># Import-Counter

Description
-----------
Cette commande importe les données de journal de performance à partir de deux journaux et enregistre les données dans la variable $counters. La commande utilise un opérateur de pipeline pour envoyer les chemins d'accès de journal de performance à Import-Counter. 

C:\PS> $counters = "d:\test\pdata.blg", "d:\samples\netlog.blg" | import-counter

Notez que tous les chemins d'accès sont entre guillemets et qu'ils sont séparés les uns des autres par des virgules.






Voir aussi




Table des matières