Client Command Eigenschaften

Last modified by Sabrina V. on 2024/10/14 11:59

Content

Client Command spezifische Eigenschaften
Versionsspezifisch
- Allgemein
- Bedingung

In den Eigenschaften eines Client Command können Sie allgemeine Informationen hinterlegen, wie auch bestimmte Optionen und Bedingungen für das Client Command setzen.

Client Command spezifische Eigenschaften

Note:

Folgende Einstellungen gelten für das gesamte Client Command. Führen Sie Änderungen an diesen durch, dann wirken sie sich auf alle Client Command Versionen aus.

Allgemein

Hier können Sie die grundlegenden Einstellungen des Client Command kontrollieren.

Sie haben die Möglichkeit, den Namen des Client Commands anzupassen und die ID einzusehen, die zur eindeutigen Identifizierung des Client Commands verwendet wird.

Note:

Jeder Client Command besitzt eine eigene ID.

Außerdem finden Sie Informationen zum Erstellungsdatum, zur Uhrzeit und zum ACMP Benutzer, die das Client Command erstellt hat, sowie zur letzten durchgeführten Änderung und dem Gerät, auf dem dies geschehen ist.

Optionen

In diesem Abschnitt können Sie unterschiedliche Client Command-Einstellungen vornehmen.

Client Command Optionen

Setzen Sie ein Häkchen in die jeweilige Checkbox, um diese Option zu aktivieren.

Interaktive Nutzung erlauben	Ermöglicht dem User eines Clients, dieses Client Command selbstständig über den Command Launcher oder eine (W)RunCC-Verknüpfung auszuführen. Note: Der Command Launcher wurde durch den ACMP Kiosk ersetzt, für diesen muss die Option nicht mehr gesetzt werden.
Als Quick Command anzeigen	Ermöglicht ein Anzeigen bzw. Ausführen als Quick Command über einen Rechtsklick auf einen Client bei einer Abfrage in der Abfrageverwaltung.
Im Ribbon-Tab „Abfrageaktionen“ anzeigen	Ermöglicht ein Freischalten des Client Commands, damit es im Ribbon-Tab „Abfrageaktionen“ (in jedem Menüpunkt des ACMP) oder über das Puzzleteil in einer Abfrage erscheint.
Erlaube parallele Ausführung	Verhindert, dass langlaufende Client Commands die Ausführung von kurzen Client Commands blockieren. Note: Beachten Sie, dass eine parallele Ausführung bei z.B. gemeinsam genutzten Ressourcen der zwei Client Commands zu einem Fehlschlagen der Ausführung führt.

Client Command Log-Optionen

Mit dem Setzen eines Häkchens in die Checkbox Client-Ausführungs-Log speichern bestätigen Sie, dass generell die Logs des Client Commands gespeichert werden sollen.

Über die DropDown-Liste Erweitertes Log speichern können Sie angeben, ob die Daten Niemals, Nur bei Fehlern oder Immer geloggt werden sollen.

Zusätzlich gibt es noch die DropDown-Liste ACMP Console Log anzeigen, über welche ausgewählt werden kann, wann ein Log der Console angezeigt wird (Niemals, Nur bei Fehlern, Immer).

Sicherheit

Unter Sicherheit haben Sie die Möglichkeit, das Client Command durch ein Passwort zu schützen, sodass es von keiner weiteren Person editiert werden kann.

Um das Client Command mit einem Passwort zu schützen, muss die Checkbox Geschützt angehakt werden. Klicken Sie dann auf Ändern. In dem Fenster geben Sie nun entweder das alte Passwort nochmals ein, wenn Sie das Passwort tauschen möchten, oder lediglich ein neues Passwort ein, wenn Sie erstmals ein Passwort vergeben wollen.

Wiederholen Sie in beiden Fällen das neue Passwort und klicken Sie auf OK.

Client Command_Eigenschaften_Sicherheit_2.png — Änderung des Passworts

In diesem Fall erscheint in der Liste aller Client Commands unter Eigenschaften das Symbol als Zeichen für ein Passwortgeschütztes Client Command.

Wenn Sie kein Passwort mehr für das Client Command haben möchten, müssen Sie das Häkchen aus der Checkbox Geschützt entfernen und das alte Passwort nochmals eingeben. Erst dann ist das Client Command nicht mehr geschützt.

