PackageDeployment Modul Hilfe

Package Deployment Module (DSM eScript Commands)

Start-Program Cmdlet

Version 1.0.0.3

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 mit DSM Runtime Service
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
Computer: Ausführung mit DSM Runtime Service; 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>

Aus Kompatibilitätsgründen verwendet Ivanti DSM bei Datei- und Registryzugriffen standardmäßig den Ablageort für 32-Bit Anwendungen (sofern dieser sich von dem für 64-Bit Anwendungen unterscheidet). Bei Dateizugriffen hat dies zur Folge, dass bei x64-Systemen auf das %WinDir%\SysWOW64 Verzeichnis und nicht auf das %WinDir%\system32 Verzeichnis zugegriffen wird. Bei Registry-Befehlen werden (unter anderem) Zugriffe auf HKEY_LOCAL_MACHINE\SOFTWARE nach HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node umgeleitet. Der x64-Schalter bewirkt, dass bei der Ausführung des Skript-Befehls auf einem x64-Computer diese Umleitung von Datei- bzw Registryzugriffen abgeschaltet und der eScript-Befehl auf angegebenen Pfad ausgeführt wird. Beim Callscript-Befehl wird damit das Skript in einem 64-Bit Prozess ausgeführt.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

<CommonParameters>

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