Start-Process

Startet einen oder mehrere Prozesse auf dem lokalen Computer.

Syntax

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

Start-Process [-FilePath] <string> [[-ArgumentList] <string[]>] [-PassThru] [-Verb <string>] [-Wait] [-WindowStyle {<Normal> | <Hidden> | <Minimized> | <Maximized>}] [-WorkingDirectory <string>] [<CommonParameters>]

Beschreibung

Startet einen oder mehrere Prozesse auf dem lokalen Computer. Geben Sie zum Angeben des Programms, das im Prozess ausgeführt wird, eine ausführbare Datei oder Skriptdatei oder eine Datei an, die mit einem Programm auf dem Computer geöffnet werden kann. Wenn Sie eine nicht ausführbare Datei angeben, startet Start-Process das Programm, das der Datei zugeordnet ist, vergleichbar mit dem Cmdlet "Invoke-Item".

Sie können mit den Parametern von Start-Process Optionen angeben, z. B. das Laden eines Benutzerprofils, Starten des Prozesses in einem neuen Fenster oder Verwenden von alternativen Anmeldeinformationen.

Parameter

-ArgumentList <string[]>

Gibt Parameter oder Parameterwerte an, die beim Starten des Prozesses verwendet werden sollen. Der Parametername ("Arguments") ist optional.

Erforderlich?	false
Position?	2
Standardwert	Keiner
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Credential <PSCredential>

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01", oder geben Sie ein PSCredential-Objekt ein, z. B. ein Objekt aus dem Cmdlet "Get-Credential". Standardmäßig verwendet das Cmdlet die Anmeldeinformationen des aktuellen Benutzers.

Erforderlich?	false
Position?	named
Standardwert	Aktueller Benutzer.
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-FilePath <string>

Gibt den Pfad (optional) und den Dateinamen des Programms an, das im Prozess ausgeführt wird. Geben Sie den Namen einer ausführbaren Datei oder eines Dokuments ein, z. B. für eine TXT-Datei oder DOC-Datei, die einem Programm auf dem Computer zugeordnet ist. Dieser Parameter ist erforderlich.

Wenn Sie nur einen Dateinamen angeben, geben Sie den Pfad mithilfe des WorkingDirectory-Parameters an.

Erforderlich?	true
Position?	1
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-LoadUserProfile

Lädt das im Registrierungsschlüssel HKEY_USERS für den aktuellen Benutzer gespeicherte Windows-Benutzerprofil. Der Standardwert ist FALSE.

Dieser Parameter hat keine Auswirkungen auf die Windows PowerShell-Profile. (Siehe "about_Profiles".)

Erforderlich?	false
Position?	named
Standardwert	False
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-NoNewWindow

Verhindert, dass der Prozess in einem neuen Fenster ausgeführt wird. Standardmäßig wird der Prozess in einem neuen Fenster ausgeführt.

Erforderlich?	false
Position?	named
Standardwert	False
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-PassThru

Gibt ein Prozessobjekt für jeden Prozess zurück, der vom Cmdlet gestartet wurde. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Erforderlich?	false
Position?	named
Standardwert	False
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RedirectStandardError <string>

Sendet alle Fehler, die vom Prozess generiert werden, in eine von Ihnen angegebene Datei. Geben Sie den Pfad und den Dateinamen ein. Standardmäßig werden die Fehler in der Konsole angezeigt.

Erforderlich?	false
Position?	named
Standardwert	Fehler werden in der Konsole angezeigt.
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RedirectStandardInput <string>

Liest die Eingabe aus der angegebenen Datei. Geben Sie Pfad und Dateiname der Eingabedatei ein. Standardmäßig ruft der Prozess die Eingabe von der Tastatur ab.

Erforderlich?	false
Position?	named
Standardwert	Tastatur
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-RedirectStandardOutput <string>

Sendet die Ausgabe, die vom Prozess generiert wird, in eine von Ihnen angegebene Datei. Geben Sie den Pfad und den Dateinamen ein. Standardmäßig wird die Ausgabe in der Konsole angezeigt.

