Wiki-Quellcode von Processes and Shell

Zuletzt geändert von S V am 2024/03/19 17:56

version	line-number	content
2.1	1	{{aagon.priorisierung}}
	2	460
	3	{{/aagon.priorisierung}}
	4
	5	{{aagon.floatingbox/}}
3.2	6
3.3	7	= Execute batch-file command =
3.2	8
	9	Mit diesem Kommando können Sie entsprechende Befehle als Batch-Datei ausführen lassen. Tragen Sie unter dem Reiter Details dazu einfach die Befehle entsprechend ihrer Syntax in das Textfeld. Natürlich können Sie auch den Inhalt einer bestehenden Batch-Datei kopieren und hier einfügen.
	10
3.3	11	{{aagon.infobox}}
	12	Beachten Sie, dass Sie beim Angeben der Befehle nur mit ASCII-Zeichen verwenden.
	13	{{/aagon.infobox}}
3.2	14
	15	Für den Exit-Code und die Output-Zeilen können Sie auf bestehende Variablen zugreifen oder neue Variablen erstellen.
	16
	17	Auf dem Reiter Ausführen als können Sie abweichende Benutzeranmeldeinformationen angeben. Hierbei können Sie entweder ein spezifisches Konto (Benutzername und Passwort) angeben.
	18
	19	Um das Programm mit administrativen Rechten ausführen zu können, muss die Checkbox "Erhöhte Rechte anfordern" aktiviert werden. So ist gewährleistet, dass der impersonierte Prozess mit den höchsten verfügbaren Rechten ausgeführt wird. Zusätzlich muss der Prozess als Dienst und nicht im Userkontext ausgeführt werden. Hierzu wechseln Sie auf den Reiter Allgemein und wählen und den Ausführungsoptionen bei "Ausführen als" Dienst.
	20
3.3	21	{{aagon.infobox}}
	22	Die Ausführung der EXE als Dienst erfordert, dass der Aufruf silent erfolgt. Mögliche Eingabefenster und/ oder Bestätigungsdialoge werden nicht im Userkontext angezeigt und können entsprechend auch nicht bestätigt werden.
	23	{{/aagon.infobox}}
3.2	24
3.3	25	= Shell execute command =
3.2	26
	27	Mit diesem Kommando ist es Ihnen möglich, ein Programm des Clients aufzurufen. Geben Sie dazu unter dem Tab "Details" den Dateinamen des aufzurufenden Programms, sowie seine Parameter an. Das Programm können Sie über den Browse–Button auswählen, falls es auf dem lokalen Rechner ebenfalls installiert ist. Geben Sie das Arbeitsverzeichnis des Programms an.
	28
18.1	29	Um sicherzustellen, dass der Befehl auch auf 64-Bit Systemen fehlerfrei ausgeführt wird, aktivieren Sie die Checkbox //Auf Windows x64 natives %WINDIR&\System32 verwenden//.
3.2	30
3.3	31	{{aagon.infobox}}
14.1	32	Es wird empfohlen bei "Dateiname" immer einen absoluten Pfad anzugeben. "Arbeitsordner" ist das Arbeitsverzeichnis, dass das unter "Dateiname" angegebene Programm verwendet. So kann das Programm, ausgehend vom "Arbeitsordner", relative Pfade nutzen.
3.3	33	{{/aagon.infobox}}
3.2	34
	35
5.1	36	(% style="text-align:center" %)
3.2	37	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_b0c94051.png\|\|alt="5.8.3.2.22 - ShellExecuteCommand" height="518" width="608"]]
	38	Shell execute command
	39
	40	Im Bereich "Warteoptionen" können Sie zwischen zwei Optionen wählen. Bei Auswahl der Option "Auf Prozess warten" wird mit der Weiterführung gewartet, bis der aktuell ausgewählte Prozess beendet ist. Bei Auswahl der Option "Auf anderen Prozess warten" hingegen wird mit der Weiterführung gewartet, bis ein anderer Prozess beendet ist. Dieser Prozess muss angegeben werden. Beide Optionen können einzeln, aber auch gemeinsam genutzt werden. Gibt es den unter "Auf anderen Prozess warten" angegebenen Prozess mehrfach, so müssen alle Instanzen beendet werden. Ist der angegebene Prozess nicht gestartet, läuft die Anwendung direkt weiter.
	41
