Measure-Command
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.