Start-Process

Syntax

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

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

Beschreibung

Das Start-Process Cmdlet startet einen oder mehrere Prozesse auf dem lokalen Computer. Erstellt standardmäßig einen neuen Prozess, Start-Process der alle Umgebungsvariablen erbt, die im aktuellen Prozess definiert sind.

Um das Programm anzugeben, das im Prozess ausgeführt wird, geben Sie eine ausführbare Datei oder Skriptdatei oder eine Datei ein, die mit einem Programm auf dem Computer geöffnet werden kann. Wenn Sie eine nicht ausführbare Datei angeben, Start-Process startet das Programm, das der Datei zugeordnet ist, ähnlich dem Invoke-Item Cmdlet.

Sie können die Parameter Start-Process verwenden, um Optionen anzugeben, z. B. das Laden eines Benutzerprofils, das Starten des Prozesses in einem neuen Fenster oder die Verwendung alternativer Anmeldeinformationen.

Beispiele

Beispiel 1: Starten eines Prozesses, der Standardwerte verwendet

In diesem Beispiel wird ein Prozess gestartet, der die Sort.exe Datei im aktuellen Ordner verwendet. Der Befehl verwendet alle Standardwerte, einschließlich des Standardfensterstils, des Arbeitsordners und der Anmeldeinformationen.

Start-Process -FilePath "sort.exe"

Beispiel 2: Drucken einer Textdatei

In diesem Beispiel wird ein Prozess gestartet, der die C:\PS-Test\MyFile.txt Datei druckt.

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

Beispiel 3: Starten eines Prozesses zum Sortieren von Elementen in eine neue Datei

In diesem Beispiel wird ein Prozess gestartet, der Elemente in der TestSort.txt Datei sortiert und die sortierten Elemente in den Sorted.txt Dateien zurückgibt. Alle Fehler werden in die SortError.txt Datei geschrieben. Der Parameter UseNewEnvironment gibt an, dass der Prozess mit eigenen Umgebungsvariablen ausgeführt wird.

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

In diesem Beispiel wird das Splatting verwendet, um Parameter an das Cmdlet zu übergeben. Weitere Informationen finden Sie unter about_Splatting.

Beispiel 4: Starten eines Prozesses in einem maximierten Fenster

In diesem Beispiel wird der Notepad.exe Prozess gestartet. Das Fenster wird maximiert und beibehalten, bis der Prozess abgeschlossen wurde.

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

Beispiel 5: Starten von PowerShell als Administrator

In diesem Beispiel wird PowerShell mit der Option "Als Administrator ausführen" gestartet.

Start-Process -FilePath "powershell" -Verb RunAs

Beispiel 6: Verwenden verschiedener Verben zum Starten eines Prozesses

In diesem Beispiel wird gezeigt, wie Sie die Verben finden, die beim Starten eines Prozesses verwendet werden können. Die verfügbaren Verben werden durch die Dateinamenerweiterung der Datei bestimmt, die im Prozess ausgeführt wird.

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

open
runas
runasuser

Im Beispiel wird New-Object ein System.Diagnostics.ProcessStartInfo -Objekt für powershell.exedie Datei erstellt, die im PowerShell-Prozess ausgeführt wird. Die Verbs-Eigenschaft des ProcessStartInfo-Objekts zeigt, dass Sie die Open - und RunAs Verben mit powershell.exeoder mit einem beliebigen Prozess verwenden können, der eine .exe Datei ausführt.

Beispiel 7: Angeben von Argumenten für den Prozess

Beide Befehle starten den Windows-Befehlsdolmetscher und geben einen dir Befehl im Program Files Ordner aus. Da dieser Ordnername ein Leerzeichen enthält, muss der Wert in Escapezeichen eingeschlossen sein. Beachten Sie, dass der erste Befehl eine Zeichenfolge als ArgumentList angibt. Der zweite Befehl ist ein Zeichenfolgenarray.

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

Beispiel 8: Erstellen eines getrennten Prozesses unter Linux

Unter Windows wird ein unabhängiger Prozess erstellt, Start-Process der unabhängig von der Startshell ausgeführt wird. Auf Nicht-Windows-Plattformen wird der neu gestartete Prozess an die gestartete Shell angefügt. Wenn die Startshell geschlossen ist, wird der untergeordnete Prozess beendet.