Außerdem können Sie bestimmten Usern und Gruppen Rechte an diesem Client Command erteilen oder entziehen.

Um einer Gruppe oder einem Benutzer ein Recht zu vergeben, müssen Sie diese zunächst zur Auswahl hinzufügen. Zur Auswahl stehen die Rechte Bearbeiten, Ausführen und Sichtbar. Über Hinzufügen und Entfernen ermöglichen und entziehen Sie Gruppen und Benutzern das Zugriffsrecht auf das Client Command.

Note:

Das Anlegen von Gruppen und Benutzern erfolgt vorab unter System > Benutzerverwaltung. Dort können neue Gruppen und Benutzer hinzugefügt werden, die anschließend dann in der Zugriffsauswahl des Client Commands ausgewählt werden können.

Icon

Wenn Sie ein spezielles Icon statt des Standard-Icons für das Client Command auswählen möchten, können Sie hier ein neues hinzufügen, ein bestehendes Icon editieren oder löschen. Dies ist dann sinnvoll, wenn dieses Client Command von besonderer Bedeutung ist.

Note:

Das neue Icon wird lediglich für die Einträge zum Client Command in der Ribbonbar verwendet. In der ACMP Console hat es weiterhin das gelbe Puzzleteil, dasselbe gilt für den Command Launcher.

Wird kein Icon ausgewählt, dann erhält das Client Command automatisch das Standard-Icon.

Note:

Wollen Sie ein eigenes Icon hinzufügen, dann muss das Icon das Maß 16x16 Pixel besitzen sowie eine .bmp- oder .ico-Datei sein.

Info

Hier können Sie Informationen zum Client Command angeben, wenn dieses z.B. von einem fremden Hersteller kommt und in ACMP importiert wurde.

Neben dem Namen des Erstellers und der Version können Sie auch etwas zum Markenzeichen hinzufügen.

File Repositories

Über diese Einstellung können Sie entscheiden, ob das Client Command mit allen File Repositories oder nur mit ausgewählten synchronisiert werden soll.

Client Commmand_Eigenschaften_File Repo.png — Zu synchronisierende File Repositories für das Client Command

Note:

Weitere, neue File Repositories können Sie unter System > Verteilte File Repositories hinzufügen.

Kommentare

Unter Kommentare wird der Kommentar angezeigt, der hinzugefügt worden ist, nachdem eine neue Client Command Version angelegt wurde. I.d.R. werden Sie dort aufgefordert, einen Kommentar hinzuzufügen. Dieser kann hier eingesehen werden.

Wenn eine neue Client Command Version angelegt wird, werden Sie automatisch dazu aufgefordert, einen Kommentar zu verfassen. Auf dieser Seite können diese Kommentare eingesehen werden.

Parameter

Mithilfe von Parametern auf Basis von CC Projektvariablen können Sie einem Client Command Werte übergeben. So können aus der ACMP Console heraus Client Command Jobs über die Parameter gesteuert werden, ohne vorher das Console Skript des CCs ausführen zu müssen.

Die Parameter selber können im ACMP überall dort genutzt werden, wo auch Jobs benötigt und eingesetzt werden:

Über die manuelle Ausführung von Jobs ausführen
Über die Einbindung in den Job Collections
Über die Nutzung in Containern
Über vorab getroffene Einstellungen im ACMP Kiosk
Über die Commands Enqueue ACMP Jobs und Run Client Command

Benutzerdefinierte Parameter definieren

Sie haben die Möglichkeit, Parameter für ein Client Command auf Basis einer CC Projektvariable zu definieren. Diese sind dann Client Command spezifische Einstellungen, die nur diesem CC mitgegeben werden.

Definiert werden die Parameter hierfür im Client Command Center bzw. Editor. Zum Hinzufügen von Parameterwerten können Sie über 2 Wege gehen:

In der Navigation über Client Commands > Erstellen > Rechtsklick auf einen bereits bestehenden CC > Eigenschaften > Client Command spezifisch > Parameter.
Über einen Doppelklick auf ein bereits bestehendes CC oder ein neu erstelltes > Oberhalb der Befehle auf Eigenschaften > Client Command spezifisch > Parameter.