Erforderlich?	false
Position?	named
Standardwert	FALSE
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UseNewEnvironment

Verwenden Sie für den Prozess angegebene neue Umgebungsvariablen. Standardmäßig wird der gestartete Prozess mit den für den Computer und den Benutzer angegebenen Umgebungsvariablen ausgeführt.

Erforderlich?	false
Position?	named
Standardwert	False
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Verb <string>

Gibt ein Verb an, das beim Starten des Prozesses verwendet werden soll, z. B. "Edit", "Open" oder "Print".

Jeder Dateityp verfügt über einen Satz von Verben, die Sie verwenden können. Mit der Verbs-Eigenschaft des Objekts können Sie die Verben ermitteln, die für den Prozess verwendet werden können.

Erforderlich?	false
Position?	named
Standardwert
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Wait

Wartet, bis der angegebene Prozess abgeschlossen wurde, bevor weitere Eingaben angenommen werden. Dieser Parameter unterdrückt die Eingabeaufforderung oder behält das Fenster bei, bis der Prozess abgeschlossen wurde.

Erforderlich?	false
Position?	named
Standardwert	False
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WindowStyle <ProcessWindowStyle>

Gibt den Status der für den Prozess verwendeten Fenster an. Gültige Werte sind "Normal", "Hidden", "Minimized" und "Maximized". Der Standardwert ist "Normal".

Erforderlich?	false
Position?	named
Standardwert	Normal
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-WorkingDirectory <string>

Gibt den Speicherort der ausführbaren Datei oder des Dokuments, das im Prozess ausgeführt wird. Der Standardwert ist das aktuelle Verzeichnis.

Erforderlich?	false
Position?	named
Standardwert	Aktuelles Verzeichnis
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben	Keiner Eingaben können nicht über die Pipeline an Start-Process übergeben werden.
Ausgaben	Keiner oder System.Diagnostics.Process Wenn Sie den PassThru-Parameter verwenden, generiert Start-Process einen System.Diagnostics.Process. Andernfalls wird von diesem Cmdlet keine Ausgabe zurückgegeben.

Hinweise

Dieses Cmdlet wird mit der Start-Methode der System.Diagnostics.Process-Klasse implementiert. Weitere Informationen zu dieser Methode finden Sie unter "Process.Start-Methode" in der MSDN Library (Microsoft Developer Network) unter "https://go.microsoft.com/fwlink/?LinkId=143602" (möglicherweise auf Englisch).

Beispiel 1

C:\PS>start-process sort.exe

Beschreibung
-----------
Dieser Befehl startet einen Prozess, der die Datei "Sort.exe" im aktuellen Verzeichnis verwendet. Der Befehl verwendet alle Standardwerte, einschließlich Standardfensterstil, Arbeitsverzeichnis und Anmeldeinformationen.

Beispiel 2

C:\PS>start-process myfile.txt -workingdirectory "C:\PS-Test" -verb Print

Beschreibung
-----------
Dieser Befehl startet einen Prozess, der die Datei "C:\PS-Test\MyFile.txt" druckt.

Beispiel 3

C:\PS>start-process Sort.exe -RedirectStandardInput Testsort.txt -RedirectStandardOutput Sorted.txt -RedirectStandardError SortError.txt -UseNewEnvironment

Beschreibung
-----------
Dieser Befehl startet einen Prozess, der Elemente in der Datei "Testsort.txt" sortiert und die sortierten Elemente in den "Sorted.txt"-Dateien zurückgibt. Alle Fehler werden in die Datei "SortError.txt" geschrieben. 

Der UseNewEnvironment-Parameter gibt an, dass der Prozess mit seinen eigenen Umgebungsvariablen ausgeführt wird.

Beispiel 4

C:\PS>start-process notepad -wait -windowstyle Maximized

Beschreibung
-----------
Dieser Befehl startet den Editor-Prozess. Das Fenster wird maximiert und beibehalten, bis der Prozess abgeschlossen wurde.

Siehe auch

Konzepte

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