KACE Systems Management Appliance 13.2 Common Documents

Syntax für Regeln für benutzerdefinierte Inventarisierung

In Regeln für benutzerdefinierte Inventarisierung muss für Funktionsnamen und Argumente die korrekte Syntax verwendet werden.

Für Bedingungs- und Werterückgabe-Regeln gilt folgende Syntax:

functionName(argument,argument,...)

Detaillierte Informationen zu Funktionen und deren Argumenten finden Sie unter:

•

Überprüfen von Bedingungen (Bedingungsregeln)

•

Abrufen von Werten von einem Gerät (Benutzerdefiniertes Inventarfeld)

•

Zuordnen von Dateinamen zu regulären Ausdrücken

Funktionen – Syntax

Geben Sie den Funktionsnamen, eine öffnende Klammer, die gewünschten Argumente und eine schließende Klammer ein. Zwischen dem Namen der Funktion und der öffnenden Klammer dürfen sich keine Leerzeichen befinden.

Argumente – Syntax

Geben Sie die argument-Syntax für alle Regeln mit Ausnahme von command und regex (regulärer Ausdruck) wie folgt ein:

•

Trennen Sie die Argumente durch Kommas voneinander.

•

Kommas sind an keiner anderen Stelle der Zeichenfolge zulässig (Ausnahmen finden Sie unter Kommas und Klammern als Werte in einer Regel).

•

Fügen Sie keine einfachen oder doppelten Anführungszeichen hinzu.

•

Leerzeichen vor und nach jedem Argument werden gelöscht.

Beispielsweise sind die folgenden Syntaxzeilen identisch:

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox, CurrentVersion, 78.0.2)
RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox,CurrentVersion,78.0.2)

Kommas und Klammern als Werte in einer Regel

Wenn in einer Regel Kommas oder öffnende/schließende Klammern als Werte verwendet werden, müssen diese als {{comma}} (Komma). {{op}} (öffnende Klammer) und {{cp}} (schließende Klammer) angegeben werden.

•

In Argumenten, in denen Kommas als Teil des Parameterwerts angegeben werden müssen, muss das Komma als "{{comma}}" angegeben werden. Hiervon ausgenommen ist nur das letzte Argument in der Funktion.

Möchte der Benutzer also beispielsweise einen Test für den Registrierungswert mit dem Wertnamen "test,value" durchführen, muss er in diesem Fall die Escape-Sequenz für das Komma angeben, da es sich bei dem Namen des Registrierungswerts nicht um das letzte Argument in der Funktion für benutzerdefinierte Inventarisierung (Custom Inventory, CI) handelt.

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft, test{{comma}}value, HelloWorld)

Möchte der Benutzer einen Test für einen Registrierungswert mit enthaltenem Komma durchführen, muss keine Escape-Sequenz verwendet werden, da es sich bei dem Wert um das letzte Argument in der Funktion für benutzerdefinierte Inventarisierung handelt. Mit der folgenden Funktion für die benutzerdefinierte Inventarisierung wird getestet, ob der Registrierungswert "HKLM\SOFTWARE\TestSoft\test1" mit dem Wert 2,4 übereinstimmt.

RegistryValueEquals(HKEY_LOCAL_MACHINE\SOFTWARE\TestSoft,test1,2,4)

Enthält die Funktion für benutzerdefinierte Inventarisierung lediglich einen einzelnen Parameter, wird alles zwischen den Klammern als Wert für das Argument behandelt. In diesem Fall muss für Kommas keine Escape-Sequenz verwendet werden und die Kommas werden als Teil des Arguments für die Funktion für benutzerdefinierte Inventarisierung betrachtet.

ShellCommandTextReturn(wmic MEMORYCHIP get BankLabel,Capacity,description,manufacturer)

•

Für eine öffnende Klammer ohne Gegenstück muss die Escape-Sequenz {{op}} verwendet werden. Wenn der Parser die Argumente für die Funktion in Token umwandelt, wird die Anzahl öffnender und schließender Klammern gezählt, um das Ende der Funktion und des Arguments zu ermitteln. Eine öffnende Klammer ohne Gegenstück würde die Zählung durcheinander bringen und dazu führen, dass der Argumentwert nicht korrekt analysiert wird. Wird in einem Argumentwert eine öffnende Klammer benötigt, muss diese als {{op}} angegeben werden.