Eigenschaften Parameter.PNG — Parameterwerte definieren

In diesem Bereich werden alle bestehenden Parameter angezeigt. Über fügen Sie dem CC einen neuen Parameter hinzu, über löschen Sie den Parameter, über editieren Sie die Parameter. Beim Hinzufügen gibt es 3 Typen von Parametern, zwischen denen Sie auswählen können:

1. Text

Parameter Text.PNG — Parameter-Typ: Text

Bei diesem Parameter-Typen können Sie die Parameterwerte über einen Freitext angeben.

Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über im CC Editor ausgewählt haben oder geben Sie direkt den Namen der CC Projektvariable ein.

Dabei können nur

schreibbare Projektvariablen verwendet werden und
eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.

Geben Sie dann eine deutsche oder eine englische Bezeichnung an.

Note:

Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.

Über die Einstellung Option wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus Unsichtbar für Endanwender, Nur lesbar für Endanwender und Editierbar für Endanwender. Über Standardwert geben Sie einen Wert in Form eines Freitextes an, der standardmäßig eingestellt sein soll.

Note:

Dieser Wert ist nicht der Standardwert der CC Projektvariable. Dieser Wert wird bei der Ausführung des CC Jobs an das CC Skript übergeben und überschreibt somit den Standardwert der CC Projektvariablen.

2. Combobox

Bei diesem Parameter-Typen können Sie die Parameterwerte über eine Combobox angeben.

Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein.

Dabei können nur

schreibbare Projektvariablen verwendet werden und
eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.

Geben Sie dann eine deutsche oder eine englische Bezeichnung an.

Note:

Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.

Geben Sie über Hinzufügen den Wert der Variable ein, der in die Projektvariable geschrieben werden wird, wenn dieser Eintrag der Combobox gewählt wird. I.d.R. handelt es sich dabei um Software, die installiert oder deinstalliert werden soll. Sprechende Werte dafür wären „Installieren“ und „Deinstallieren“.

Die Reihenfolge, in der die Combobox-Einträge beim Erstellen von Jobs angezeigt werden, kann angepasst werden sowie welcher Eintrag der Standardwert des neuen Jobs ist.

3. Checkbox

Bei diesem Parameter-Typen können Sie die Parameterwerte in einer Checkbox angeben.
Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein.

Dabei können nur

schreibbare Projektvariablen verwendet werden und
eine bereits von einem anderen Parameter verwendete Projektvariable kann nicht bei einem weiteren Parameter angewendet werden.

Geben Sie dann eine deutsche oder eine englische Bezeichnung an.

Note:

Diese Bezeichnung ist der Text, der in einer deutschen oder englischen Console angezeigt wird, wenn auch der Parameter angezeigt wird.

Über die Einstellung Option wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus Unsichtbar für Endanwender, Nur lesbar für Endanwender und Editierbar für Endanwender. In der Checkbox-Konfiguration können Sie einstellen, welcher Wert, also 1 oder 0, an das CC übergeben werden soll. Über den Standardwert legen Sie fest, ob standardmäßig der Wert 1 für „angekreuzt“ oder 0 für „Nicht angekreuzt“ voreingestellt ist.

Klicken Sie in allen drei Fällen des Parameter-Typs auf Speichern. Anschließend können Sie über das Anlegen von neu erstellten oder Auswählen von bereits angelegten Client Command Jobs die Parameter anwenden.

Änderungen an den Parametern

Da Parameter Client Command spezifisch sind, wirken sich jegliche Änderungen immer auf alle Versionen des CCs aus. Folgende Fälle und ihre Auswirkungen kann dies für das CC bedeuten:

