Measure-Command

Article
01/13/2010

Mesure le temps qu'il faut pour exécuter des blocs de script et des applets de commande.

Syntaxe

Measure-Command [-Expression] <scriptblock> [-InputObject <psobject>] [<CommonParameters>]

Description

L'applet de commande Measure-Command exécute en interne un bloc de script ou une applet de commande, chronomètre l'exécution de l'opération et retourne le temps d'exécution.

Paramètres

-Expression <scriptblock>

Spécifie l'expression qui est chronométrée. Mettez l'expression entre accolades ({}). Le nom du paramètre (« Expression ») est facultatif.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InputObject <psobject>

Spécifie les objets représentant les expressions à mesurer. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue)
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

System.Management.Automation.PSObject

Vous pouvez diriger un objet vers Measure-Command.

Sorties

System.TimeSpan

Measure-Command retourne un objet de durée qui représente le résultat.

Remarques

Pour plus d'informations, tapez « Get-Help Measure-Command -detailed ». Pour obtenir des informations techniques, tapez « Get-Help Measure-Command -full ».

Lors de la spécification de plusieurs valeurs pour un même paramètre, utilisez des virgules pour séparer les valeurs. Par exemple, « <nom_paramètre> <valeur1>, <valeur2> ».

Exemple 1

C:\PS>Measure-Command { get-eventlog "windows powershell" }

Description
-----------
Cette commande mesure le temps requis pour exécuter une commande « get-eventlog » permettant d'obtenir les événements du journal des événements Windows PowerShell.

Exemple 2

C:\PS>measure-command {get-childitem c:\windows -include *.txt -recurse}

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 8
Milliseconds      : 618
Ticks             : 86182763
TotalDays         : 9.9748568287037E-05
TotalHours        : 0.00239396563888889
TotalMinutes      : 0.143637938333333
TotalSeconds      : 8.6182763
TotalMilliseconds : 8618.2763

C:\PS>measure-command {get-childitem c:\windows -filter "*.txt" -recurse}

Days              : 0
Hours             : 0
Minutes           : 0
Seconds           : 1
Milliseconds      : 140
Ticks             : 11409189
TotalDays         : 1.32050798611111E-05
TotalHours        : 0.000316921916666667
TotalMinutes      : 0.019015315
TotalSeconds      : 1.1409189
TotalMilliseconds : 1140.9189

Description
-----------
Ces commandes affichent la valeur d'utilisation d'un filtre spécifique au fournisseur dans les commandes Windows PowerShell. La première commande mesure le temps requis pour traiter une commande Get-ChildItem récursive qui utilise le paramètre Include. La deuxième commande mesure le temps requis pour traiter une commande Get-ChildItem récursive qui utilise le paramètre Filter spécifique au fournisseur.

Voir aussi

Concepts

Trace-Command
Invoke-Command

Partager via