20.2	42	Zusätzlich ist die Checkbox //Fehlschlagen wenn Exit Code nicht 0 ist// aktiviert. Dieser bewirkt, dass der Befehl fehlschlägt, wenn es sich z.B. um eine Softwareinstallation mit einem Softwarepaket handelt.
3.2	43
	44	Unter "Erweiterte Optionen" steht im deaktivierten Eingabefeld der so genannte Aufrufstring. Über diesen wird das angegebene Programm mit den angegebenen Parametern gestartet. Falls Sie dem Aufruf noch etwas hinzufügen möchten, entsperren Sie den Aufrufstring und ändern diesen nach Ihren Wünschen. Alternativ ist bereits ein String hinterlegt, welcher das angegebene Programm über die Kommandoeingabe von Windows (cmd.exe) aufruft. !.FileName!? und ?!Parameters!? beinhalten dabei das angegebene Programm (Dateiname) bzw. die Parameter.
	45
3.3	46	{{aagon.infobox}}
	47	Der Aufrufstring wird immer verwendet, unabhängig davon ob er gesperrt ist oder nicht.
	48	{{/aagon.infobox}}
3.2	49
14.1	50	Zuletzt geben Sie zwei Variablen an. In der ersten wird die Prozess ID gespeichert, während in der zweiten Variablen der Exit Code gespeichert wird. Der Exit Code beinhaltet den Exit Code der Ausführung.
3.2	51
3.3	52	{{aagon.infobox}}
	53	Solange auf den Prozess gewartet wird, liefert der Exit Code nur korrekte Werte.
	54	{{/aagon.infobox}}
3.2	55
	56	Unter dem Tab "Verbindung" können Sie einen anderen Benutzer verwenden, falls der lokale Client–Benutzer nicht die erforderlichen Rechte besitzt, um auf das Programm zuzugreifen. Aktivieren Sie dazu die Checkbox und geben Sie den Benutzernamen sowie das zugehörige Passwort ein.
	57
3.3	58	{{aagon.infobox}}
	59	Der "lokale Client-Benutzer" ist, außer in angepassten Umgebungen, immer System bzw. NT Authority\System. Diesem Account wird, aufgrund des fehlenden Passworts, bei neueren Freigaben standardmäßig der Zugriff auf Netzlaufwerke verwehrt, sodass die Angabe hier vorwiegend für den Zugriff auf UNC-Pfade von Interesse ist.
	60	{{/aagon.infobox}}
3.2	61
	62	Auf dem Reiter Ausführen als können Sie abweichende Benutzeranmeldeinformationen angeben. Hierbei können Sie entweder ein spezifisches Konto (Benutzername und Passwort) angeben oder auf einen globalen Account zugreifen.
	63
	64	Um das Programm mit administrativen Rechten ausführen zu können, muss die Checkbox "Erhöhte Rechte anfordern" aktiviert werden. So ist gewährleistet, dass der impersonierte Prozess mit den höchsten verfügbaren Rechten ausgeführt wird. Zusätzlich muss der Prozess als Dienst und nicht im Userkontext ausgeführt werden. Hierzu wechseln Sie auf den Reiter Allgemein und wählen und den Ausführungsoptionen bei "Ausführen als" Dienst.
	65
3.3	66	{{aagon.infobox}}
	67	Die Ausführung der EXE als Dienst erfordert, dass der Aufruf silent erfolgt. Mögliche Eingabefenster und/ oder Bestätigungsdialoge werden nicht im Userkontext angezeigt und können entsprechend auch nicht bestätigt werden.
	68	{{/aagon.infobox}}
3.2	69
4.1	70	= Execute PowerShell skript =
3.2	71
	72	Mit diesem Kommando ist es Ihnen möglich, ein PowerShell-Skript auszuführen. Dazu tragen Sie im Tab Details die entsprechenden Befehle in den Textbereich ein bzw. können diese auch aus einem bereits bestehenden Skript kopieren.
	73
