Client Command Variablen
Variablen dienen dazu, Werte an Kommandos zu übergeben, bestimmte Werte zu speichern oder sie agieren als Ergebnisvariablen, deren Werte in nachfolgenden Kommandos wiederum übergeben werden.
Dabei gibt es in ACMP vier Typen von Variablen.
Diese unterscheiden sich in der Verwendung:
 | Projektvariablen | Diese Variablen bestehen nur in dem aktuellen Projekt und können nicht in anderen Projekten genutzt werden. |
 | Console Variablen | Diese Variablen stehen im gesamten ACMP-Umfeld zur Verfügung und können in allen Projekten genutzt werden. Sie können jedoch nicht angelegt werden und werden von ACMP automatisch bei der Ausführung befüllt. Dadurch können sie nicht vom Benutzer beeinflusst werden. |
 | Systemvariablen | Diese Variablen beschreiben die aktuelle Umgebung, auf welchem das Client Command ausgeführt werden soll. So lassen sich einfach z.B. Rechnerbezogene, aber auch Werte des ACMP Servers auslesen (Name, Verzeichnisse, Betriebssystem). Diese Variablen können nur gelesen werden. |
 | Globale ACMP Variablen | Diese Variablen enthalten allgemeine Konfigurationswerte, die vorab definiert werden. Jedem Client Command stehen diese Variablen und deren Werte zur Verfügung. Ob eine globale Variable schreibbar oder nicht schreibbar sein soll, kann für jeden einzelne Variable vorab in der ACMP Console definiert werden. |
