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.

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

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

-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".)

-NoNewWindow

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

-PassThru

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

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

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

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

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

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

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

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

-WorkingDirectory <string>

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

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

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