Möchte der Benutzer also beispielsweise die Zeichenfolge "Hello ( World" ausgeben, muss die Funktion für benutzerdefiniertes Inventar wie folgt aussehen:

ShellCommandTextReturn(echo Hello {{op}} World)

•

Für eine schließende Klammer ohne Gegenstück muss die Escape-Sequenz {{cp}} verwendet werden.

Wenn der Parser die Argumente für die Funktion in Token umwandelt, wird die Anzahl öffnender und schließender Klammern gezählt, um das Ende der Funktion (die letzte schließende Klammer mit Gegenstück) zu ermitteln. Enthält jedoch der eigentlich Argumentwert eine schließende Klammer ohne Gegenstück, entsteht für den Parser der Eindruck, die Klammer sei das Ende der Funktion und der Argumentwert wird abgeschnitten.

Wird in einem Argumentwert eine schließende Klammer benötigt, muss diese als {{cp}} angegeben werden.

Möchte der Benutzer also beispielsweise die Zeichenfolge "Hello ) World" ausgeben, muss die Funktion für benutzerdefiniertes Inventar wie folgt aussehen:

ShellCommandTextReturn(echo Hello {{cp}} World)

Überprüfen von Bedingungen (Bedingungsregeln)

Sie können Regeln für benutzerdefinierte Inventarisierung erstellen, um zu ermitteln, ob eine Anwendung installiert ist (wahr/falsch).

Wenn bei Verwendung einer Bedingungsregel "Wahr" zurückgegeben wird, wird der Anzeigename (Titel) der benutzerdefinierten Anwendung im Bereich Software: Installierte Programme der Seite Gerätedetail im Abschnitt Inventar angezeigt.

In den folgenden Abschnitten werden die Regeln beschrieben, mit denen Bedingungen überprüft werden:

•

Referenz für Bedingungsregeln

•

Überprüfen, ob eine Bedingung vorhanden ist (Exists-Regeln)

•

Auswerten von Geäteeinstellungen (Equals-Regeln)

•

Vergleichen von Gerätewerten (GreaterThan- und LessThan-Regeln)

•

Testen mehrerer Bedingungen

Trifft die Regel nicht zu ("Falsch"), wird die Anwendung nicht unter Installierte Programme in den Inventardetails des Geräts angezeigt.

TIPP: Eine Liste der Geräte, auf denen das Element installiert ist, wird auch unter Inventar > Software > Benutzerdefiniertes_Element: Details angezeigt.

Referenz für Bedingungsregeln

In der folgenden Tabelle wird beschrieben, welche Datentypen für den Vergleich verwendet werden können.

Für Vergleichsfunktionen unterstützte Datentypen
Bedingungsregel	Für Vergleichsfunktionen unterstützte Datentypen Equals, GreaterThan, LessThan
EnvironmentVariable	DATE, NUMBER, TEXT
FileInfo	DATE, NUMBER, TEXT
FilenamesMatchingRegex	NUMBER
FileVersion	TEXT
PlistValue	NUMBER, TEXT
ProductVersion	TEXT
RegistryValue	TEXT

In der folgenden Tabelle wird die Vorgehensweise zum Ausführen von Vergleichen erläutert.

Ausführen von Vergleichen

Datentyp

Überlegungen

DATE

•

Vor der Auswertung werden Zielwerte als Datum mithilfe der gleichen Regeln wie in der DateTime-PHP-Klasse analysiert und anschließend für die Verwendung des folgenden Formats normalisiert:

MM/TT/JJJJ HH:MM:SS

•

Der Zeitstempel in der Appliance-Datenbank verwendet das 24-Stunden-Format (0 – 24 Stunden).

•

Der Zeitstempel in der Appliance-Datenbank ist in koordinierter Weltzeit (UTC, Coordinated Universal Time) angegeben, sodass er für alle Geräte unabhängig von den entsprechenden Zeitzonen normalisiert wird.

