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 執行使用者輸入的命令時,請先確認命令在執行之前安全執行。 一般而言,最好使用預先定義的輸入選項來設計腳本,而不是允許手繪多邊形輸入。