Start-Process

Start-Process
    [-FilePath] <string>
    [[-ArgumentList] <string[]>]
    [-WorkingDirectory <string>]
    [-PassThru]
    [-Verb <string>]
    [-WindowStyle <ProcessWindowStyle>]
    [-Wait]
    [-Environment <hashtable>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

De cmdlet Start-Process start een of meer processen op de lokale computer. Standaard maakt Start-Process een nieuw proces dat alle omgevingsvariabelen over neemt die zijn gedefinieerd in het huidige proces.

Als u het programma wilt opgeven dat in het proces wordt uitgevoerd, voert u een uitvoerbaar bestand of scriptbestand in of een bestand dat kan worden geopend met behulp van een programma op de computer. Als u een niet-uitvoerbaar bestand opgeeft, start Start-Process het programma dat is gekoppeld aan het bestand, vergelijkbaar met de Invoke-Item cmdlet.

U kunt de parameters van Start-Process gebruiken om opties op te geven, zoals het laden van een gebruikersprofiel, het starten van het proces in een nieuw venster of het gebruik van alternatieve referenties.

In dit voorbeeld wordt een proces gestart dat gebruikmaakt van het Sort.exe-bestand in de huidige map. De opdracht gebruikt alle standaardwaarden, waaronder de standaardvensterstijl, de werkmap en referenties.

Start-Process -FilePath "sort.exe"

In dit voorbeeld wordt een proces gestart waarmee het C:\PS-Test\MyFile.txt-bestand wordt afgedrukt.

Start-Process -FilePath "myfile.txt" -WorkingDirectory "C:\PS-Test" -Verb Print

In dit voorbeeld wordt een proces gestart waarmee items in het TestSort.txt bestand worden gesorteerd en de gesorteerde items in de Sorted.txt bestanden worden geretourneerd. Eventuele fouten worden naar het SortError.txt-bestand geschreven. De parameter UseNewEnvironment geeft aan dat het proces wordt uitgevoerd met zijn eigen omgevingsvariabelen.

$processOptions = @{
    FilePath = "sort.exe"
    RedirectStandardInput = "TestSort.txt"
    RedirectStandardOutput = "Sorted.txt"
    RedirectStandardError = "SortError.txt"
    UseNewEnvironment = $true
}
Start-Process @processOptions

In dit voorbeeld wordt splatting gebruikt om parameters door te geven aan de cmdlet. Zie about_Splattingvoor meer informatie.

In dit voorbeeld wordt het Notepad.exe proces gestart. Het venster wordt gemaximaliseerd en het venster behouden totdat het proces is voltooid.

Start-Process -FilePath "notepad" -Wait -WindowStyle Maximized

In dit voorbeeld wordt PowerShell gestart met behulp van de optie Als administrator uitvoeren als administrator.

Start-Process -FilePath "powershell" -Verb RunAs

In dit voorbeeld ziet u hoe u de werkwoorden kunt vinden die kunnen worden gebruikt bij het starten van een proces. De beschikbare werkwoorden worden bepaald door de bestandsnaamextensie van het bestand dat in het proces wordt uitgevoerd.

$startExe = New-Object System.Diagnostics.ProcessStartInfo -Args powershell.exe
$startExe.Verbs

open
runas
runasuser

In het voorbeeld wordt New-Object gebruikt om een System.Diagnostics.ProcessStartInfo--object te maken voor powershell.exe, het bestand dat wordt uitgevoerd in het PowerShell-proces. De eigenschap Werkwoorden van het object ProcessStartInfo geeft aan dat u de en RunAs werkwoorden kunt gebruiken met powershell.exeof met een proces waarmee een .exe bestand wordt uitgevoerd.

Beide opdrachten starten de Windows-opdracht-interpreter, die een dir opdracht uitgeeft in de Program Files map. Omdat deze mapnaam een spatie bevat, moet de waarde tussen escape-aanhalingstekens staan. Houd er rekening mee dat met de eerste opdracht een tekenreeks wordt opgegeven als ArgumentList. De tweede opdracht is een tekenreeksmatrix.

Start-Process -FilePath "$Env:ComSpec" -ArgumentList "/c dir `"%SystemDrive%\Program Files`""
Start-Process -FilePath "$Env:ComSpec" -ArgumentList "/c","dir","`"%SystemDrive%\Program Files`""

In Windows maakt Start-Process een onafhankelijk proces dat onafhankelijk van de startshell wordt uitgevoerd. Op niet-Windows-platforms wordt het zojuist gestarte proces gekoppeld aan de shell die is gestart. Als de startshell is gesloten, wordt het onderliggende proces beëindigd.

Om te voorkomen dat het onderliggende proces op Unix-achtige platforms wordt beëindigd, kunt u Start-Process combineren met nohup. In het volgende voorbeeld wordt een achtergrondexemplaren van PowerShell in Linux gestart, zelfs nadat u de startsessie hebt gesloten. De opdracht nohup verzamelt uitvoer in bestand nohup.out in de huidige map.

# Runs for 2 minutes and appends output to ./nohup.out
Start-Process nohup 'pwsh -NoProfile -c "1..120 | % { Write-Host . -NoNewline; sleep 1 }"'

In dit voorbeeld voert Start-Process de opdracht Linux nohup uit, waarmee pwsh wordt gestart als een losgekoppeld proces. Zie het artikel nohup op Wikipedia voor meer informatie.

Wanneer u Start-Processgebruikt, wordt het nieuwe proces standaard gemaakt met dezelfde omgevingsvariabelen als de huidige sessie. U kunt de parameter Environment gebruiken om de waarden van deze variabelen te overschrijven.

In dit voorbeeld wordt de omgevingsvariabele FOO toegevoegd aan de sessie met foo als de waarde.

In het voorbeeld wordt Start-Process drie keer uitgevoerd en wordt elke keer de waarde van FOO geretourneerd. De eerste opdracht overschrijft de omgevingsvariabele niet. In de tweede opdracht is FOO ingesteld op bar. In de derde opdracht is FOO ingesteld op $null, waardoor deze wordt verwijderd.

$Env:FOO = 'foo'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$Env:FOO'
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$Env:FOO' -Environment @{
    FOO  = 'bar'
}
Start-Process pwsh -NoNewWindow -ArgumentList '-c', '$Env:FOO' -Environment @{
    FOO  = $null
}

