Invoke-Expression
Exécute des commandes ou des expressions sur l’ordinateur local.
Syntaxe
Invoke-Expression
[-Command] <String>
[<CommonParameters>]Description
L’applet de commande Invoke-Expression évalue ou exécute une chaîne spécifiée en tant que commande et retourne les résultats de l’expression ou de la commande. Sans Invoke-Expression, une chaîne envoyée à la ligne de commande est retournée (écho) inchangée.
Les expressions sont évaluées et exécutées dans l’étendue actuelle. Pour plus d’informations, consultez about_Scopes.
Prudence
Prenez des précautions raisonnables lors de l’utilisation de l’applet de commande Invoke-Expression dans les scripts. Lorsque vous utilisez Invoke-Expression pour exécuter une commande entrée par l’utilisateur, vérifiez que la commande est sûre à exécuter avant de l’exécuter. En général, il est préférable de concevoir votre script avec des options d’entrée prédéfinies, plutôt que d’autoriser l’entrée de forme libre.
Exemples
Exemple 1 : Évaluer une expression
$Command = "Get-Process"
$Command
Get-Process
Invoke-Expression $Command
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
296 4 1572 1956 20 0.53 1348 AdtAgent
270 6 1328 800 34 0.06 2396 alg
67 2 620 484 20 0.22 716 ati2evxx
1060 15 12904 11840 74 11.48 892 CcmExec
1400 33 25280 37544 223 38.44 2564 communicator
...Cet exemple illustre l’utilisation de Invoke-Expression pour évaluer une expression. Sans Invoke-Expression, l’expression est imprimée, mais pas évaluée.
La première commande affecte une valeur de Get-Process (chaîne) à la variable $Command.
La deuxième commande montre l’effet de taper le nom de la variable sur la ligne de commande. PowerShell fait écho à la chaîne.
La troisième commande utilise Invoke-Expression pour évaluer la chaîne.
Exemple 2 : Exécuter un script sur l’ordinateur local
Invoke-Expression -Command "C:\ps-test\testscript.ps1"
"C:\ps-test\testscript.ps1" | Invoke-ExpressionCes commandes utilisent Invoke-Expression pour exécuter un script, TestScript.ps1, sur l’ordinateur local. Les deux commandes sont équivalentes. La première utilise le paramètre Command pour spécifier la commande à exécuter.
La seconde utilise un opérateur de pipeline (|) pour envoyer la chaîne de commande à Invoke-Expression.
Exemple 3 : Exécuter une commande dans une variable
$Command = 'Get-Process | where {$_.cpu -gt 1000}'
Invoke-Expression $CommandCet exemple exécute une chaîne de commande enregistrée dans la variable $Command.
La chaîne de commande est placée entre guillemets simples, car elle inclut une variable, $_, qui représente l’objet actuel. Si elle était placée entre guillemets doubles, la variable $_ serait remplacée par sa valeur avant d’être enregistrée dans la variable $Command.
Exemple 4 : Obtenir et exécuter un exemple d’aide sur l’applet de commande
$Cmdlet_name = "Get-EventLog"
$Example_number = 1
$Example_code = (Get-Help $Cmdlet_name).examples.example[($Example_number-1)].code
Invoke-Expression $Example_codeCette commande récupère et exécute le premier exemple dans la rubrique d’aide de l’applet de commande Get-EventLog.
Pour exécuter un exemple d’applet de commande différente, remplacez la valeur de la variable $Cmdlet_name par le nom de l’applet de commande. Ensuite, remplacez la variable $Example_number par l’exemple de numéro que vous souhaitez exécuter. La commande échoue si l’exemple de numéro n’est pas valide.
Paramètres
-Command
Spécifie la commande ou l’expression à exécuter. Tapez la commande ou l’expression ou entrez une variable qui contient la commande ou l’expression. Le paramètre Command est requis.
| Type: | String |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Entrées
System.String or PSObject
Vous pouvez diriger un objet qui représente la commande vers Invoke-Expression.
Utilisez la variable automatique $Input pour représenter les objets d’entrée dans la commande.
Sorties
PSObject
Retourne la sortie générée par la commande appelée (valeur du paramètre Command).
Notes
Dans la plupart des cas, vous appelez des expressions à l’aide de l’opérateur d’appel de PowerShell et obtenez les mêmes résultats. L’opérateur d’appel est une méthode plus sûre. Pour plus d’informations, consultez about_Operators.