Partager via

Export-Counter

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

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

Syntaxe

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

Description

L’applet Export-Counter de commande exporte des données de compteur de performances (objets PerformanceCounterSampleSet) 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 Export-Counter de commande est conçue pour exporter des données retournées par les Get-Counter applets de commande et Import-Counter les applets de commande.

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 Get-Counter de commande pour collecter des données de temps processeur. Il utilise un opérateur de pipeline (|) pour envoyer les données à l’applet Export-Counter de commande. La Export-Counter commande 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 via Export-Counter 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 Import-Counter de commande importe les données du compteur de performances à partir du Threads.csv fichier. L’exemple suppose que ce fichier a été précédemment exporté à l’aide de l’applet Export-Counter de commande. Un opérateur de pipeline (|) envoie les données importées à l’applet de Export-Counter commande. 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 Export-Counter de commande 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 les données de compteur de performances d'un ordinateur distant, et les enregistrer dans un fichier sur l'ordinateur distant.

La première commande utilise l’applet Get-Counter de commande pour collecter les données du compteur de jeu de travail à partir de Server01, un ordinateur distant. La commande enregistre les données dans la $C variable.

La deuxième commande utilise un opérateur de pipeline (|) pour envoyer les données $C à l’applet Export-Counter de commande, qui l’enregistre dans le Workingset.blg fichier dans le Perf partage 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 Import-Counter applets de commande et Export-Counter les applets de commande pour journaliser à nouveau les données existantes.

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

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

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

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

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

-FileFormat

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

Les valeurs valides pour ce paramètre sont :

  • CSV
  • TSV
  • BLG

La valeur par défaut est BLG.

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

-Force

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

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 ou Import-Counter l’applet Get-Counter de commande.

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

-MaxSize

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

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

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

-Path

Spécifie le chemin d'accès et le nom de fichier 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.

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:False

Entrées

PerformanceCounterSampleSet

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

Sorties

None

Notes

Le générateur de fichier journal s'attend à ce que tous les objets d'entrée aient le même chemin d'accès de compteur, et que ces objets soient regroupés par ordre chronologie croissant.

Le type et le chemin d'accès de 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 propriété est vide. Si les objets ont des valeurs de propriété qui n'étaient pas enregistrées, les valeurs de propriété supplémentaires sont ignorées.

Analyseur de performances peut ne pas être en mesure de lire tous les journaux générésExport-Counter. Par exemple, 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 Import-Counter de commande n’a pas de paramètre ComputerName . Toutefois, si l’ordinateur est configuré pour Windows PowerShell Distant, vous pouvez utiliser l’applet Invoke-Command de commande pour exécuter une Import-Counter commande sur un ordinateur distant.