KACE Systems Management Appliance 13.2 Common Documents

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).

Definieren von Regelargumenten

In Regeln für benutzerdefinierte Inventarisierung kann mithilfe von Argumenten nach Pfaden, Dateien, Registrierungsschlüsseln, Registrierungseinträgen, Versionsinformationen, Umgebungsvariablen und anderen Attributen zu gesucht werden.

Informationen zur Syntax und zur Nutzung der Regeln finden Sie in den Tabellen unter Überprüfen von Bedingungen (Bedingungsregeln), Abrufen von Werten von einem Gerät (Benutzerdefiniertes Inventarfeld) und Zuordnen von Dateinamen zu regulären Ausdrücken.

Suchen eines Pfads oder einer Datei

Bei path und fullpath handelt es sich um Zeichenfolgen, die den absoluten Pfad eines Verzeichnisses oder einer Datei auf dem Gerät angeben. Beispiel:

C:\Program Files\Mozilla Firefox\firefox.exe

Der KACE Agent ermittelt das Verzeichnis oder die Datei und führt den speziellen Test durch.

Suchen eines Registrierungsschlüssels und eines -eintrags

Bei registryPath handelt es sich um eine Zeichenfolge, die den absoluten Pfad eines Registrierungsschlüssels in der Registrierung angibt. Beispiel:

HKEY_LOCAL_MACHINE/application/kace

Angeben einer Version

Bei version handelt es sich um eine ganze Zahl (Typ: TEXT), die der KACE Agent mit der Version des Elements vergleicht, das gerade auf dem Gerät getestet wird.

Beispielsweise gibt der Test FileVersionGreaterThan 'true' zurück, wenn der angegebene Wert höher ist als die Versionsnummer der Datei oder des Ordners. Andernfalls wird 'false' zurückgegeben.

Verknüpfen Sie zum Testen eines Bereichs eine Less Than- und eine Greater Than-Regel wie folgt:

FileVersionGreaterThan(C:\Program Files\Adobe\Acrobat\7.0\Acrobat\Acrobat.exe, 6.99)

AND FileVersionLessThan(C:\Program Files\Adobe\Acrobat\7.0\

Acrobat\Acrobat.exe, 8.00)

Angeben von Umgebungs- oder Benutzervariablen

Bei var handelt es sich um eine Zeichenfolge, die dem tatsächlichen Namen der Umgebungsvariablen auf dem Gerät entspricht.

Sie können beispielsweise folgendermaßen testen, ob die Variable für das Programmverzeichnis richtig festgelegt ist:

EnvironmentVariableEquals(ProgramFiles, TEXT,

C:\Program Files)

Angeben eines Dateiattributs

Bei attribute handelt es sich um eine Systemeigenschaft, eine Datei- oder eine Ordnereigenschaft oder eine vom KACE Agenten zugewiesene Eigenschaft auf dem Gerät. Die Appliance stellt betriebssystemabhängige Argumenttypen zur Verfügung.

Verwenden von Windows Dateiattributen

Mithilfe der Funktionen FileInfoGreaterThan, FileInfoLessThan und FileInfoEquals können Sie eine Dateieigenschaft unter Windows in folgender Syntax testen:

Funktionsname (vollständiger_Pfad, Attribut, Typ, Wert)

Die folgende Tabelle enthält die von Windows unterstützten Attribute:

Attribut	Typ	Beschreibung
AccessedDate	DATE	Uhrzeit und Datum des letzten Dateizugriffs.
Kommentare	TEXT	Zu Diagnosezwecken bereitgestellte weitere Informationen.
CompanyName	TEXT	Der Name des Unternehmens, das die Datei erstellt hat.
CreatedDate	DATE	Die Uhrzeit der Dateierstellung.
FileBuildPart	NUMBER	Die dritte Position der Dateiversion. Beispiel: In Version 1.2.3, 3=Build.
FileDescription	TEXT	Dateibeschreibung auf der Seite Details der Windows Dateieigenschaften
FileMajorPart	NUMBER	Die erste Position der Dateiversion. Beispiel: In Version 1.2.3, 1=Major.
FileMinorPart	NUMBER	Die zweite Position der Dateiversion. Beispiel: In Version 1.2.3, 2=Minor.
FileName	TEXT	Der aktuelle Name der Datei. Siehe auch FileExists.
FilePrivatePart	NUMBER	Die vierte Position der Dateiversion. Beispiel: In Version 1.2.3.4, 4=Private.
FileVersion	TEXT	Die auf der Seite Details der Dateieigenschaften angezeigte vollständige Dateiversion. Siehe auch "FileVersionEquals", "FileVersionGreaterThan" und "FileVersionLessThan".
InternalName	TEXT	Sofern vorhanden, der interne Name der Datei sowie der Komponentenname. Wenn die Datei nicht über einen internen Namen verfügt, ist dies der ursprüngliche Dateiname ohne Erweiterung.
Sprache	TEXT	Der Sprachcode. Der entsprechende Name wird auf der Seite Details der Dateieigenschaften angezeigt.
LegalCopyright	TEXT	Copyright-Hinweise für die Datei.
LegalTrademarks	TEXT	Marken und eingetragene Marken, die für die Datei gelten.
ModifiedDate	DATE	Datum und Uhrzeit der letzten Änderung.
OriginalFilename	TEXT	Stellt den vollständigen Namen der Datei zur Verfügung, wenn diese auf dem Gerät abgelegt oder installiert wurde.
PrivateBuild	TEXT	Informationen zur Dateiversion.
ProductBuildPart	NUMBER	Die dritte Position der Produktversion. Beispiel: In Version 1.2.3, 3=Build.
ProductMajorPart	NUMBER	Die erste Position der Produktversion. Beispiel: In Version 1.2.3, 1=Major.
ProductMinorPart	NUMBER	Die zweite Position der Produktversion. Beispiel: In Version 1.2.3, 2=Minor.
ProductName	TEXT	Zeichenfolge, die dem Produktnamen der Windows Eigenschaft entspricht.
ProductPrivatePart	NUMBER	Die vierte Position der Produktversion. Beispiel: In Version 1.2.3.4, 4=Private.
ProductVersion	TEXT	Die vollständige Produktversion. Siehe auch ProductVersionEquals, ProductVersionGreaterThan und ProductVersionLessThan.
SpecialBuild	TEXT	Weitere Informationen zum Build.

Testen von Dateiattributen für Linux und Mac

Auf Linux und Mac Geräten können Sie Dateiattribute mithilfe der folgenden Argumente testen:

Angeben des Datentyps

type gibt den Datentyp an, der getestet oder zurückgegeben wird.

Der KACE Agent unterstützt die folgenden Typen:

•

TEXT ist eine Zeichenfolge. Nur gültig für die genaue Übereinstimmung in Bedingungsregeln wie Equals-Regeln. In ValueReturn-Regeln wird hiermit das Feld für benutzerdefinierte Inventarisierung auf eine Zeichenfolge festgelegt. Dadurch werden die Suchkriterien und die Filter auf entsprechende Operatoren beschränkt.

•

NUMBER ist eine ganze Zahl. Gültig in allen Bedingungsregeln. Ermöglicht die Angabe einer ganzen Zahl zwecks Vergleich.

•

DATE muss im Format MM/TT/JJJJ HH:MM:SS angegeben werden. Beispiel: 09/28/2006 05:03:51. Die Angabe der Zeit ist erforderlich. Beispielsweise müssen Sie bei einem Vergleich wie Größer als die Zeit mindestens als 00:00:00 angeben.

Angeben der zu testenden Werte

