Start-ProgramAs

PackageDeployment Modul Hilfe	Package Deployment Module
Start-ProgramAs Cmdlet	Version 3.1.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

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