Änderungen	Auswirkungen
Parameter wird hinzugefügt	Für bereits bestehende Jobs wird der zum Zeitpunkt der Erstellung des Parameters geltende Defaultwert des neuen Parameters verwendet.
Parameter wird entfernt	Der Parameter wird auch bei bestehenden Jobs nicht mehr verwendet. Das kann zu fehlschlagenden alten CC Versionen führen.
Defaultwert wird geändert	Bestehende Jobs werden nicht verändert. Bei neu erstellten Jobs wird der neue Defaultwert angewendet.
Name des Parameters wird geändert	Bestehende Jobs werden nicht verändert. Der Name ist nicht relevant für die Ausführung.
Mögliche Werte des Parameters werden geändert	Checkbox: Es werden die neu eingestellten Werte verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen.
	Text: Jegliche Änderungen am Freitext ändern nur den Defaultwert. Sie ändern nichts an bestehenden Jobs. Bei neuen Jobs wird dann der neue Default angewendet.
	Combobox: Einen neuen Eintrag hinzufügen Bestehende Jobs werden nicht verändert. Bei neuen Jobs oder beim Editieren bestehender Jobs ist der neue Eintrag verfügbar. Einen bereits bestehenden Eintrag löschen Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der Defaulteintrag des Parameters verwendet. Einen Defaulteintrag löschen Wenn der Defaulteintrag gelöscht wird, muss ein neuer Defaulteintrag ausgewählt werden. Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der neue Defaulteintrag des Parameters verwendet. Den Wert eines Eintrags ändern Es wird der neu eingestellte Wert verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen. Einen bereits bestehenden Eintrag umbenennen Bestehende Jobs werden nicht verändert. Der Name ist nicht relevant für die Ausführung. Den Defaulteintrag wechseln Bestehende Jobs werden nicht verändert. Bei neuen Jobs wird der neue Defaulteintrag vorausgewählt.

Versionsspezifisch

Note:

Diese Einstellungen gelten nur für diese spezifische Version des Client Commands. Wenn Sie Änderungen an diesen Einstellungen vornehmen, wirken sie sich nicht auf andere Versionen aus. Versionsbezogene Eigenschaften können nur geändert werden, wenn das Client Command sich im Status „Erstellen“ befindet.

Allgemein

In den Versionseinstellungen können Sie mit den sogenannten „Leveln“ eines Client Commands arbeiten. Ein Level ist für den Anwendungsfall gedacht, wenn ein Client Command in einem Container einmalig ausgeführt werden soll.

Wenn Sie eine neue Version erstellen, in der alle Clients eines Containers das bereits ausgeführte Client Command erneut ausführen sollen, dann müssen Sie neben der Version auch das Level erhöhen.

Erhöhen Sie das Level des Client Commands, indem Sie auf Level erhöhen klicken. Das Client Command besitzt dann das Level 1. Jedes Client Command, das danach erneut ausgeführt werden soll, erhöht sich um +1.

In die Beschreibung können Sie weitere Informationen hinzufügen, die für eine Version wichtig sein können.

Bedingung

Unter Bedingungen können Sie zusätzliche Bedingungen angeben, welche bei der Ausführung des Commands berücksichtigt werden sollen.

Dazu ziehen Sie eine Bedingung von der linken Seite per Drag-and-Drop oder per Doppelklick auf die rechte Seite auf die ODER- bzw. die UND-Bedingung. Dies ist ähnlich den Filtern, welche bei einer Abfrage gesetzt werden können.

Sie können die Bedingungen auch verschachteln, sodass eine Bedingung z.B. nach dem Muster X ODER (Y UND Z) entsteht. Ziehen Sie z.B. eine Bedingung auf eine bereits bestehende UND-Bedingung, so werden diese beiden Bedingungen in den Kontext mit einer ODER-Bedingung gesetzt.

Note:

Bedingungen können für jede Version eines Client Command angepasst werden.

Im Folgenden werden die verschiedenen Bedingungen genauer erläutert:

