共用方式為


Invoke-Expression

在本機電腦上執行命令或表達式。

語法

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

Description

Invoke-Expression Cmdlet 會評估或執行指定的字串做為命令,並傳回表達式或命令的結果。 如果沒有 Invoke-Expression,在命令行提交的字串將會傳回 (echoed) 不變。

範例

範例 1:評估表達式

PS C:\> $Command = "Get-Process"
PS C:\> $Command
Get-Process
PS C:\> 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,則會列印表達式,但不會進行評估。

第一個命令會將 Get-Process 值(字串)指派給$Command變數。

第二個命令會顯示在命令行輸入變數名稱的效果。 Windows PowerShell 會回應字串。

第三個命令會使用 Invoke-Expression 來評估字串。

範例 2:在本機計算機上執行腳本

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

這些命令會使用 Invoke-Expression 在本機電腦上執行腳本 TestScript.ps1。 這兩個命令相等。 第一個會使用 Command 參數來指定要執行的命令。 第二個使用管線運算符 (|) 將命令字串傳送至 Invoke-Expression

範例 3:在變數中執行命令

PS C:\> $Command = 'Get-Process | where {$_.cpu -gt 1000}'
PS C:\> Invoke-Expression $Command

此範例會執行儲存在 $Command 變數中的命令字串。

命令字串會以單引號括住,因為它包含代表目前 物件的變數 $_。 如果變數以雙引號括住,則 $_ 變數會在儲存在$Command變數之前,由其值取代。

範例 4:取得並執行 Cmdlet 說明範例

PS C:\> $Cmdlet_name = "Get-EventLog"
PS C:\> $Example_number = 1
PS C:\> $Example_code = (Get-Help $Cmdlet_name).examples.example[($Example_number-1)].code
PS C:\> Invoke-Expression $Example_code

此命令會擷取並執行 Get-EventLog Cmdlet 說明主題中的第一個範例。

若要執行不同 Cmdlet 的範例,請將 $Cmdlet_name 變數的值變更為 Cmdlet 的名稱。 而且,將 $Example_number 變數變更為您想要執行的範例編號。 如果範例編號無效,此命令將會失敗。

參數

-Command

指定要執行的命令或表達式。 輸入命令或表達式,或輸入包含命令或表達式的變數。 需要 Command 參數。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

System.String or PSObject

您可以使用管線將 代表命令的物件傳送至 Invoke-Expression。 使用$Input自動變數來表示命令中的輸入物件。

輸出

PSObject

傳回由叫用命令所產生的輸出(Command 參數的值)。

備註

  • 表達式是可評估併產生結果的語句,例如 Windows PowerShell 命令。

  • 在腳本中使用 Invoke-Expression Cmdlet 時採取合理的預防措施。 使用 Invoke-Expression 執行使用者輸入的命令時,請先確認命令在執行之前安全執行。 一般而言,最好使用預先定義的輸入選項來設計腳本,而不是允許手繪多邊形輸入。