L'applet de commande Export-Counter accepte des objets PerformanceCounterSampleSet et les exporte en tant que fichiers journaux de compteur.
Syntaxe
Export-Counter [-Path] <string> -InputObject <PerformanceCounterSampleSet[]> [-Circular <switch>] [-FileFormat <string>] [-Force <switch>] [-MaxSize <int>] [<CommonParameters>]
Description
L'applet de commande Export-Counter exporte les données de compteur de performance (objets PerformanceCounterSampleSet) vers des fichiers journaux au format .blg (journal de performance binaire), .csv (données séparées par des virgules) ou .tsv (données séparées par des tabulations). Vous pouvez utiliser cette applet de commande pour consigner ou reconsigner les données de compteur de performance dans un journal.
L'applet de commande Export-Counter a été conçue pour exporter les données retournées par les applets de commande Get-Counter et Import-Counter.
Remarque : Export-Counter s'exécute uniquement sur Windows 7, Windows Server 2008 R2 et les versions ultérieures de Windows.
Paramètres
-Circular <switch>
Indique que le fichier de sortie doit être un journal circulaire au format FIFO (First In, First Out, premier entré, premier sorti). Lorsque vous incluez ce paramètre, le paramètre MaxSize est requis.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-FileFormat <string>
Spécifie le format de sortie du fichier journal de sortie. Les valeurs valides sont CSV, TSV et BLG. La valeur par défaut est BLG.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
BLG |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force <switch>
Écrase et remplace un fichier existant, le cas échéant, dans l'emplacement spécifié 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 |
-InputObject <PerformanceCounterSampleSet[]>
Spécifie les données de compteur à exporter. Entrez une variable qui contient les données ou une commande qui obtient les données, telle qu'une commande Get-Counter ou Import-Counter.
|
Obligatoire ? |
true |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-MaxSize <int>
Spécifie la taille maximale du fichier de sortie.
Si le paramètre Circular est spécifié, lorsque le fichier journal atteint sa taille maximale spécifiée, les entrées les plus anciennes sont supprimées lorsque des entrées nouvelles sont ajoutées. Si le paramètre Circular n'est pas spécifié, lorsque le fichier journal atteint sa taille maximale spécifiée, aucune nouvelle donnée n'est ajoutée et l'applet de commande génère une erreur sans fin d'exécution.
|
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 le chemin d'accès et le nom du fichier de sortie. Entrez un chemin d'accès relatif ou absolu sur l'ordinateur local ou un chemin d'accès UNC (Uniform Naming Convention) à un ordinateur distant, tel que \\Ordinateur\Partage\fichier.blg. Ce paramètre est obligatoire.
Remarque : le format du fichier est déterminé par la valeur du paramètre FileFormat et non par l'extension du nom de fichier dans le chemin d'accès.
|
Obligatoire ? |
true |
|
Position ? |
2 |
|
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 |
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet Vous pouvez diriger les données de compteur de performance de Get-Counter ou Import-Counter vers Export-Counter. |
|
Sorties |
Aucun |
Remarques
Le générateur de fichier journal attend que tous les objets d'entrée aient le même chemin d'accès de compteur et que les objets soient classés dans l'ordre croissant de date et d'heure.
Le type et le chemin d'accès du compteur du premier objet d'entrée déterminent les propriétés enregistrées dans le fichier journal. Si d'autres objets d'entrée n'ont pas de valeur pour une propriété enregistrée, le champ de la propriété est vide. Si les objets ont des valeurs de propriété qui n'ont pas été enregistrées, les valeurs de propriété supplémentaires sont ignorées.
L'analyseur de performances peut ne pas être en mesure de lire tous les journaux générés par Export-Counter. Par exemple, l'analyseur de performances exige que tous les objets aient le même chemin d'accès et soient séparés par le même intervalle de temps.
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># Export-Counter Description ----------- Cette commande exporte les données de compteur vers un fichier .blg. La commande utilise l'applet de commande Get-Counter pour collecter les données de temps processeur. Elle utilise un opérateur de pipeline (|) pour envoyer les données à l'applet de commande Export-Counter. La commande Export-Counter utilise la variable Path pour spécifier le fichier de sortie. C:\PS> get-counter "\Processor(*)\% Processor Time" -max 50 | export-counter -path $home\counters.blg Étant donné que le jeu de données peut être très volumineux, cette commande envoie les données à Export-Counter à travers le pipeline. Si les données ont été enregistrées dans une variable, la commande peut utiliser une quantité de mémoire disproportionnée.
Exemple 2
C:\PS># Export-Counter Description ----------- Ces commandes convertissent un fichier CSV au format BLG de données de compteur. La première commande utilise la fonctionnalité de conversion Windows PowerShell intégrée pour stocker la valeur de 1 gigaoctet (Go) exprimée en octets dans la variable $1GBinBytes. Lorsque vous tapez une valeur suivie de Ko (kilooctet), Mo (mégaoctet) ou Go, Windows PowerShell retourne la valeur en octets. C:\PS> $1GBinBytes = 1GB La deuxième commande utilise l'applet de commande Import-Counter pour importer les données de compteur de performance à partir du fichier Threads.csv. L'exemple suppose que ce fichier a été exporté précédemment à l'aide de l'applet de commande Export-Counter. Un opérateur de pipeline (|) envoie les données importées vers l'applet de commande Export-Counter. La commande utilise le paramètre Path pour spécifier l'emplacement du fichier de sortie. Elle utilise les paramètres Circular et MaxSize pour diriger Export-Counter pour créer un journal circulaire qui ne dépasse pas 1 Go. C:\PS> import-counter threads.csv | export-counter -path threadtest.blg -circular -maxsize $1GBinBytes
Exemple 3
C:\PS># Export-Counter Description ----------- Cet exemple montre comment obtenir des données de compteur de performance à partir d'un ordinateur distant et enregistrer ces données dans un fichier sur l'ordinateur distant. La première commande utilise l'applet de commande Get-Counter pour collecter des données de compteur de plage de travail à partir de Server01, un ordinateur distant. La commande enregistre les données dans la variable $c. C:\PS> $c = get-counter -computername Server01 -counter "\Process(*)\Working Set - Private" -maxSamples 20 La deuxième commande utilise un opérateur de pipeline (|) pour envoyer les données de $c vers l'applet de commande Export-Counter, qui les enregistre dans le fichier Workingset.blg dans le partage Perf, sur l'ordinateur Server01. C:\PS> $c | export-counter -path \\Server01\Perf\WorkingSet.blg
Exemple 4
C:\PS># Export-Counter
Description
-----------
Cet exemple montre comment utiliser les applets de commande Import-Counter et Export-Counter pour reconsigner des données existantes dans un journal.
La première commande utilise l'applet de commande Import-Counter pour importer les données de compteur de performance à partir du journal DiskSpace.blg. Elle enregistre les données dans la variable $all. Ce fichier contient des échantillons du compteur « LogicalDisk\% Free Space » (Disque logique\Pourcentage d'espace libre) sur plus de 200 ordinateurs distants dans l'entreprise.
C:\PS> $all = import-counter DiskSpace.blg
La deuxième commande utilise la propriété CounterSamples de l'objet jeu d'échantillons dans $all et l'applet de commande Where-Object (alias = « where ») pour sélectionner les objets pour lesquels CookedValues a une valeur inférieure à 15 (%). La commande enregistre les résultats dans la variable de $lowSpace.
C:\PS> $lowSpace = $all.countersamples | where {$_.cookedvalues -lt 15}
La troisième commande utilise un opérateur de pipeline (|) pour envoyer les données dans la variable $lowSpace vers l'applet de commande Export-Counter. La commande utilise la variable path pour indiquer que les données sélectionnées doivent être consignées dans le fichier LowDiskSpace.blg.
C:\PS> $lowSpace | export-counter -path LowDiskSpace.blg
Voir aussi