Conditions	Bedingung
If file exists	Mit dieser Bedingung können Sie überprüfen, ob eine bestimmte Datei existiert.
Is machine in AD group	Mit dieser Bedingung können Sie prüfen, ob der Rechner zur angegebenen AD-Gruppe gehört. Dazu geben Sie entweder eine Gruppe in der Form von „Domänenname\Gruppenname“ oder die SID der Gruppe an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
Is user in AD group	Mit dieser Bedingung können Sie prüfen, ob ein bestimmter Benutzer zur angegebenen AD-Gruppe gehört. Dazu geben Sie entweder eine Gruppe in der Form von „Domänenname\Gruppenname“ oder die SID der Gruppe an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
If OS architecture is	Mit dieser Bedingung können Sie überprüfen, ob ein 32- oder 64-bit Betriebssystem auf dem Client vorhanden ist.
If ADS Container/Property matches	Mit dieser Bedingung können Sie überprüfen, ob der aktuelle Benutzer bzw. der Client in einem bestimmten AD-Container liegt oder eine bestimmte Eigenschaft besitzt. Um die AD-Container bzw. die Eigenschaften auszuwählen, klicken Sie auf den Button rechts neben dem Eingabefeld.
If machine is in domain	Mit dieser Bedingung können Sie prüfen, ob ein Client zur angegebenen Domain gehört. Dazu geben Sie einfach eine Domain an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.
If registry value name exists	Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert und einen bestimmten Wert besitzt. Geben Sie dazu aus dem DropDown-Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Den Wert tragen Sie ebenfalls ein. Über den Button unter den Eingabefeldern öffnet sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.
If registry key exists	Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert. Geben Sie dazu aus dem DropDown-Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Über den Button unter den Eingabefeldern öffnet sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.
Is CPU speed	Mit dieser Bedingung können Sie den CPU-Takt überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch den passenden Takt in Hz (Hertz) angeben. Note: Die Bedingung bezieht sich immer auf die zum Prüfzeitpunkt aktuelle Taktrate der CPU. Diese ändert sich bei modernen CPUs im laufenden Betrieb.
If free product licenses are available	Mit dieser Bedingung können Sie überprüfen, ob freie Produktlizenzen innerhalb des Lizenzmanagements verfügbar sind.
Is RAM capacity	Mit dieser Bedingung können Sie den freien Arbeitsspeicher überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die Größe des RAM angeben.
If directory exists	Mit dieser Bedingung können Sie überprüfen, ob ein bestimmtes Verzeichnis existiert. Dazu geben Sie einfach das entsprechende Verzeichnis an.
Compare strings	Mit dieser Bedingung können Sie überprüfen, ob zwei Zeichenketten gleich sind. So können Sie z.B. als erste Zeichenkette eine ACMP Systemvariable eingeben und als zweite Zeichenkette einen bestimmten Wert. Variablen werden im Format %Variablenname% angegeben.
Is file version	Mit dieser Bedingung können Sie die Dateiversion überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die passende Datei auswählen und die Dateiversion angeben. Nur ausführbare Dateien haben eine Versionsnummer.
Is file date	Mit dieser Bedingung können Sie das Änderungsdatum einer Datei überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die passende Datei auswählen und das Änderungsdatum im Format dd.mm.yy hh:mm:ss angeben.
Is free disk space	Mit dieser Bedingung können Sie den freien Speicher einer Partition der Festplatte überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung, wozu Sie noch die Größe des Speichers sowie die Partition angeben.
Is operating system	Mit dieser Bedingung können Sie überprüfen, ob das Betriebssystem eine bestimmte Version besitzt, z.B. Windows 10 oder Windows 11. Wählen Sie dazu einfach die passende Version aus dem DropDown-Feld.
Is machine name	Mit dieser Bedingung können Sie überprüfen, ob der Rechnername gleich einem angegebenen Namen ist. Dazu klicken Sie auf den Button rechts neben dem Eingabefeld. Dort werden Ihnen alle Rechner einer Domain aufgelistet. Klicken Sie auf den Button darunter, werden ihnen nur Rechner aufgelistet, welche im ACMP inventarisiert sind.
Is user local admin	Mit dieser Bedingung können Sie überprüfen, ob der angemeldete Benutzer lokale Administratorrechte besitzt.
Is logon user	Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Benutzer am Client angemeldet ist. Klicken Sie auf den Button rechts neben dem Eingabefeld und es werden Ihnen alle vorhandenen und bekannten User einer Domain aufgelistet. Markieren Sie einen entsprechenden User und klicken Sie auf Hinzufügen. Wenn Sie alle nötigen User hinzugefügt haben klicken Sie auf OK.
Is in container	Mit dieser Bedingung können Sie überprüfen, ob der inventarisierte Rechner in einem bestimmten Container liegt.
Is software installed	Mit dieser Bedingung können Sie überprüfen, ob eine bestimmte Software installiert ist. Note: Diese Bedingung bezieht sich darauf, ob das Command „Set software installed“ mit einem bestimmten Softwarenamen ausgeführt wurde, es prüft also nicht, ob z.B. Firefox generell installiert ist!