Start-Program
PackageDeployment Modul Hilfe |
Package Deployment Module |
Start-Program Cmdlet |
Version 3.1.0.0 |
Start-Program
Übersicht
Programm ausführen
Syntax
Start-Program [-Command] <String> [[-WorkingDirectory] <String>] [[-ExitCodeVariable] <String>] [-ContinueOnError] [-SecureParameters] [-Wait] [-Wow64] [[-MaxWaitMinutes] <String>] [[-Context] <String>] [<CommonParameters>]
Beschreibung
Führt ein DOS- oder Windows-Programm aus. Der ExecuteEx-Befehl kann im Gegensatz zum Execute-Befehl serverseitige und lokale Anwendungen ausführen. Das Ergebnis wird über eine Variable ausgegeben und kann dann weiterverwendet werden.
Der Befehl startet das angegebene Programm, Startparameter werden unterstützt. Die Erweiterung EXE muss angegeben werden, sonst kann NetInstall aufgrund der Unterstützung langer Dateinamen nicht die Parameter erkennen. (Lange Dateinamen können Leerstellen enthalten.)
Der Benutzer kann den Befehl nur ausführen, wenn er auch die Berechtigung dazu besitzt.
Parameter
-Command <String> |
||||||
Eingabe einer ausführbaren Datei (EXE-Datei) mit Pfad. Durch Klick auf das Symbol öffnet ein Browser, mit dem das System auf ausführbare Dateien durchsucht werden kann. |
||||||
|
-Context <String> |
||||||
User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer. |
||||||
|
-ContinueOnError <SwitchParameter> |
||||||
Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort |
||||||
|
-ExitCodeVariable <String> |
||||||
#TODO# |
||||||
|
-MaxWaitMinutes <String> |
||||||
#TODO# |
||||||
|
-SecureParameters <SwitchParameter> |
||||||
Der Befehl oder die Variable wird nicht in die Protokolldatei geschrieben. Die Option vermeidet, dass z.B. Installationsparameter oder Kennwort über die Variable ausgelesen werden kann. |
||||||
|
-Wait <SwitchParameter> |
||||||
Auf Ausführung des Programms warten. |
||||||
|
-WorkingDirectory <String> |
||||||
#TODO# |
||||||
|
-Wow64 <SwitchParameter> |
||||||
Standardmäßig geht das PackageDeployment-Modul davon aus, auf 64-Bit Systemen in einem 64-Bit PowerShell-Prozess ausgeführt zu werden und greift daher bei Datei- und Registryzugriffen standardmäßig den Ablageort für 64-Bit Anwendungen (sofern dieser sich von dem für 32-Bit Anwendungen unterscheidet) zurück. Soll auf die 32-Bit Pendants (im Dateisystem %WinDir%\SysWOW64 statt %WinDir%\System32, in der Registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node statt HKEY_LOCAL_MACHINE\SOFTWARE) zugegriffen werden, verwenden Sie den -Wow64 Switch. |
||||||
|
<CommonParameters> |
Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters". |