Invoke-Expression
Exécute des commandes ou des expressions sur l'ordinateur local.
Syntaxe
Invoke-Expression
[-Command] <String>
[<CommonParameters>]Description
L’applet Invoke-Expression de commande é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.
Attention
Prenez des précautions raisonnables lors de l’utilisation de l’applet Invoke-Expression de commande dans les scripts. Lorsque vous utilisez Invoke-Expression pour exécuter une commande que l’utilisateur entre, 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 des entrées libres.
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 l’évaluation d’une expression. Sans Invoke-Expression, l’expression est imprimée, mais pas évaluée.
La première commande affecte une valeur ( Get-Process une chaîne) à la $Command variable.
La deuxième commande illustre le résultat de l'entrée du 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 permettent Invoke-Expression d’exécuter un script, TestScript.ps1, sur l’ordinateur local. Les deux commandes sont équivalentes. Le premier 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 $Command variable.
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 est remplacée par sa valeur avant d’être enregistrée dans la $Command variable.
Exemple 4 : Obtenir et exécuter un exemple d’aide sur l’applet de commande
$Cmdlet_name = "Get-ComputerInfo"
$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 Get-EventLog de commande.
Pour exécuter un exemple d’applet de commande différente, remplacez la valeur de la $Cmdlet_name variable par le nom de l’applet de commande. Et remplacez la $Example_number variable par l’exemple de numéro que vous souhaitez exécuter. La commande échoue si l’exemple de numéro n’est pas valide.
Remarque
Si l’exemple de code du fichier d’aide contient une sortie dans l’exemple, PowerShell tente d’exécuter la sortie avec le code et une erreur est levée.
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
Vous pouvez diriger une chaîne représentant l’expression à appeler à cette applet de commande. Utilisez la $Input variable automatique pour représenter les objets d’entrée dans la commande.
Vous pouvez diriger un objet représentant l’expression à appeler vers cette applet de commande. Utilisez la $Input variable automatique pour représenter les objets d’entrée dans la commande.
Sorties
None
Cette applet de commande ne retourne aucune sortie propre, mais la commande appelée peut retourner la sortie.
Notes
Windows PowerShell inclut les alias suivants pour Invoke-Expression:
iex
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.