foo
bar

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 geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een Process-object.

PowerShell bevat de volgende aliassen voor Start-Process:

• Alle platforms
  • saps
• Windows
  • start

Systeemeigen opdrachten zijn uitvoerbare bestanden die zijn geïnstalleerd in het besturingssysteem. Deze uitvoerbare bestanden kunnen worden uitgevoerd vanuit elke opdrachtregelshell, zoals PowerShell. Meestal voert u de opdracht precies zo uit als in bash of cmd.exe. De Start-Process cmdlet kan worden gebruikt om systeemeigen opdrachten uit te voeren, maar moet alleen worden gebruikt wanneer u wilt bepalen hoe de opdracht wordt uitgevoerd.

Start-Process is handig voor het uitvoeren van GUI-programma's op niet-Windows-platforms. Voer bijvoorbeeld Start-Process gedit uit om de grafische teksteditor te starten die gemeenschappelijk is voor de BUREAUBLADomgevingen VAN KABOUT.

Standaard start Start-Process een proces asynchroon. Control wordt direct teruggezet naar PowerShell, zelfs als het nieuwe proces nog steeds wordt uitgevoerd.

• Op het lokale systeem bevindt het gestarte proces zich onafhankelijk van het aanroepende proces.
• Op een extern systeem wordt het nieuwe proces beëindigd wanneer de externe sessie wordt beëindigd, onmiddellijk na de opdracht Start-Process. Daarom kunt u Start-Process niet gebruiken in een externe sessie die verwacht dat het gestarte proces de sessie overleeft.

Als u Start-Process in een externe sessie moet gebruiken, roept u deze aan met de parameter Wait. U kunt ook andere methoden gebruiken om een nieuw proces op het externe systeem te maken.

Wanneer u de parameter Wait gebruikt, wacht Start-Process totdat de processtructuur (het proces en alle bijbehorende afstammelingen) wordt afgesloten voordat de controle wordt geretourneerd. Dit verschilt van het gedrag van de Wait-Process cmdlet, die alleen wacht tot de opgegeven processen zijn afgesloten.

In Windows is het meest voorkomende gebruiksvoorbeeld voor Start-Process het gebruik van de parameter Wait om de voortgang te blokkeren totdat het nieuwe proces wordt afgesloten. In het niet-Windows-systeem is dit zelden nodig omdat het standaardgedrag voor opdrachtregeltoepassingen gelijk is aan Start-Process -Wait.

Deze cmdlet wordt geïmplementeerd met behulp van de methode Start van de klasse System.Diagnostics.Process. Zie Process.Start Methodvoor meer informatie over deze methode.