Invoke-Expression

在本地计算机上运行命令或表达式。

语法

Invoke-Expression
      [-Command] <String>
      [<CommonParameters>]

说明

Invoke-Expression该 cmdlet 计算或运行指定字符串作为命令,并返回表达式或命令的结果。 如果没有 Invoke-Expression,则返回在命令行上提交的字符串 (回显) 不变。

表达式在当前范围内求值并运行。 有关详细信息,请参阅 about_Scopes

注意

在脚本中使用 Invoke-Expression cmdlet 时采取合理的预防措施。 用于 Invoke-Expression 运行用户输入的命令时,请在运行该命令之前验证该命令是否安全运行。 通常,最好将脚本设计为包含预定义的输入选项,而不允许随意输入。

示例

示例 1:计算表达式

$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
...

此示例演示如何使用 Invoke-Expression 计算表达式。 如果没有 Invoke-Expression,则打印表达式,但不计算表达式。

第一个命令向变量分配一个字符串) $Command的值Get-Process (。

第二个命令显示在命令行键入变量名称的效果。 PowerShell 回显字符串。

第三个命令用于 Invoke-Expression 评估字符串。

示例 2:在本地计算机上运行脚本

Invoke-Expression -Command "C:\ps-test\testscript.ps1"
"C:\ps-test\testscript.ps1" | Invoke-Expression

这些命令用于 Invoke-Expression 在本地计算机上运行脚本TestScript.ps1。 这两个命令是等效的。 第一个使用 Command 参数指定要运行的命令。 第二个使用管道运算符 (|) 将命令字符串发送到 Invoke-Expression

示例 3:运行变量中的命令

$Command = 'Get-Process | where {$_.cpu -gt 1000}'
Invoke-Expression $Command

此示例运行保存在变量中的 $Command 命令字符串。

命令字符串括在单引号中,因为它包含一个代表当前对象的变量 $_。 如果变量括在双引号中, $_ 则变量将在变量中 $Command 保存之前将其值替换。

示例 4:获取并运行 cmdlet 帮助示例

$Cmdlet_name = "Get-ComputerInfo"
$Example_number = 1
$Example_code = (Get-Help $Cmdlet_name).examples.example[($Example_number-1)].code
Invoke-Expression $Example_code

此命令检索并运行 cmdlet 帮助主题中的 Get-EventLog 第一个示例。

若要运行其他 cmdlet 的示例,请将 $Cmdlet_name 变量的值更改为 cmdlet 的名称。 并将变量更改为 $Example_number 要运行的示例编号。 如果示例编号无效,该命令将失败。

注意

如果帮助文件中的示例代码在示例中具有输出,则 PowerShell 会尝试运行输出以及代码,并引发错误。

参数

-Command

指定要运行的命令或表达式。 键入该命令或表达式,或输入包含该命或表达式的变量。 需要 Command 参数。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

System.String or PSObject

可以通过管道将表示命令的对象传递给 Invoke-Expression$Input使用自动变量表示命令中的输入对象。

输出

PSObject

返回由调用的命令生成的输出 (命令 参数的值) 。

备注

在大多数情况下,使用 PowerShell 的调用运算符调用表达式并实现相同的结果。 调用运算符是一种更安全的方法。 有关详细信息,请参阅 about_Operators