Um das Beenden des untergeordneten Prozesses auf Unix-ähnlichen Plattformen zu vermeiden, können Start-Process Sie mit nohup. Im folgenden Beispiel wird eine Hintergrundinstanz von PowerShell unter Linux gestartet, die auch nach dem Schließen der Startsitzung aktiv bleibt. Der nohup Befehl sammelt die Ausgabe in der Datei nohup.out im aktuellen Verzeichnis.

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

In diesem Beispiel Start-Process wird der Linux-Befehl nohup ausgeführt, der als getrennter Prozess gestartet wird pwsh . Weitere Informationen finden Sie im Nohup-Artikel auf Wikipedia.

Beispiel 9: Überschreiben einer Umgebungsvariable für einen Prozess

Bei Verwendung Start-Processwird der neue Prozess standardmäßig mit den gleichen Umgebungsvariablen wie die aktuelle Sitzung erstellt. Sie können den Parameter Environment verwenden, um die Werte dieser Variablen außer Kraft zu setzen.

In diesem Beispiel wird die Umgebungsvariable FOO der Sitzung als foo Wert hinzugefügt.

Das Beispiel wird dreimal ausgeführt Start-Process , wobei der Wert FOO jedes Mal zurückgegeben wird. Der erste Befehl überschreibt die Umgebungsvariable nicht. Im zweiten Befehl FOO ist auf bar. Im dritten Befehl FOO ist dieser Befehl auf $null", der sie entfernt.

$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

Parameter

-ArgumentList

-Confirm

-Credential

-Environment

-FilePath

-LoadUserProfile

-NoNewWindow

-PassThru

-RedirectStandardError

-RedirectStandardInput

-RedirectStandardOutput

-UseNewEnvironment

-Verb

-Wait

-WhatIf

-WindowStyle

-WorkingDirectory

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

Process

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet ein Process-Objekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Start-Process:

• Alle Plattformen
  • saps
• Windows
  • start

Systemeigene Befehle sind ausführbare Dateien, die im Betriebssystem installiert sind. Diese ausführbaren Dateien können über jede Befehlszeilenshell wie PowerShell ausgeführt werden. In der Regel führen Sie den Befehl genau wie in bash oder cmd.exe aus. Das Start-Process Cmdlet kann verwendet werden, um systemeigene Befehle auszuführen, sollte jedoch nur verwendet werden, wenn Sie steuern müssen, wie der Befehl ausgeführt wird.

Start-Process ist nützlich für die Ausführung von GUI-Programmen auf Nicht-Windows-Plattformen. Führen Sie z. B. die Ausführung Start-Process gedit aus, um den grafischen Text-Editor zu starten, der die DESKTOP-Umgebungen VON SHAPES verwendet.

Startet standardmäßig Start-Process asynchron einen Prozess. Die Steuerung wird sofort an PowerShell zurückgegeben, auch wenn der neue Prozess noch ausgeführt wird.

• Im lokalen System lebt der gestartete Prozess unabhängig vom Aufrufprozess.
• Auf einem Remotesystem wird der neue Prozess beendet, wenn die Remotesitzung endet, unmittelbar nach dem Start-Process Befehl. Daher können Sie in einer Remotesitzung nicht verwenden Start-Process , dass der gestartete Prozess die Sitzung überdauert.

Wenn Sie in einer Remotesitzung verwenden Start-Process müssen, rufen Sie sie mit dem Wait-Parameter auf. Sie können auch andere Methoden verwenden, um einen neuen Prozess auf dem Remotesystem zu erstellen.

Wenn Sie den Wait-Parameter verwenden, Start-Process wartet die Prozessstruktur (der Prozess und alle untergeordneten Elemente) vor dem Zurückgeben des Steuerelements auf das Beenden. Dies unterscheidet sich vom Verhalten des Wait-Process Cmdlets, das nur auf das Beenden der angegebenen Prozesse wartet.

Unter Windows besteht der am häufigsten verwendete Anwendungsfall darin Start-Process , den Status mithilfe des Wait-Parameters zu blockieren, bis der neue Prozess beendet wird. Auf nicht-Windows-Systemen ist dies selten erforderlich, da das Standardverhalten für Befehlszeilenanwendungen gleichbedeutend Start-Process -Waitist.

Dieses Cmdlet wird mithilfe der Startmethode der System.Diagnostics.Process-Klasse implementiert. Weitere Informationen zu dieser Methode finden Sie unter Process.Start-Methode.

Ähnliche Themen

• about_Quoting_Rules
• Debug-Process
• Get-Process
• Start-Service
• Stop-Process
• Wait-Process