value folgt in der Regel auf type, ausgenommen in einer Regel, in der der Datentyp bekannt ist wie beispielsweise in einer Versionsregel. Der Wert, den Sie angeben, muss dem Typ entsprechen. Siehe Angeben des Datentyps.

Angeben des Namens eines Registrierungseintrags (nur Windows)

valueName ist eine Zeichenfolge, die dem Namen des zu testenden Registrierungseintrags entspricht. Wird nur in Registrierungstests für Windows Geräte verwendet.

Angeben eines PLIST-Schlüssels (Nur Mac)

entry ist entweder NUMBER, TEXT oder DATE und entspricht einem Schlüssel in einer PLIST-Datei auf einem Mac OS X Gerät. Befindet sich der gewünschte Schlüssel in einem Array/Wörterbuch innerhalb der PLIST-Datei, kann durch Angabe des Namens-/Ganzzahlwerts für das Array/Wörterbuch darauf verwiesen werden. Hierzu wird ein begrenzender Doppelpunkt und dann der Namens-/Ganzzahlwert des Schlüssels (Wörterbuch:Schlüssel) im Eintragsargument angegeben.

Beispiele für Argumente:

•

Auf den Schlüssel Item 0 innerhalb des Arrays PackageGroups wird mit PackageGroups:0 als Argument verwiesen.

•

Auf den Schlüssel contentType innerhalb des Wörterbuchs Item 102 wird mit 102:contentType als Argument verwiesen.

Verwenden regulärer Ausdrücke

regex ist ein regulärer Ausdruck, der einem Dateinamen in einer Bedingungs- oder Werterückgabe-Regel entspricht. Weitere Informationen finden Sie unter Zuordnen von Dateinamen zu regulären Ausdrücken.

Definieren von Befehlen

Mit den Shell-Funktionen können Sie den command-Befehl angeben, der auf dem Gerät ausgeführt werden soll. Die Richtlinien für das Erstellen von Regelargumenten beziehen sich nicht auf Befehle. Leerzeichen nach den öffnenden Klammern und unmittelbar vor den schließenden Klammern werden aus dem Befehl gelöscht.

Benutzerdefinierte Inventarregeln testen

Zum Testen von Regeln für benutzerdefinierte Inventarisierung können Sie einen Befehl für eine benutzerdefinierte Inventur auf einem von einem KACE Agent verwalteten Gerät ausführen. So können Sie Regeln für benutzerdefinierte Inventarisierung debuggen, ohne den gesamten Inventarprozess ausführen zu müssen.

Öffnen Sie eine Eingabeaufforderung auf einem Gerät, auf dem der KACE Agent installiert ist.

Geben Sie den folgenden Befehl ein: kdeploy -custominventory

Der Agent stellt eine Verbindung mit der Appliance her und führt die benutzerdefinierte Inventarisierung aus. Abfragen und zurückgegebene Werte werden angezeigt.

Attribut	Typ	Beschreibung
access_time	DATE	Der Zeitpunkt des letzten Benutzer- oder Systemzugriffs auf die Datei
block_size	NUMBER	Die Blockgröße der Datei.
Blocks	NUMBER	Die Anzahl der von der Datei verwendeten Blöcke.
creation_time	DATE	Die Uhrzeit der Dateierstellung
device_number	NUMBER	Die Identifizierungsnummer des Geräts (Datenträger), das die Datei enthält
Gruppe	TEXT	Der Gruppenname des Besitzers der Datei
inode	NUMBER	Die Inode-Nummer der Datei
modification_time	DATE	Der Zeitpunkt der letzten gespeicherten Änderung
number_links	NUMBER	Die Anzahl der Hardlinks zu der Datei
Besitzer	TEXT	Der Benutzername der Person, die Besitzer der Datei ist.
Größe	NUMBER	Die Größe der Datei

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)

Die regulären Ausdrücke

Referenz zu Regeln mit regulären Ausdrücken

Definieren von Regelargumenten

Benutzerdefinierte Inventarregeln testen