Verfügbare Variablen
Note:
Variablen werden, wenn in der Menüleiste unter 
angelegt oder deren Standardwert verändert werden, ohne Prozentzeichen angeben.
Werden Variablen in Commands innerhalb der Commandlist benutzt, dann muss das dies mit Prozentzeichen geschehen, z.B. %Variablenname%:
Projektvariablen
Projektvariablen sind Variablen, die nur für die Client Command spezifische Dauer agieren und somit auch nur für die Nutzung des einen Client Commands gedacht sind.
Sie sind nur in dem spezifischen Client Command verfügbar, in dem sie auch definiert wurden. D.h., dass sobald das Client Command abgeschlossen ist, nicht mehr auf die Projektvariable zugegriffen werden kann.
Für Projektvariablen können außerdem Parameter definiert werden, welche als Client Command spezifische Einstellungen agieren und die nur diesem Client Command mitgegeben werden.
Console Variablen
Variablen vom Typ Console werden dynamisch zum Zeitpunkt der Ausführung des Skripts befüllt.
| Name | Beschreibung |
| CONSOLE_EXECUTION_ID | Beinhaltet eine GUID, die die Ausführung des Console Skripts eindeutig identifiziert. |
| CONTAINER_PATH | Wird ein Client Command als Job an einen Container angefügt, wird diese Variable bei Ausführung auf dem Client über den Container mit dem Pfad befüllt. Der Wert kann als Vorschau in dem Container Plugin für den entsprechenden Container eingesehen werden. Diesen können Sie auch in der Ansicht der Container lesen, z.B. acmp.local/Aagon/Soest/Computer. |
| SELECTED_CLIENTS | Wird ein Client Command aus einem ACMP Abfrageergebnis als Push ausgeführt, wird diese Variable befüllt. Sie beinhaltet eine Auflistung aller Client-IDs von Agenten, die in dem Abfrageergebnis selektiert wurden. Es wird davon abgeraten, direkt mit dieser Variable zu arbeiten und stattdessen das Command Iterate Selected Clients zu verwenden. Zur Laufzeit wird die Variable wie folgt befüllt: 0={ACMP-ID des ersten Clients}, 1={ACMP-ID des zweiten Clients}, 2={ACMP-ID des dritten Clients}, etc. |
| SELECTED_COMPUTERNAMES | Wird ein Client Command aus einem ACMP Abfrageergebnis als Push ausgeführt, wird diese Variable befüllt. Die Variable beinhaltet eine Auflistung aller Computernamen der Agenten, die in dem Abfrageergebnis selektiert wurden. Es wird davon abgeraten, direkt mit dieser Variable zu arbeiten und stattdessen das Command Iterate Selected Clients zu verwenden. Zur Laufzeit wird die Variable wie folgt befüllt: 0=Computername1, 1=Computername2, 2=Computername3, etc. |
| SELECTED_IPADDRESSES | Wenn ein Client Command aus einem ACMP Abfrageergebnis als Push ausgeführt wird, wird diese Variable befüllt. Die Variable beinhaltet eine Auflistung aller IP-Adressen der Agenten, die in dem Abfrageergebnis selektiert wurden. Es wird davon abgeraten, direkt mit dieser Variable zu arbeiten und stattdessen das Command Iterate Selected Clients zu verwenden. Zur Laufzeit wird die Variable wie folgt befüllt: 0={IP-Adresse 1}, 1={IP-Adresse 2}, 2={IP-Adresse 3}, etc. |
| SELECTED_LASTLOGGEDONUSERS | Wird ein Client Command aus einem ACMP Abfrageergebnis als Push ausgeführt, wird diese Variable befüllt. Die Variable beinhaltet eine Auflistung aller zuletzt angemeldeter Benutzer, die in dem Abfrageergebnis selektiert wurden. Es wird davon abgeraten, direkt mit dieser Variable zu arbeiten und stattdessen das Command Iterate Selected Clients zu verwenden. Zur Laufzeit wird die Variable wie folgt befüllt: 0=Benutzer1, 1=Benutzer2, 2=Benutzer3, etc. Der Benutzer1 ist dabei der zuletzt angemeldete Benutzer auf dem ersten Client aus dem selektierten Abfrageergebnis, der Benutzer2 der zuletzt angemeldete Benutzer auf dem zweiten Client etc. |
| SICS_ROUTING_KEY | Wird ein Client Command als Job an einen Container angefügt, wird diese Variable bei Ausführung auf dem Client über den Container mit dem Pfad befüllt. Der Wert kann als Vorschau in dem Container Plugin für den entsprechenden Container eingesehen werden. Diesen können Sie auch in der Ansicht der Container lesen, z.B. acmp.local.Aagon.Soest.Computer. Der Pfad wird durch Punkte getrennt. |
Systemvariablen
Diese Variablen beschreiben das aktuelle System, auf welchem das Client Command ausgeführt werden soll. So lassen sich einfach rechnerbezogene Werte auslesen (z.B. Computername, Name des Serverports, jegliche Verzeichnisse oder auch das Betriebssystem).
Note:
Diese Variablen können nur gelesen werden.
Eine besondere Stellung verfügt die Systemvariable CallerType, die nachfolgend genauer erklärt wird.
CallerType
In jedem Client Command, ist es möglich, zu unterscheiden, wie es gestartet wurde. Für diese Unterscheidung wird die Systemvariable CallerType verwendet.
Folgende Werte kann %CallerType% annehmen:
| GUI | Wurde ein Client Command über den ACMP Kiosk und vom Command Launcher auf einem Client ausgeführt, nimmt der %CallerType% diesen Wert an. |
| CONSOLE | Wurde das Client Command automatisch aus der ACMP Console heraus ausgeführt, wird der %CallerType% mit diesem Wert befüllt. |
| CLIENTSVC | Wurde das Client Command als Job entweder einmalig oder wiederkehrend ausgeführt, wird der %CallerType% diesen Wert annehmen. |
| RUNCC | Wurde das Client Command via RunCC bzw. WRunCC aufgerufen, wird der %CallerType% diesen Wert annehmen. Wird das Client Command Run Client Command gestartet, so liefert der %CallerType% ebenfalls den Wert RUNCC zurück. |
| Rollout | Wurde das Client Command im Post-Deployment von ACMP OS Deployment aufgerufen, so wird dieser %CallerType% zurückgeliefert. |
Globale ACMP Variablen
Mithilfe einer ACMP Variable können Eigenschaften, die global die ACMP Console betreffen, ausgelesen werden. Jedem Client Command stehen diese globalen Variablen und deren Werte zur Verfügung.
Sie definieren die globalen Variablen in der Ribbonleiste unter Client Commands > Werkzeuge > Globale Variablen verwalten.
Note:
Globale Variablen werden nicht von Client Commands mit exportiert.
Folgende Variablen werden standardmäßig mitgeliefert:
| DEPARTMENT | Die globalen Variable „DEPARTMENT“ wird vom mitgelieferten Client Command „Client Location“ und „Client Location (Configuration)“ im „Data Collection“-Ordner verwendet. |
| LOCATION | Die globalen Variable „LOCATION“ wird vom mitgelieferten Client Command „Client Location“ und „Client Location (Configuration)“ im „Data Collection“-Ordner verwendet. |
| URL_HELPDESK | Diese Variable wird im Client Command „Create Helpdesk Shortcut“ verwendet. |
| URL_SELFSERVICE | Diese Variable wird in den Client Commands „Create Self-Service Shortcut“ und „Create Self-Service Shortcut (Single Sign On)“ verwendet. |