•

Enthält der Zielwert nur ein Datum, wird ein Zeitstempel hinzugefügt, der auf Mitternacht für UTC basiert.

NUMBER

•

Nur ganze Zahlen werden bewertet.

•

Falls ein Zielwert andere Zeichen (Buchstaben, Satzzeichen usw.) enthält, werden nur die Zahlen vor dem ersten Zeichen bewertet.

Beispiel: Lautet der Zielwert "52a1" wird nur "52" bewertet.

•

Es werden nur Zahlen bis zum maximalen positiven ganzzahligen 32-Bit-Wert (2.147.483.647) unterstützt.

TEXT

•

Werte werden wortwörtlich ohne mögliche Formatierungsänderungen (wie es beispielsweise bei den Datentypen DATE und NUMBER der Fall sein kann) bewertet.

•

Textfolgen müssen in lexikografischer Reihenfolge bewertet werden.

•

Die bewerteten Zeichenfolgen dürfen Kommas enthalten. Es sind keine Escape-Zeichen erforderlich.

Die folgende Tabelle enthält eine Liste der verfügbaren Bedingungsregeln mit Links zu näheren Informationen dazu, wie die Argumente angegeben werden:

Referenz für Bedingungsregeln
Syntax	Windows	RHEL	OS X	Beschreibung
DirectoryExists (path)	X	X	X	Überprüft, ob im angegebenen Pfad auf dem Gerät ein Verzeichnis vorhanden ist.
FileExists (path)	X	X	X	Überprüft, ob im angegebenen Pfad auf dem Gerät eine Datei vorhanden ist. Geben Sie im Pfad den Namen der Datei und die Erweiterung an.
FileVersionEquals (path, version)	X			Überprüft, ob die Eigenschaft Version > Dateiversion der im Pfad angegebenen Datei dem eingegebenen TEXT-Wert entspricht.
FileVersionLessThan (path, version)	X			Überprüft, ob die Eigenschaft Version > Dateiversion der als Pfad angegebenen Datei niedriger als der eingegebene TEXT-Wert ist.
FileVersionGreaterThan (path, version)	X			Überprüft, ob die Eigenschaft Version > Dateiversion der angegebenen Datei höher als der eingegebene TEXT-Wert ist.
ProductVersionEquals (path, version)	X			Überprüft, ob die Eigenschaft Version > Produktversion der angegebenen ausführbaren Datei oder Installationsdatei dem eingegebenen TEXT-Wert entspricht.
ProductVersionLessThan (path, version)	X			Überprüft, ob die Eigenschaft Version > Produktversion der angegebenen ausführbaren Datei oder Installationsdatei niedriger als der eingegebene TEXT-Wert ist.
ProductVersionGreaterThan (path, version)	X			Überprüft, ob die Eigenschaft Version > Produktversion der angegebenen ausführbaren Datei oder Installationsdatei höher als der eingegebene TEXT-Wert ist.
FileInfoGreaterThan (fullpath, attribute, type, value)	X	X	X	Überprüft, ob der Wert für die Eigenschaft Dateiinfo der von Ihnen angegebenen ausführbaren Datei bzw. Installationsdatei größer ist als der von Ihnen eingegebene Wert.
FileInfoLessThan (fullpath, attribute, type, value)	X	X	X	Überprüft, ob der Wert für die Eigenschaft Dateiinfo der von Ihnen angegebenen ausführbaren Datei bzw. Installationsdatei kleiner ist als der von Ihnen eingegebene Wert.
FileInfoEquals (fullpath, attribute, type, value)	X	X	X	Überprüft, ob die attribute-Eigenschaft der von Ihnen angegebenen ausführbaren Datei bzw. Installationsdatei dem von Ihnen eingegebenen Wert entspricht.
RegistryKeyExists (registryPath)	X			Überprüft, ob ein Registrierungsschlüssel vorhanden ist.
RegistryValueEquals (registryPath, valueName, value)	X			Überprüft, ob ein Registrierungsschlüssel genau dem von Ihnen eingegebenen Wert entspricht. Der Wert wird als TEXT verglichen.
RegistryValueLessThan (registryPath, valueName, value)	X			Überprüft, ob ein Registrierungseintrag niedriger ist als der von Ihnen eingegebene Wert. Der Wert ist ein TEXT-Wert.
RegistryValueGreaterThan (registryPath, valueName, value)	X			Überprüft, ob ein Registrierungseintrag höher ist als der von Ihnen eingegebene Wert. Der Wert ist ein TEXT-Wert.
EnvironmentalVariableExists (var)	X	X	X	Überprüft, ob eine Umgebungsvariable mit dem von Ihnen angegebenen Namen vorhanden ist.
EnvironmentalVariableGreaterThan (var, type, value)	X	X	X	Überprüft, ob die Definition der Umgebungsvariablen höher ist als der von Ihnen eingegebene Wert. Alle drei Typen sind gültig: TEXT, DATE (im vollständigen Format mm/tt/jjjj hh:mm:ss) und NUMBER.
EnvironmentalVariableLessThan (var, type, value)	X	X	X	Überprüft, ob die Definition der Umgebungsvariablen niedriger ist als der von Ihnen eingegebene Wert. Alle drei Typen sind gültig: TEXT, DATE (im vollständigen Format mm/tt/jjjj hh:mm:ss) und NUMBER.
EnvironmentalVariableEquals (var, type, value)	X	X	X	Überprüft, ob die Definition der Umgebungsvariablen genau dem von Ihnen eingegebenen Wert entspricht. Alle drei Typen sind gültig: TEXT, DATE (im vollständigen Format mm/tt/jjjj hh:mm:ss) und NUMBER.
PlistValueExists (fullpath, entry)			X	Überprüft, ob ein benannter Wert in einer PLIST-Datei vorhanden ist.
PlistValueGreaterThan (fullpath, entry, type, value)			X	Überprüft, ob der benannte Wert ein NUMBER- oder TEXT-Wert und höher als der angegebene Wert ist.
PlistValueLessThan (fullpath, entry, type, value)			X	Überprüft, ob der benannte Wert ein NUMBER- oder TEXT-Wert und niedriger als der angegebene Wert ist.
PlistValueEquals (fullpath, entry, type, value)			X	Überprüft, ob der benannte Wert ein NUMBER- oder TEXT-Wert ist und genau dem angegebenen Wert entspricht.

