Invoke-Expression

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

De Invoke-Expression cmdlet evalueert of voert een opgegeven tekenreeks uit als een opdracht en retourneert de resultaten van de expressie of opdracht. Zonder Invoke-Expressionwordt een tekenreeks die is verzonden op de opdrachtregel, ongewijzigd geretourneerd (echoed).

Expressies worden geëvalueerd en uitgevoerd in het huidige bereik. Zie about_Scopesvoor meer informatie.

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

In dit voorbeeld ziet u het gebruik van Invoke-Expression om een expressie te evalueren. Zonder Invoke-Expressionwordt de expressie afgedrukt, maar niet geëvalueerd.

Met de eerste opdracht wordt een waarde van Get-Process (een tekenreeks) toegewezen aan de $Command variabele.

De tweede opdracht toont het effect van het typen van de naam van de variabele op de opdrachtregel. PowerShell echot de tekenreeks.

De derde opdracht gebruikt Invoke-Expression om de tekenreeks te evalueren.

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

Deze opdrachten gebruiken Invoke-Expression om een script, TestScript.ps1, uit te voeren op de lokale computer. De twee opdrachten zijn equivalent. De eerste maakt gebruik van de parameter Command om de opdracht op te geven die moet worden uitgevoerd. De tweede maakt gebruik van een pijplijnoperator (|) om de opdrachttekenreeks naar Invoke-Expressionte verzenden.

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

In dit voorbeeld wordt een opdrachtreeks uitgevoerd die is opgeslagen in de variabele $Command.

De opdrachtreeks staat tussen enkele aanhalingstekens omdat deze een variabele bevat, $_, die het huidige object vertegenwoordigt. Als deze tussen dubbele aanhalingstekens staat, wordt de variabele $_ vervangen door de waarde voordat deze werd opgeslagen in de $Command variabele.

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

Met deze opdracht wordt het eerste voorbeeld opgehaald en uitgevoerd in het Help-onderwerp van de Get-EventLog cmdlet.

Als u een voorbeeld van een andere cmdlet wilt uitvoeren, wijzigt u de waarde van de variabele $Cmdlet_name in de naam van de cmdlet. En wijzig de $Example_number variabele in het voorbeeldnummer dat u wilt uitvoeren. De opdracht mislukt als het voorbeeldnummer ongeldig is.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een tekenreeks doorsluisen die de expressie aanroept naar deze cmdlet. Gebruik de $input automatische variabele om de invoerobjecten in de opdracht weer te geven.

U kunt een object doorsluisen dat de expressie aanroept naar deze cmdlet. Gebruik de $input automatische variabele om de invoerobjecten in de opdracht weer te geven.

Deze cmdlet retourneert geen eigen uitvoer, maar de aangeroepen opdracht kan uitvoer retourneren.

PowerShell bevat de volgende aliassen voor Invoke-Expression:

• Alle platforms:
  • iex

In de meeste gevallen roept u expressies aan met behulp van de aanroepoperator van PowerShell en krijgt u dezelfde resultaten. De aanroepoperator is een veiligere methode. Zie about_Operatorsvoor meer informatie.