KACE as a Service 7.1 - Administratorhandbuch

Mit Regeln, die auf ValueReturn enden, können Informationen vom Gerät abgerufen werden. Diese Regeln ermöglichen das Abrufen von Informationen, die der K1000 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 Feldes 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: Abrufen der Produktversion von Windows Internet Explorer

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

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

FileInfoReturn(C:\Program Files\Internet Explorer\iexplore.exe,ProductVersion,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: Abrufen des ProductID-Schlüssels für Internet Explorer

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

RegistryValueReturn (HKEY_LOCAL_MACHINE\application\Microsoft\Internet Explorer\

Registrierung, ProductId, 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 systemeigenen 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 K1000 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 K1000 Agent bietet nur Funktionen, die Dateinamen mithilfe regulärer Ausdrücke vergleichen.

Die regulären Ausdrücke

Die Syntax regulärer Ausdrücke kann für den Abgleich von Dateinamen verwendet werden.

TIPP: Weitere Informationen zum Erstellen von regulären Ausdrücken finden Sie unter https://msdn.microsoft.com/de-de/library/az24scfc.aspx.

Die folgende Tabelle enthält eine Übersicht über die Syntax regulärer Ausdrücke für den Abgleich von Dateinamen:

Zeichen	Beschreibung	Beispielausdruck	Zieldateien	Abgeglichene Dateien
(beliebige Zeichenfolge)	Mit normalen Zeichen (keine Sonderzeichen) wird eine Übereinstimmung mit jedem Dateinamen gefunden, der die Zeichenfolge enthält.	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	Durch den Punkt wird ein einzelnes Zeichen zugeordnet. Wird der Punkt alleine eingegeben, wird eine Übereinstimmung mit allen Dateien gefunden.	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	Der umgekehrte Schrägstrich fungiert als Escape-Zeichen für Sonderzeichen oder dient zum Erstellen eines Rückverweises. Weitere Informationen hierzu finden Sie unter http://rexegg.com/regex-capture.html.	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	Mit dem Caret-Zeichen wird eine Übereinstimmung mit den Zeichen gefunden, die Sie am Anfang des Dateinamens angeben.	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	Mit dem Pipe-Zeichen wird eine Liste von zuzuordnenden Optionen getrennt.	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	Mit dem Dollar-Zeichen wird eine Übereinstimmung mit den Zeichen gefunden, die Sie am Ende des Dateinamens angeben.	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	Das Fragezeichen gibt an, dass das vorhergehende Zeichen in Übereinstimmungen optional ist.	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	Mit dem Sternchen wird null Mal oder mehrere Male eine Übereinstimmung mit dem vorherigen Zeichen gefunden.	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	Mit dem Pluszeichen wird einmal oder mehrere Male eine Übereinstimmung mit dem vorherigen Zeichen gefunden.	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	Klammern umschließen eine Zeichenklasse, und es wird eine Übereinstimmung mit jedem Zeichen innerhalb der Klammern gefunden. Spezielle Zeichenregeln für Zeichenklassen unterscheiden sich von normalen regulären Ausdrücken.	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	Durch Zeichen umschließende Klammern wird ein Rückverweis erstellt, und es wird eine Übereinstimmung mit den vorherigen Zeichen und/oder den Zeichen in den Klammern gefunden. Weitere Informationen hierzu finden Sie unter http://rexegg.com/regex-capture.html.	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	Durch geschweifte Klammern wird das vorherige Zeichen so oft wiederholt, wie angegeben ist, wobei n größer als 1 oder gleich 1 ist.	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

Referenz zu Regeln mit regulären Ausdrücken

Die Syntax einer Regel mit einem regulären Ausdruck unterscheidet sich leicht von der anderer Dateiregeln. Das Argument fullpath ist eine Zeichenfolge, die dem absoluten Pfad des Dateispeicherorts entspricht, den Namen der Datei aber nicht enthält. Der Dateiname wird als separates Argument unter Verwendung eines regulären Ausdrucks angegeben.

Die folgende Tabelle enthält eine Liste der Regeln, bei denen reguläre Ausdrücke verwendet werden können.

Syntax	Windows	RHEL	OS X	Beschreibung
FilenamesMatchingRegexExist (fullpath,regex)	X	X	X	Gibt "Wahr" zurück, wenn Dateien im angegebenen Verzeichnis dem Dateinamen entsprechen, den Sie unter Verwendung eines regulären Ausdrucks eingegeben haben.
FilenamesMatchingRegexGreaterThan (fullpath,regex,value)	X	X	X	"Wahr", wenn die Anzahl der übereinstimmenden Dateien größer ist als der Wert.
FilenamesMatchingRegexLessThan (fullpath,regex,value)	X	X	X	"Wahr", wenn die Anzahl der übereinstimmenden Dateien kleiner ist als der Wert.
FilenamesMatchingRegexEqual (fullpath,regex,value)	X	X	X	"Wahr", wenn die Anzahl der übereinstimmenden Dateien dem Wert entspricht.
FilenamesMatchingRegexReturn (fullpath,regex,type)	X	X	X	Legt das Feld für benutzerdefinierte Inventarisierung auf die übereinstimmenden Dateinamen fest (enthält den Pfad).

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

KACE as a Service 7.1 - Administratorhandbuch

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

Zuordnen von Dateinamen zu regulären Ausdrücken

Die regulären Ausdrücke

Referenz zu Regeln mit regulären Ausdrücken