Informationen zu Equals, GreaterThan und LessThan für FilenamesMatchingRegex finden Sie unter Referenz zu Regeln mit regulären Ausdrücken.

Überprüfen, ob eine Bedingung vorhanden ist (Exists-Regeln)

Mit Regeln, deren Name mit Exists endet, wird überprüft, ob eine Datei, ein Verzeichnis, ein Registrierungsschlüssel oder ein anderes Element vorhanden ist. Wenn der KACE Agent das Element auf dem Gerät ermittelt, wird die Regel als "Wahr" ausgewertet und das Element als installiertes Programm angezeigt.

Verwenden Sie eine der folgenden Exists-Regeln:

•

DirectoryExists (path)

•

FileExists (path)

•

RegistryKeyExists (registryPath)

•

EnvironmentalVariableExists (var)

•

PlistValueExists (fullpath, entry)

•

FilenameMatchingRegexExist (fullpath, regex)

Beispiel: Überprüfen, ob ein Verzeichnis (Ordner) vorhanden ist

Mit dem folgenden Beispiel wird getestet, ob das Windows Verzeichnis auf dem Gerät vorhanden ist:

DirectoryExists(C:\WINDOWS\)

Beispiel: Überprüfen, ob eine Datei vorhanden ist

HINWEIS: Mit dem folgenden Beispiel wird überprüft, ob die ausführbare Notepad-Datei auf dem Gerät vorhanden ist:

FileExists(C:\WINDOWS\notepad.exe)

Auswerten von Geäteeinstellungen (Equals-Regeln)

Mit Regeln, deren Name mit Equals endet, werden die Werte auf dem Gerät mit den Werten verglichen, die Sie in der Regel angeben. Die Regeln sind zutreffend ("Wahr"), wenn die Werte genau übereinstimmen.