14.1	74	Werden innerhalb des PowerShellSkripts Dialoge angezeigt muss es impersoniert ausgeführt werden, da die Ausführung sonst im Systemkontext läuft und so für den angemeldeten Benutzer nicht sichtbar ist.
3.2	75
14.1	76	Die Checkbox Console anzeigen wird für einige administrative Dialoge benötigt bietet die Möglichkeit die PowerShell Console anzuzeigen. Diese Einstellung ist wichtig, wenn Sie Dialoge anzeigen wollen.
3.2	77
14.1	78	Geben Sie anschließend zwei Variablen an. Die erste Variable speichert den Exit Code, welcher verwendet werden kann, um Hinweise zur Ausführung zu geben. Standardmäßig lautet der Exit Code jedes Skriptes 0, sofern dieser nicht vom Entwickler des Skriptes geändert wird. Die zweite Variable speichert die Ausgaben des Skripts.
3.2	79
4.1	80	{{aagon.infobox}}
24.1	81	Das Skript leert vor der eigentlichen Ausführung den Wert der Ausgabevariable, auch wenn das Skript keine Ausgabe besitzt oder nur einen leeren String ausgibt.
4.1	82	{{/aagon.infobox}}
3.2	83
	84	Auf dem Reiter Ausführen als können Sie abweichende Benutzeranmeldeinformationen angeben. Hierbei können Sie entweder ein spezifisches Konto (Benutzername und Passwort) angeben oder auf einen globalen Account zugreifen.
	85
4.1	86	= Get process ID =
3.2	87
	88	Mit diesem Kommando können Sie sich die Prozess ID eines bestimmten Prozesses holen. Dazu können Sie unter dem Tab Details einen Dateinamen oder einen Prozess angeben, nach welchem gesucht wird. Über die entsprechenden Browse – Buttons öffnet sich ein Fenster, in welchem Sie entweder eine Datei (wie ein normaler Auswahldialog) oder einen aktuell laufenden Prozess auswählen können.
	89
5.1	90	(% style="text-align:center" %)
3.2	91	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_a182117b.png\|\|alt="Get process ID" height="449" width="398"]]
	92	Get process ID
	93
14.1	94	Anhand dieser Auswahl wird auf dem Client nach einem entsprechenden Prozess gesucht und die ID zurückgegeben. Zum Speichern der ID dient eine anzugebende Variable.
3.2	95
4.1	96	= Kill process =
3.3	97
3.2	98	Mit diesem Kommando können Sie einen Prozess sofort beenden. Geben Sie dazu unter dem Tab Details einen Dateinamen, einen Prozess oder die entsprechende PID (Prozess ID) an. Über die beiden Browse–Buttons können Sie eine Datei oder einen Prozess auswählen. Bei der Dateiauswahl wird ein Auswahldialog geöffnet um eine Datei auszuwählen. Ein Prozess, welcher auf dieser Datei basiert wird später beendet. Bei der Auswahl eines Prozesses werden in einem Dialog alle aktuell laufenden Prozesse aufgelistet. Gleiche Prozesse werden später beendet.
	99
	100	Einige Prozesse lassen sich allerdings nicht so einfach beenden. Dabei hilft die Option Beenden des Dienstes erzwingen und Anwendungen debuggen. Falls mehr als ein Prozess existiert (z.B. svchost.exe), lässt sich weiterhin ein Fehler ausgeben.
	101
4.1	102	= Wait for process =
3.2	103
	104	Mit diesem Kommando können Sie auf die Beendigung eines Prozesses warten. Geben Sie dazu unter dem Tab Details einen Dateinamen, einen Prozess oder die entsprechende PID (Prozess ID) an. Über die beiden Browse – Button können Sie eine Datei oder einen Prozess auswählen. Bei der Dateiauswahl wird ein normaler Auswahldialog geöffnet um eine Datei auszuwählen. Auf einen Prozess, welcher auf dieser Datei basiert wird später gewartet. Bei der Auswahl eines Prozesses werden in einem Dialog alle aktuell laufenden Prozesse aufgelistet. Auf gleiche Prozesse wird später gewartet. Falls mehr als ein Prozess existieren (z.B. svchost.exe), lässt sich weiterhin ein Fehler ausgeben.
	105
	106	Sollte auf einen Prozess länger gewartet werden, als die unter Beenden eingestellte Zeit (in Sekunden), so schlägt das Kommando fehl und bricht ab.

Wiki-Quellcode von Processes and Shell

Navigation