Delen via

Invoke-Expression

  • Referentie
Module:
Microsoft.PowerShell.Utility

Voert opdrachten of expressies uit op de lokale computer.

Syntax

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

Description

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 (echo).

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

Waarschuwing

Neem redelijke voorzorgsmaatregelen bij het gebruik van de Invoke-Expression cmdlet in scripts. Wanneer u gebruikt Invoke-Expression om een opdracht uit te voeren die de gebruiker invoert, controleert u of de opdracht veilig kan worden uitgevoerd voordat u deze uitvoert. Over het algemeen is het het beste om uw script te ontwerpen met vooraf gedefinieerde invoeropties, in plaats van vrije-vorminvoer toe te staan.

Voorbeelden

Voorbeeld 1: Een expressie evalueren

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

Voorbeeld 2: Een script uitvoeren op de lokale computer

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

Deze opdrachten worden gebruikt Invoke-Expression voor het uitvoeren van een script, TestScript.ps1, op de lokale computer. De twee opdrachten zijn gelijkwaardig. De eerste gebruikt de parameter Command om de opdracht op te geven die moet worden uitgevoerd. De tweede maakt gebruik van een pijplijnoperator (|) om de opdrachtreeks te verzenden naar Invoke-Expression.

Voorbeeld 3: Een opdracht uitvoeren in een variabele

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

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

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

Voorbeeld 4: Help-voorbeeld van cmdlet ophalen en uitvoeren

$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 in het Help-onderwerp van de Get-EventLog cmdlet opgehaald en uitgevoerd.

Als u een voorbeeld van een andere cmdlet wilt uitvoeren, wijzigt u de waarde van de $Cmdlet_name variabele 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.

Notitie

Als de voorbeeldcode van het Help-bestand uitvoer bevat in het voorbeeld, probeert PowerShell de uitvoer samen met de code uit te voeren en wordt er een fout gegenereerd.

Parameters

-Command

Hiermee geeft u de opdracht of expressie die moet worden uitgevoerd. Typ de opdracht of expressie of voer een variabele in die de opdracht of expressie bevat. De parameter Command is vereist.

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

Invoerwaarden

System.String or PSObject

U kunt een object dat de opdracht vertegenwoordigt doorsluist naar Invoke-Expression. Gebruik de $Input automatische variabele om de invoerobjecten in de opdracht weer te geven.

Uitvoerwaarden

PSObject

Retourneert de uitvoer die wordt gegenereerd door de aangeroepen opdracht (de waarde van de parameter Command ).

Notities

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_Operators voor meer informatie.