Dela via


Start-Process

Startar en eller flera processer på den lokala datorn.

Syntax

Default (Standard)

Start-Process
    [-FilePath] <string>
    [[-ArgumentList] <string[]>]
    [-Credential <pscredential>]
    [-WorkingDirectory <string>]
    [-LoadUserProfile]
    [-NoNewWindow]
    [-PassThru]
    [-RedirectStandardError <string>]
    [-RedirectStandardInput <string>]
    [-RedirectStandardOutput <string>]
    [-WindowStyle <ProcessWindowStyle>]
    [-Wait]
    [-UseNewEnvironment]
    [<CommonParameters>]

UseShellExecute

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

Description

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.

Exempel

Exempel 1: Starta en process som använder standardvärden

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"

Exempel 2: Skriv ut en textfil

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

Exempel 3: Starta en process för att sortera objekt till en ny fil

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.

Exempel 4: Starta en process i ett maximerat fönster

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

Exempel 5: Starta PowerShell som administratör

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

Start-Process -FilePath "powershell" -Verb RunAs

Exempel 6: Använda olika verb för att starta en process

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.

Exempel 7: Ange argument i processen

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`""

Parametrar

-ArgumentList

Anger parametrar eller parametervärden som ska användas när den här cmdleten startar processen. Argument kan accepteras som en enskild sträng med argument avgränsade med blanksteg eller som en matris med strängar avgränsade med kommatecken. Cmdleten sammanfogar matrisen till en enda sträng med varje element i matrisen avgränsat med ett enda blanksteg.

De yttre citatteckna för PowerShell-strängarna ingår inte när ArgumentList- värden skickas till den nya processen. Om parametrar eller parametervärden innehåller ett blanksteg eller citattecken måste de omges av undantagna dubbla citattecken. Mer information finns i about_Quoting_Rules.

För bästa resultat använder du ett enda ArgumentList- värde som innehåller alla argument och eventuella citattecken som behövs.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Argument

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Credential

Anger ett användarkonto som har behörighet att utföra den här åtgärden. Som standard använder cmdleten den aktuella användarens autentiseringsuppgifter.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt som genereras av cmdleten Get-Credential. Om du skriver ett användarnamn uppmanas du att ange lösenordet.

Autentiseringsuppgifter lagras i ett PSCredential--objekt och lösenordet lagras som en SecureString-.

Anmärkning

Mer information om SecureString dataskydd finns i Hur säker är SecureString?.

Parameteregenskaper

Typ:PSCredential
Standardvärde:Current user
Stöder jokertecken:False
DontShow:False
Alias:RunAs

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FilePath

Anger den valfria sökvägen och filnamnet för programmet som körs i processen. Ange namnet på en körbar fil eller ett dokument, till exempel en .txt eller .doc fil som är associerad med ett program på datorn. Den här parametern krävs.

Om du bara anger ett filnamn använder du parametern WorkingDirectory för att ange sökvägen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-LoadUserProfile

Anger att den här cmdleten läser in Windows-användarprofilen som lagras i HKEY_USERS registernyckeln för den aktuella användaren.

Den här parametern påverkar inte PowerShell-profilerna. Mer information finns i about_Profiles.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Lup

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NoNewWindow

Starta den nya processen i det aktuella konsolfönstret. Som standard i Windows öppnar PowerShell ett nytt fönster.

Du kan inte använda parametrarna NoNewWindow och WindowStyle i samma kommando.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Sydlig

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PassThru

Returnerar ett processobjekt för varje process som cmdleten startade. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RedirectStandardError

Anger en fil. Den här cmdleten skickar eventuella fel som genereras av processen till en fil som du anger. Ange sökvägen och filnamnet. Som standard visas felen i konsolen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RSE

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RedirectStandardInput

Anger en fil. Den här cmdleten läser indata från den angivna filen. Ange sökvägen och filnamnet för indatafilen. Som standard hämtar processen sina indata från tangentbordet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RSI

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-RedirectStandardOutput

Anger en fil. Den här cmdleten skickar utdata som genereras av processen till en fil som du anger. Ange sökvägen och filnamnet. Som standard visas utdata i konsolen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:RSO

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UseNewEnvironment

Anger att den här cmdleten använder nya miljövariabler som angetts för processen. Som standard körs den startade processen med miljövariablerna som ärvts från den överordnade processen.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Default
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Verb

Anger ett verb som ska användas när den här cmdleten startar processen. De verb som är tillgängliga bestäms av filnamnstillägget för filen som körs i processen.

I följande tabell visas verben för några vanliga processfiltyper.

Filtyp Verb
.cmd Edit, Open, Print, , , RunAsRunAsUser
.exe Open, , RunAsRunAsUser
.txt Open, , PrintPrintTo
.wav Open, Play

Om du vill hitta de verb som kan användas med filen som körs i en process använder du cmdleten New-Object för att skapa ett System.Diagnostics.ProcessStartInfo- objekt för filen. Tillgängliga verb finns i egenskapen Verbs för objektet ProcessStartInfo. Mer information finns i exemplen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

UseShellExecute
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Wait

Anger att denna cmdlet väntar på att den angivna processen och dess underordnade ska slutföras innan fler indata accepteras. Den här parametern utelämnar kommandotolken eller behåller fönstret tills processerna har slutförts.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WindowStyle

Anger tillståndet för fönstret som används för den nya processen. Standardvärdet är Normal. De godtagbara värdena för den här parametern är:

  • Normal
  • Hidden
  • Minimized
  • Maximized

Du kan inte använda parametrarna WindowStyle och NoNewWindow i samma kommando.

Parameteregenskaper

Typ:ProcessWindowStyle
Standardvärde:None
Godkända värden:Normal, Hidden, Minimized, Maximized
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WorkingDirectory

Anger den plats som den nya processen ska starta i. Standardvärdet är platsen för den körbara fil eller dokument som startas. Jokertecken stöds inte. Sökvägen får inte innehålla tecken som skulle tolkas som jokertecken.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

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.

Indata

None

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

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

Process

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

Kommentarer

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

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

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.