Mithilfe von Regeln, in denen Argumente mit festgelegten Datentypen verwendet werden, können nur Werte desselben Typs verglichen werden.

Verwenden Sie eine der folgenden Equals-Regeln:

•

FileVersionEquals (path, version)

•

ProductVersionEquals (path, version)

•

FileInfoEquals (fullpath, attribute, type, value)

•

RegistryValueEquals (registryPath, valueName, value)

•

EnvironmentalVariableEquals (var, type, value)

•

PlistValueEquals (fullpath, entry, type, value)

•

FilenameMatchingRegexEqual (fullpath, regex, value)

Beispiel: Testen der Einstellung JAVA_HOME

So überprüfen Sie, ob die Einstellung für JAVA_HOME C:\Program Files\Java\jdk1.6.0_02 ist:

EnvironmentVariableEquals(JAVA_HOME, TEXT, C:\Program Files\Java\jdk1.6.0_02)

Beispiel: Testen der Einstellung des McAfee®-Registrierungseintrags

So überprüfen Sie, ob für die Einstellung das Datumsformat im Eintrag verwendet wird

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\McAfee\AVEngine, AVDatDate, 2014/03/01)

Beispiel: Erkennen von Windows XP Service Pack 1

Windows XP Service Pack 1 wird nur für Geräte, auf denen ursprünglich SP1 ausgeführt wurde und die dann auf SP1 heraufgestuft wurden, unter Software angezeigt. Im standardmäßigen Anwendungsinventar für dieses Element sind keine Geräte erfasst, auf denen bereits SP1 ausgeführt wird, da für diese Geräte ursprünglich ein Image auf SP1-Ebene erstellt wurde.

Erstellen Sie die folgende Regel für benutzerdefinierte Inventarisierung für eine benutzerdefinierte Anwendung, wenn Sie die Appliance zur Bereitstellung von Windows 7 Service Pack 1 einsetzen:

RegistryValueEquals(HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\

CurrentVersion,CSDVersion,Service Pack 2)

Sie können dann Geräte ausschließen, auf denen dieses Element installiert ist, um zu verhindern, dass die Appliance versucht, SP2 auf Geräten bereitzustellen, die sich bereits auf dieser Stufe befinden (d. h. Geräte mit SP1, für die ein Upgrade durchgeführt wurde, sowie Geräte, deren Images ursprünglich mit SP2 erfasst wurden).

Vergleichen von Gerätewerten (GreaterThan- und LessThan-Regeln)

Mit Funktionen, deren Namen auf GreaterThan und LessThan enden, werden nur die unter Table 24 aufgeführten Werte verglichen.

Verwenden Sie eine der folgenden Regeln vom Typ "GreaterThan" und "Less Than":

•

FileVersionGreaterThan (path, version) und FileVersionLessThan (path, version)

•

ProductVersionGreaterThan (path, version) und ProductVersionLessThan (path, version)

•

FileInfoGreaterThan (fullpath, attribute, type, value) und FileInfoLessThan (fullpath, attribute, type, value)

•

RegistryValueGreaterThan (registryPath, valueName, value) und RegistryValueLessThan (registryPath, valueName, value)

•

EnvironmentalVariableGreaterThan (var, type, value) und EnvironmentalVariableLessThan (var, type, value)

•

PlistValueGreaterThan (fullpath, entry, type, value) und PlistValueLessThan (fullpath, entry, type, value)

•

FilenameMatchingRegexGreaterThan (fullpath, regex, value) und FilenameMatchingRegexLessThan (fullpath, regex, value)

Beispiel: Testen, ob die Produktversion höher ist

So überprüfen Sie, ob die Produktversion höher ist als eine bestimmte Nummer:

ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe, 78)

Geben Sie Folgendes ein, um zu überprüfen, ob die Produktversion gleich oder höher einer bestimmten Version ist:

ProductVersionEquals(C:\Program Files\Mozilla Firefox\firefox.exe, 78)

OR ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe,

78)

Beispiel: Testen, ob eine Produktversion innerhalb eines bestimmten Bereichs liegt

