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.

Erforderlich

Ja

Position

0

Pipeline-Eingaben akzeptieren

Nein

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung im Service-Kontext
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
ComputerPerService: Ausführung im Service-Kontext; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.

Erforderlich

Nein

Position

4

Pipeline-Eingaben akzeptieren

Nein

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-ExitCodeVariable <String>

#TODO#

Erforderlich

Nein

Position

2

Pipeline-Eingaben akzeptieren

Nein

-MaxWaitMinutes <String>

#TODO#

Erforderlich

Nein

Position

3

Pipeline-Eingaben akzeptieren

Nein

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

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-Wait <SwitchParameter>

Auf Ausführung des Programms warten.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-WorkingDirectory <String>

#TODO#

Erforderlich

Nein

Position

1

Pipeline-Eingaben akzeptieren

Nein

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

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

<CommonParameters>

Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters".