NOM
Import-Counter
RÉSUMÉ
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[]> -Summary <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
-Summary <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, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
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.
NOTES
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 comman de 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.
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=138338
Get-Counter
Export-Counter
Aucun commentaire:
Enregistrer un commentaire