Zum Testen, ob sich die Produktversion innerhalb eines bestimmten Bereichs befindet, kombinieren Sie Less Than- und Greater Than-Regeln:

ProductVersionGreaterThan(C:\Program Files\Mozilla Firefox\firefox.exe, 77)
AND ProductVersionLessThan(C:\Program Files\Mozilla Firefox\firefox.exe, 79)

WICHTIG: Geben Sie Regeln nicht in separate Zeilen ein. Trennen Sie die Regeln nur durch ein Leerzeichen. Wenn sich Regeln in separaten Zeilen befinden, wird dadurch die Verbindungsregel außer Kraft gesetzt.

Testen mehrerer Bedingungen

Sie können Regeln mit den Operatoren UND oder ODER verknüpfen, um zu testen, ob mehrere Bedingungen zutreffen.

HINWEIS: Die Verwendung beider Operatoren (UND und ODER) in der gleichen Regel für benutzerdefinierte Inventarisierung wird nicht unterstützt. Richten Sie getrennte Anwendungen ein.

Durch die Verknüpfung von Bedingungsregeln werden folgende Ergebnisse erzielt:

•

Operator UND: Alle Regeln müssen zutreffen ("Wahr" sein), damit die Ergebnisse ebenfalls zutreffend ("Wahr") sind und die Anwendung als installiertes Programm gemeldet wird.

•

Operator ODER: Nur eine Regel muss zutreffen ("Wahr" sein), damit die Anwendung als installiertes Programm gemeldet wird.

Überprüfen, ob mehrere Bedingungen zutreffen (UND)

Verwenden Sie den Operator UND, um Bedingungsregeln im Feld für benutzerdefinierte Inventarisierung zu verknüpfen, wenn das Element nur dann als installiertes Programm gemeldet werden soll, wenn alle Regeln zutreffen ("Wahr" sind).

Verknüpfen Sie im Feld für benutzerdefinierte Inventarisierung Regeln mithilfe der folgenden Syntax:

Funktion
(Argumente ...
) AND Funktion
(Argumente
) AND ...

Trennen Sie die Bedingungsanweisung durch Leerzeichen vom Operator.

Beispiel: Überprüfen, ob ein Registrierungsschlüssel vorhanden ist, und Vergleichen von Werten

Zum Überprüfen, ob ein Registrierungsschlüssel und ein Registrierungseintragswert auf einem Windows Gerät vorhanden sind, kombinieren Sie die Regeln wie folgt mit dem Operator AND:

RegistryKeyExists(registryPath
) AND RegistryValueEquals(registryPath, valueName, value)

Überprüfen, ob eine Bedingung zutrifft (ODER)

Wenn Sie Regeln mit dem Operator ODER verknüpfen und eine der Regeln im Feld für benutzerdefinierte Inventarisierung zutrifft ("Wahr" ist), wird die Anwendung in der Liste Installierte Programme des Geräts angezeigt.

Verknüpfen Sie die Regeln im Feld für benutzerdefinierte Inventarisierung mithilfe der folgenden Syntax:

Funktion
(Argumente
) OR Funktion
(Argumente
) OR ...

Trennen Sie die Funktionsanweisungen und den Operator mithilfe eines Leerzeichens voneinander.

Beispiel: Überprüfen eines Registrierungswerts

So überprüfen Sie, ob ein Registrierungswert einen bestimmten Wert oder einen anderen Wert aufweist:

RegistryValueEquals(registryPath, valueName, value) OR
RegistryValueEquals(registryPath, valueName, value)

TIPP: Verwenden Sie zur Angabe eines Bereichs die Regeln RegistryValueGreaterThan und RegistryValueLessThan und verknüpfen Sie sie mit dem Operator AND.

Abrufen von Werten von einem Gerät (Benutzerdefiniertes Inventarfeld)

Mit Regeln, die auf ValueReturn enden, können Informationen vom Gerät abgerufen werden. Diese Regeln ermöglichen das Abrufen von Informationen, die der KACE Agent normalerweise nicht erfasst.

