Sdílet prostřednictvím

Invoke-Expression

  • Reference
Modul:
Microsoft.PowerShell.Utility

Spouští příkazy nebo výrazy v místním počítači.

Syntaxe

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

Description

Rutina Invoke-Expression vyhodnotí nebo spustí zadaný řetězec jako příkaz a vrátí výsledky výrazu nebo příkazu. Bez vyvolání výrazuby se vrátil řetězec odeslaný na příkazovém řádku (echoed) beze změny.

Příklady

Příklad 1: Vyhodnocení výrazu

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

Tento příklad ukazuje použití Invoke-Expression k vyhodnocení výrazu. Bez Invoke-Expression se výraz vytiskne, ale nevyhodnotí se.

První příkaz přiřadí k proměnné $Command hodnotu Get-Process (řetězec).

Druhý příkaz ukazuje účinek zadávání názvu proměnné na příkazovém řádku. Windows PowerShell vyzve řetězec.

Třetí příkaz používá k vyhodnocení řetězce Invoke-Expression.

Příklad 2: Spuštění skriptu v místním počítači

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

Tyto příkazy používají Invoke-Expression ke spuštění skriptu TestScript.ps1v místním počítači. Oba příkazy jsou ekvivalentní. První použije parametr Command k určení příkazu, který se má spustit. Druhý používá operátor kanálu (|) k odeslání řetězce příkazu Invoke-Expression.

Příklad 3: Spuštění příkazu v proměnné

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

Tento příklad spustí příkazový řetězec uložený v proměnné $Command.

Řetězec příkazu je uzavřený v jednoduchých uvozovkách, protože obsahuje proměnnou, $_, která představuje aktuální objekt. Pokud by byla uzavřena do dvojitých uvozovek, $_ proměnná by byla nahrazena její hodnotou před uložením do proměnné $Command.

Příklad 4: Získání a spuštění příkladu nápovědy rutiny

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

Tento příkaz načte a spustí první příklad v tématu nápovědy k rutině Get-EventLog.

Pokud chcete spustit příklad jiné rutiny, změňte hodnotu proměnné $Cmdlet_name na název rutiny. A změňte proměnnou $Example_number na ukázkové číslo, které chcete spustit. Příkaz selže, pokud není číslo příkladu platné.

Parametry

-Command

Určuje příkaz nebo výraz, který se má spustit. Zadejte příkaz nebo výraz nebo zadejte proměnnou, která obsahuje příkaz nebo výraz. Je vyžadován parametr Command.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

System.String or PSObject

Objekt, který představuje příkaz pro Invoke-Expression. Použijte $Input automatickou proměnnou k reprezentaci vstupních objektů v příkazu.

Výstupy

PSObject

Vrátí výstup vygenerovaný vyvoláním příkazu (hodnota parametru Command).

Poznámky

  • Výraz je příkaz, který lze vyhodnotit a vytvořit výsledek, například příkaz Windows PowerShellu.

  • Při použití rutiny Invoke-Expression ve skriptech proveďte rozumná opatření. Při použití Invoke-Expression ke spuštění příkazu, který uživatel zadá, ověřte, zda je příkaz před spuštěním bezpečný. Obecně je nejlepší navrhnout skript s předdefinovanými možnostmi zadávání, a nikoli povolit volný vstup.