Start-Process

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

Cmdleten Start-Process startar en eller flera processer på den lokala datorn. Som standard skapar Start-Process en ny process som ärver alla miljövariabler som definieras i den aktuella processen.

Ange programmet som körs i processen genom att ange en körbar fil eller skriptfil eller en fil som kan öppnas med ett program på datorn. Om du anger en fil som inte kan köras startar Start-Process programmet som är associerat med filen, ungefär som cmdleten Invoke-Item.

Du kan använda parametrarna för Start-Process för att ange alternativ, till exempel att läsa in en användarprofil, starta processen i ett nytt fönster eller använda alternativa autentiseringsuppgifter.

Det här exemplet startar en process som använder Sort.exe-filen i den aktuella mappen. Kommandot använder alla standardvärden, inklusive standardfönsterformatet, arbetsmappen och autentiseringsuppgifterna.

Start-Process -FilePath "sort.exe"

Det här exemplet startar en process som skriver ut C:\PS-Test\MyFile.txt-filen.

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

Det här exemplet startar en process som sorterar objekt i TestSort.txt-filen och returnerar de sorterade objekten i Sorted.txt-filerna. Eventuella fel skrivs till filen SortError.txt. Parametern UseNewEnvironment anger att processen körs med egna miljövariabler.

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

Det här exemplet använder splatting för att skicka parametrar till cmdleten. Mer information finns i about_Splatting.

Det här exemplet startar Notepad.exe processen. Det maximerar fönstret och behåller fönstret tills processen är klar.

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

Det här exemplet startar PowerShell med alternativet Kör som administratör.

Start-Process -FilePath "powershell" -Verb RunAs

Det här exemplet visar hur du hittar de verb som kan användas när du startar en process. De tillgängliga verben bestäms av filnamnstillägget för filen som körs i processen.

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

open
runas
runasuser

I exemplet används New-Object för att skapa ett System.Diagnostics.ProcessStartInfo-objekt för powershell.exe, filen som körs i PowerShell-processen. Egenskapen Verbs för objektet ProcessStartInfo visar att du kan använda verben Öppna och RunAs med powershell.exe, eller med en process som kör en .exe fil.

Båda kommandona startar Windows-kommandotolken och utfärdar ett dir kommando i mappen Program Files. Eftersom det här mappnamnet innehåller ett blanksteg måste värdet omges av undantagna citattecken. Observera att det första kommandot anger en sträng som ArgumentList. Det andra kommandot är en strängmatris.

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

I Windows skapar Start-Process en oberoende process som fortfarande körs oberoende av startgränssnittet. På plattformar som inte är Windows-plattformar är den nyligen startade processen kopplad till gränssnittet som startades. Om startgränssnittet stängs avslutas den underordnade processen.

För att undvika att avsluta den underordnade processen på Unix-liknande plattformar kan du kombinera Start-Process med nohup. I följande exempel startas en bakgrundsinstans av PowerShell på Linux som håller sig vid liv även efter att du har stängt startsessionen. Kommandot nohup samlar in utdata i filen nohup.out i den aktuella katalogen.

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

I det här exemplet kör Start-Process kommandot Linux nohup, som startar pwsh som en frånkopplad process. Mer information finns i artikeln nohup på Wikipedia.

När du använder Start-Processskapas som standard den nya processen med samma miljövariabler som den aktuella sessionen. Du kan använda parametern Environment för att åsidosätta värdena för dessa variabler.

I det här exemplet läggs miljövariabeln FOO till i sessionen med foo som värde.

Exemplet körs Start-Process tre gånger och returnerar värdet för FOO varje gång. Det första kommandot åsidosätter inte miljövariabeln. I det andra kommandot är FOO inställt på bar. I det tredje kommandot är FOO inställt på $null, vilket tar bort det.

$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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan inte skicka objekt till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett Process-objekt.

PowerShell innehåller följande alias för Start-Process:

• Alla plattformar
  • saps
• Windows
  • start

Interna kommandon är körbara filer som är installerade i operativsystemet. Dessa körbara filer kan köras från valfritt kommandoradsgränssnitt, till exempel PowerShell. Vanligtvis kör du kommandot precis som i bash eller cmd.exe. Cmdleten Start-Process kan användas för att köra inbyggda kommandon, men bör endast användas när du behöver styra hur kommandot körs.

Start-Process är användbart för att köra GUI-program på icke-Windows-plattformar. Kör till exempel Start-Process gedit för att starta den grafiska textredigeraren som är gemensam för GNOME Desktop-miljöerna.

Som standard startar Start-Process en process asynkront. Kontrollen returneras omedelbart till PowerShell även om den nya processen fortfarande körs.

• I det lokala systemet lever den lanserade processen på oberoende av samtalsprocessen.
• I ett fjärrsystem avslutas den nya processen när fjärrsessionen avslutas, omedelbart efter kommandot Start-Process. Därför kan du inte använda Start-Process i en fjärrsession som förväntar sig att den startade processen ska överleva sessionen.

Om du behöver använda Start-Process i en fjärrsession anropar du den med parametern Wait. Du kan också använda andra metoder för att skapa en ny process i fjärrsystemet.

När du använder parametern Wait väntar Start-Process på att processträdet (processen och alla dess underordnade) ska avslutas innan kontrollen returneras. Detta skiljer sig från beteendet för cmdleten Wait-Process, som bara väntar på att de angivna processerna ska avslutas.

I Windows är det vanligaste användningsfallet för Start-Process att använda parametern Wait för att blockera förloppet tills den nya processen avslutas. I icke-Windows-system behövs detta sällan eftersom standardbeteendet för kommandoradsprogram motsvarar Start-Process -Wait.

Den här cmdleten implementeras med hjälp av metoden Start i klassen System.Diagnostics.Process. Mer information om den här metoden finns i Process.Start-metoden.