PackageDeployment Modul Hilfe

Package Deployment Module

Start-ProgramAs Cmdlet

Version 3.0.0.0

Start-ProgramAs

Übersicht

Programm unter einem bestimmten Benutzer ausführen

Syntax

Start-ProgramAs [-FilePath] <String> [[-Arguments] <String>] [[-OnError] <String>] [[-Context] <String>] [[-WorkingDirectory] <String>] [-ContinueOnError] [-LeastPrivilege] [-PassThru] [-SecureParameters] [-SignedExitCode] [-Wait] [-Wow64] [[-ExitCodeVariable] <String>] [[-MaxWaitMinutes] <String>] [[-WindowStyle] <String>] [[-RunAs] <String>] [[-UserName] <String>] [[-Password] <String>] [[-Logon] <String>] [<CommonParameters>]

Beschreibung

Führt eine Anwendung unter einem anderen Benutzerkonto aus als dem aktuellen Konto. Damit kann eine Anwendung z. B. mit weitergehenden Berechtigungen ausgeführt werden als die gegenwärtige Anmeldung zulässt

Parameter

-Arguments <String>

Diese Parameter werden an die Anwendung übergeben

Erforderlich

Nein

Position

1

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

11

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

3

Pipeline-Eingaben akzeptieren

Nein

-FilePath <String>

Name der auszuführenden Anwendung.

Erforderlich

Ja

Position

0

Pipeline-Eingaben akzeptieren

Nein

-LeastPrivilege <SwitchParameter>

#TODO#

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-Logon <String>

NoProfile: Das Benutzerprofil wird nicht geladen. Nach Ausführen der Anwendung werden keine Änderungen ins Benutzerprofil geschrieben.
LoadProfile: Das Benutzerprofil wird geladen; Änderungen werden ins Benutzerprofil geschrieben.
NetworkOnly: Die Anwendung selbst wird im Kontext des aktuellen Benutzerkontos ausgeführt.
Das spezifizierte Benutzerkonto wird nur für Netzwerkzugriffe verwendet, d.h. es wird eine Anmeldesitzung (logon session) unter dem spezifizierten Benutzerkonto eröffnet.

Erforderlich

Nein

Position

9

Pipeline-Eingaben akzeptieren

Nein

-MaxWaitMinutes <String>

Das Paket wird nach dieser Zeit fortgesetzt, auch wenn die Anwendung noch nicht beendet ist.
Die Wartezeit beträgt mindestens eine Minute (auch bei Angabe "0").

Erforderlich

Nein

Position

4

Pipeline-Eingaben akzeptieren

Nein

-OnError <String>

Done: Paket wird mit dem nächsten Befehl fortgesetzt
Undone: Paketausführung wird abgebrochen. Falls das Paket als Komponente eines Software Sets oder mit dem Befehl CallNIProc aufgerufen wurde, wird auch das aufrufende Paket abgebrochen.
Failed: Paketausführung wird abgebrochen. Falls das Paket als Komponente eines Software Sets oder mit dem Befehl CallNIProc aufgerufen wurde, werden diese Pakete fortgesetzt.
Failed: Die Paketausführung wird abgebrochen. Der Compliance-Status der zugehörigen Policy-Instanz wird auf rot gesetzt.

Erforderlich

Nein

Position

10

Pipeline-Eingaben akzeptieren

Nein

-PassThru <SwitchParameter>

#TODO#

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-Password <String>

Kennwort für das Benutzerkonto, unter dem die Anwendung ausgeführt werden soll

Erforderlich

Nein

Position

8

Pipeline-Eingaben akzeptieren

Nein

-RunAs <String>

UserName: Die Anwendung wird unter dem folgenden Konto ausgeführt.
LocalSystem: Die Anwendung wird unter einem der konfigurierten DSM-Konten ausgeführt. Das betreffende Konto wird nach folgenden Regeln automatisch ermittelt:
Wenn die Anmeldeoption Nur am Netzwerk anmelden ausgewählt ist (s.u.), wird das Benutzerkonto für den Zugriff auf das Depot verwendet. Ist dieses Konto nicht konfiguriert, wird stattdessen das Konto des angemeldeten Benutzers verwendet.
In allen anderen Fällen wird das Benutzerkonto für den DSM Runtime Service verwendet. Wenn dieses Konto nicht konfiguriert ist, wird stattdessen das Konto verwendet, unter dem der ServiceInstaller läuft.

Erforderlich

Nein

Position

6

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

-SignedExitCode <SwitchParameter>

#TODO#

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-UserName <String>

Das Benutzerkonto, unter dem die Anwendung ausgeführt werden soll.
Eingabe ist in folgender Form möglich: <Benutzername> , <Domäne>\<Benutzername>

Erforderlich

Nein

Position

7

Pipeline-Eingaben akzeptieren

Nein

-Wait <SwitchParameter>

Das Paket wird erst fortgesetzt, wenn die Anwendung beendet ist.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-WindowStyle <String>

Normal: Das Dialogfenster des ausgeführten Programms wird angezeigt (Normal)
Minimized: Das Dialogfenster des ausgeführten Programms ist nur in der Taskleiste zu sehen (Minimiert).
Hidden: Das Dialogfenster des ausgeführten Programms ist gar nicht sichtbar (Versteckt).

Erforderlich

Nein

Position

5

Pipeline-Eingaben akzeptieren

Nein

-WorkingDirectory <String>

#TODO#

Erforderlich

Nein

Position

2

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