Partager via

Export-Counter

Module:
Microsoft.PowerShell.Diagnostics Module

Exporte les données du compteur de performances vers les fichiers journaux.

Syntaxe

Default (Par défaut) 

Export-Counter
    [-Path] <String>
    [-FileFormat <String>]
    [-MaxSize <UInt32>]
    -InputObject <PerformanceCounterSampleSet[]>
    [-Force]
    [-Circular]
    [<CommonParameters>]

Description

L’applet de commande Export-Counter exporte des données de compteur de performances (PerformanceCounterSampleSet objets) vers des fichiers journaux dans le journal des performances binaires (.blg), une valeur séparée par des virgules (.csv) ou une valeur séparée par des tabulations (.tsv). Vous utilisez cette applet de commande pour consigner les données du compteur de performances.

L’applet de commande Export-Counter est conçue pour exporter des données retournées par les applets de commande Get-Counter et Import-Counter.

Cette applet de commande s’exécute uniquement sur Windows 7, Windows Server 2008 R2 et versions ultérieures de Windows.

Exemples

EXEMPLE 1 : Exporter des données de compteur dans un fichier

Cet exemple exporte des données de compteur dans un fichier BLG.

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

La commande utilise l’applet de commande Get-Counter pour collecter des données de temps processeur. Il 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.

Étant donné que le jeu de données peut être très volumineux, cet exemple envoie les données à Export-Counter via le pipeline. Si les données ont été enregistrées dans une variable, vous pouvez utiliser une quantité disproportionnée de mémoire.

Exemple 2 : Exporter un fichier dans un format de fichier de compteur

Cet exemple convertit un fichier CSV en format BLG de données de compteur.

L’applet de commande Import-Counter importe les données du compteur de performances à partir du fichier Threads.csv. L’exemple suppose que ce fichier a été précédemment exporté à l’aide de l’applet de commande Export-Counter. Un opérateur de pipeline (|) envoie les données importées à l’applet de commande Export-Counter. La commande utilise le paramètre Path pour spécifier l’emplacement du fichier de sortie. Il utilise les paramètres Circular et MaxSize pour diriger l’applet de commande Export-Counter pour créer un journal circulaire qui s’encapsule à 1 Go. Le paramètre MaxSize est exprimé en mégaoctets.

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

Exemple 3 : Obtenir des données de compteur à partir d’un ordinateur distant et enregistrer les données dans un fichier

Cet exemple montre comment obtenir des données de compteur de performances à partir d’un ordinateur distant et enregistrer les 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 jeu de travail à partir de Server01, un ordinateur distant. La commande enregistre les données dans la variable $C.

La deuxième commande utilise un opérateur de pipeline (|) pour envoyer les données dans $C à l’applet de commande Export-Counter, qui l’enregistre dans le fichier Workingset.blg dans le partage Perf de l’ordinateur Server01.

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Exemple 4 : journaliser à nouveau les données existantes

Cet exemple montre comment utiliser les applets de commande Import-Counter et Export-Counter pour journaliser à nouveau les données existantes.

La première commande utilise l’applet de commande Import-Counter pour importer des données de compteur de performances à partir du journal DiskSpace.blg. Elle enregistre les données dans la variable $All. Ce fichier contient des exemples du compteur « LogicalDisk% Espace libre » sur plus de 200 ordinateurs distants de l’entreprise.

La deuxième commande utilise l’applet de commande Where-Object pour sélectionner des objets avec CookedValue de moins de 15 (pourcentage). La commande enregistre les résultats dans la variable $LowSpace.

La troisième commande utilise un opérateur de pipeline (|) pour envoyer les données dans la variable $LowSpace à l’applet de commande Export-Counter. La commande utilise le paramètre Path pour indiquer que les données sélectionnées doivent être consignées dans le fichier LowDiskSpace.blg.

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

Paramètres

-Circular

Indique que le fichier de sortie est un journal circulaire avec d’abord le format FIFO (First Out). Lorsque vous incluez ce paramètre, le paramètre MaxSize est requis.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-FileFormat

Spécifie le format de sortie du fichier journal de sortie.

Les valeurs acceptables pour ce paramètre sont les suivantes :

  • CSV
  • TSV
  • BLG

La valeur par défaut est BLG.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Remplace et remplace un fichier existant s’il en existe un dans l’emplacement spécifié par le paramètre Path.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

Spécifie, en tant que tableau, les données de compteur à exporter. Entrez une variable qui contient les données ou une commande qui obtient les données, telles que l’applet de commande Get-Counter ou Import-Counter.

Propriétés du paramètre

Type:

PerformanceCounterSampleSet[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-MaxSize

Spécifie la taille maximale du fichier de sortie en mégaoctets (Mo).

Si le paramètre de circulaire est spécifié, lorsque le fichier journal atteint la taille maximale spécifiée, les entrées les plus anciennes sont supprimées au fur et à mesure que des entrées plus récentes sont ajoutées. Si le paramètre de circulaire n’est pas spécifié, lorsque le fichier journal atteint la 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.

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Spécifie le chemin d’accès et le nom du fichier de sortie. Entrez un chemin relatif ou absolu sur l’ordinateur local ou un chemin d’accès UNC (Uniform Naming Convention) vers un ordinateur distant, tel que \\Computer\Share\file.blg. Ce paramètre est obligatoire.

Le format de fichier est déterminé par la valeur du paramètre FileFormat, et non par l’extension de nom de fichier dans le chemin d’accès.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:PSPath

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PerformanceCounterSampleSet

Vous pouvez diriger les données de compteur de performances de Get-Counter ou de Import-Counter vers cette applet de commande.

Sorties

None

Notes

Le générateur de fichiers journaux s’attend à ce que tous les objets d’entrée aient le même chemin de compteur et que les objets soient organisés dans l’ordre de temps croissant.

Le type de compteur et le chemin d’accès 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 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 que tous les objets 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 Windows PowerShell distant, vous pouvez utiliser l’applet de commande Invoke-Command pour exécuter une commande Import-Counter sur un ordinateur distant.