Export-Counter

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

L''applet de commande Export- Counter 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 pouvez utiliser 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.

PS C:\> Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $home\Counters.blg

Cette commande exporte les données de compteur dans un fichier 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, cette commande envoie les données à 'exportation-compteur via le pipeline. Si les données ont été enregistrées dans une variable, la commande peut utiliser une quantité disproportionnée de mémoire.

The first command uses the built-in Windows PowerShell conversion feature to store the value of 1 gigabyte (GB) in bytes in the $1GBInBytes variable. When you type a value followed by K (kilobyte), MB (megabyte), or GB, Windows PowerShell returns the value in bytes.
PS C:\> $1GBInBytes = 1GB

The second command uses the Import-Counter cmdlet to import performance counter data from the Threads.csv file. The example presumes that this file was previously exported by using the **Export-Counter** cmdlet. A pipeline operator (|) sends the imported data to the **Export-Counter** cmdlet. The command uses the *Path* parameter to specify the location of the output file. It uses the *Circular* and *MaxSize* parameters to direct the **Export-Counter** cmdlet to create a circular log that wraps at 1 GB.
PS C:\> Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBinBytes

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

The first command uses the Get-Counter cmdlet to collect working set counter data from Server01, a remote computer. The command saves the data in the $C variable.
PS C:\> $C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples 20

The second command uses a pipeline operator (|) to send the data in $C to the **Export-Counter** cmdlet, which saves it in the Workingset.blg file in the Perf share of the Server01 computer.
PS C:\> $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

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.

The first command uses the **Import-Counter** cmdlet to import performance counter data from the DiskSpace.blg log. It saves the data in the $All variable. This file contains samples of the "LogicalDisk\% Free Space" counter on more than 200 remote computers in the enterprise.
PS C:\> $All = Import-Counter DiskSpace.blg

The second command uses the **CounterSamples** property of the sample set object in $All and the Where-Object cmdlet (alias = "where") to select objects with **CookedValues** of less than 15 (percent). The command saves the results in the $LowSpace variable.
PS C:\> $LowSpace = $All.CounterSamples | where {$_.CookedValues -lt 15}

The third command uses a pipeline operator (|) to send the data in the $LowSpace variable to the **Export-Counter** cmdlet. The command uses the *Path* parameter to indicate that the selected data should be logged in the LowDiskSpace.blg file.
PS C:\> $LowSpace | Export-Counter -Path LowDiskSpace.blg

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

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.

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

• 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 d’activité 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.