Die zurückgegebenen Werte werden mit dem Anzeigenamen der benutzerdefinierten Anwendung (Titel) festgelegt. Die wird auf der Seite Gerätedetails unter Software in den Feldern Installierte Programme und Felder für benutzerdefinierte Inventarisierung angezeigt.

Verwenden Sie die Werte des Felds für benutzerdefinierte Inventarisierung für die Verwaltung von Installationen sowie zur Verteilung von Software und Berichten, dem Filter Anzeigen nach und Smart Label-Suchkriterien oder anderer Prozesse, die mit einer automatisch erkannten Einstellung durchgeführt werden können.

In diesem Abschnitt werden die folgenden Themen behandelt:

•

Referenz für Werterückgabe-Regeln

•

Abrufen von Registrierungsschlüsselwerten

•

Abrufen der Befehlsausgabe

•

Abrufen von PLIST-Werten

•

Abrufen mehrerer Werte

Referenz für Werterückgabe-Regeln

Die folgende Tabelle enthält alle verfügbaren Werterückgabe-Regeln, mit denen Sie ein Feld für benutzerdefinierte Inventarisierung festlegen können:

Syntax	Windows	RHEL	OS X	Beschreibung
RegistryValueReturn (registryPath, valueName, type)	X			Gibt den Wert eines Registrierungseintrags zurück und legt den von Ihnen angegebenen Datentyp fest.
EnvironmentalVariableReturn (var, type)Angeben von Umgebungs- oder Benutzervariablen	X	X	X	Gibt den Wert einer Umgebungsvariable zurück und legt den von Ihnen angegebenen Datentyp fest.
FileInfoReturn (path, attribute, type)	X	X	X	Gibt den Wert eines Dateiattributs zurück. Gültige Typen finden Sie unter Definieren von Regelargumenten.
ShellCommandTextReturn (command)	X	X	X	Gibt die Befehlsausgabe zurück und legt den Datentyp auf TEXT fest.
ShellCommandDateReturn (command)	X	X	X	Gibt die Befehlsausgabe zurück und legt den Datentyp auf DATE fest.
ShellCommandNumberReturn (command)	X	X	X	Gibt die Befehlsausgabe zurück und legt den Datentyp auf NUMBER fest.
PlistValueReturn (fullpath, entry, type)			X	Gibt den Wert des Schlüssels PLIST zurück und legt den Datentyp auf TEXT, NUMBER oder DATE fest.

Abrufen von Dateiinformationswerten

Mit der Regel FileInfoReturn können Sie das Feld für benutzerdefinierte Inventarisierung auf jedes der Attribute für Windows Dateiinformationen festlegen.

Beispiel: Version von Mozilla Firefox abrufen

Mit dem folgenden Beispiel wird das Feld für benutzerdefinierte Inventarisierung für die Produktversion von Mozilla Firefox als NUMBER-Wert festgelegt.

Geben Sie im Feld für benutzerdefinierte Inventarisierung Folgendes ein:

FileInfoReturn(C:\Program Files\Mozilla Firefox\firefox.exe,CurrentVersion,TEXT)

Abrufen von Registrierungsschlüsselwerten

Sie können das Feld für benutzerdefinierte Inventarisierung auf einen Registrierungsschlüssel festlegen. Verwenden Sie hierzu die Regel RegistryValueReturn. Dabei ist registryPath (auf der linken Seite) der Pfad zu dem Eintrag und valueName (auf der rechten Seite) der Schlüssel, der zurückgegeben werden soll. Die Abbildung zeigt den Registrierungs-Editor mit der Verzeichnisstruktur (links) sowie mit Name, Typ und Daten (rechts).

Beispiel: CurrentVersion-Schlüssel für Mozilla FireFox abrufen

So legen Sie den CurrentVersion-Registrierungsschlüssel als Feld für benutzerdefinierte Inventarisierung fest:

RegistryValueReturn (HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Mozilla Firefox\CurrentVersion, TEXT

Abrufen der Befehlsausgabe

Mithilfe von Befehlsregeln können Sie die Ausgabe eines Befehls als Feld für benutzerdefinierte Inventarisierung festlegen. Der Befehl richtet sich nach dem Befehlsinterpreter und dem ausführbaren Pfad auf dem Gerät.

Beispielsweise können Sie auf Windows-Geräten zwar MS-DOS-Befehle erstellen aber keine UNIX-Befehle im Cygwin-Stil, es sei denn Cygwin ist im Standardpfad für alle Benutzer installiert und verfügbar.

Verwenden Sie eine der folgenden Regeln, um die Ausgabe des Befehls als Feld für benutzerdefinierte Inventarisierung festzulegen:

•

ShellCommandTextReturn (command)

•

ShellCommandDateReturn (command)

•

ShellCommandNumberReturn (command)

Beispiel: Abrufen der Betriebszeit für Mac OS X

So legen Sie die Betriebszeit als Feld für benutzerdefinierte Inventarisierung fest:

ShellCommandTextReturn(/usr/bin/uptime | sed -e 's/.*load averages://' | awk '{print $1}')

Abrufen von PLIST-Werten

Mit Regeln vom Typ PlistValueReturn kann ein Eigenschaftenlistenschlüssel (PList-Schlüssel) als Feld für benutzerdefinierte Inventarisierung festgelegt werden.

Beispiel: Abrufen des Systemgebietsschemas

Zur Verteilung von Anwendungen mithilfe verwalteter Installationen unter Zugrundelegung der vom System bereitgestellten Sprache geben Sie die folgende Regel ein, um das Gebietsschema des Geräts abzurufen und anschließend ein entsprechendes Smart Label zu erstellen, das basierend auf dem vom KACE SMA Agenten im Feld für benutzerdefinierte Inventarisierung gemeldeten Sprachcode auf das Gerät angewendet wird:

PlistValueReturn(~/Library/Preferences/GlobalPreferences.plist, AppleLocale, TEXT)

Abrufen mehrerer Werte

Verknüpfen Sie ValueReturn-Regeln entweder mit dem Operator UND oder ODER. Die Regel zeigt die Anwendung als installiertes Programm an, sofern einer oder mehrere der Werte nicht leer sind.

Die verknüpften Werte werden, getrennt durch den Operator, alle im gleichen Feld für benutzerdefinierte Inventarisierung festgelegt und gelten daher für Suchkriterien, Filter, Berichte und andere Prozesse der Appliance technisch gesehen als TEXT-Werte.

Regeln vom Typ ValueReturn mit folgender Verknüpfung:

•

Operator UND: Alle Werte werden im Feld für benutzerdefinierte Inventarisierung erfasst.

•

Operator ODER: Alle Werte werden im Feld für benutzerdefinierte Inventarisierung erfasst.

Verknüpfen Sie im Feld für benutzerdefinierte Inventarisierung Regeln mithilfe der folgenden Syntax:

Funktion(Argumente ...) AND Funktion(Argumente) AND ...

Trennen Sie die Bedingungsanweisung durch Leerzeichen vom Operator. Verwenden Sie die Operatoren AND und OR nicht in derselben Regel.

Zuordnen von Dateinamen zu regulären Ausdrücken

Die regulären Ausdrücke

Referenz zu Regeln mit regulären Ausdrücken

Mit regulären Ausdrücken wird ein Zeichen oder die angegebene Zeichenfolge mit den Dateinamen im angegebenen Verzeichnis abgeglichen.

In diesem Abschnitt werden die regulären Ausdrücke beschrieben, die Dateinamen in Bedingungs- und Werterückgabe-Regeln unter Verwendung eines regulären Ausdrucks zuordnen.

HINWEIS: Der KACE Agent bietet nur Funktionen, die Dateinamen mithilfe regulärer Ausdrücke vergleichen.

Seleziona il prodotto:

Per una maggiore efficacia, compilare l'Obiettivo della chat:

Soluzioni consigliate per il problema

KACE Systems Management Appliance 13.2 Common Documents - Administratorhandbuch (13.0)

Syntax für Regeln für benutzerdefinierte Inventarisierung

Überprüfen von Bedingungen (Bedingungsregeln)

Abrufen von Werten von einem Gerät (Benutzerdefiniertes Inventarfeld)

Zuordnen von Dateinamen zu regulären Ausdrücken