KACE Systems Management Appliance 13.2 Common Documents - KACE Service Desk Administrator Guide

Character	Description	Example Expression	Target Files	Files Matched
(any string)	Non-special characters match any filename that contains the string.	abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Myabc.txt MyFile.abc
.	Dot matches any single character. When entered alone it matches all files.	.	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc
\	Backslash is used to escape a special character and for creating a back-reference. For more information, go to http://rexegg.com/regex-capture.html.	.*\.txt$	abcFile.xls Example.jpg File.doc Myabc.txt MyFile.abc	Myabc.txt
^	Caret matches the characters you specify to the start of the filename.	^k	install.exe kinstaller.exe runkbot.bat	kinstaller.exe
\|	Pipe separates a list of options to match.	run\|install	install.exe kinstaller.exe runkbot.bat	install.exe kinstaller.exe runkbot.bat
$	Dollar matches the characters you specify to the end of the filename.	bat$	install.exe kinstaller.exe runkbot.bat	runkbot.bat
?	Question mark makes the preceding character optional in matches.	\.log10?$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 mylog.log10
*	Asterisk matches the preceding character zero or more times.	\.log1*$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 app.log appconf.log11
+	Plus matches the preceding character one or more times.	ap+.*\.log	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
[ ]	Brackets enclose a character class and match any character within the brackets. Character class special character rules differ from normal regular expressions.	[123]	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	a.log1 afile.txt3 appconf.log11 mylog.log10
()	Parentheses enclosing characters create a back reference and match the preceding characters and/or the enclosed characters. For more information, go to http://rexegg.com/regex-capture.html.	(p)\1	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log appconf.log11
{n}	Curly brackets repeat the preceding character the number of specified times, where n is greater than or equal to 1.	{p}\.log$	a.log1 afile.txt3 app.log appconf.log11 mylog.log10	app.log

Regular Expression Rule Reference

The syntax of a regular expression rule varies slightly from the other File rules. The fullpath argument is a string that matches the absolute path to the file location, but does not include name of the file. The filename is specified as a separate argument using a regular expression.

The following table provides a list of rules that allow you to use regular expressions.

Defining rule arguments

You can define arguments in Custom Inventory rules to find paths, files, registry keys, registry entries, version information, environment variables, and other attributes.

For rule syntax and usage, see the tables in Checking for conditions (conditional rules), Getting values from a device (Custom Inventory Field), and Matching filenames to regular expressions.

Finding a path or file

path and fullpath are strings that specify the absolute path to a directory or file on the device. For example:

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

The KACE Agent locates the directory or file and performs the specific test.

Finding a registry key and entry

registryPath is a string that specifies the absolute path in the registry to a registry key. For example:

HKEY_LOCAL_MACHINE/application/kace

Specifying a version

version is an integer (type is TEXT) that the KACE Agent compares to the version of the item being tested on the device.

For example, the FileVersionGreaterThan test returns ‘true’ if the value you specify is higher than the version number of the file or folder and otherwise returns ‘false’.

To test a range, join a Less Than and Greater Than rule as follows:

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)

Specifying environment or user variables

var is a string that matches the actual name of the environment variable on the device.

For example, to test that the Program Files directory variable is correctly set:

EnvironmentVariableEquals(ProgramFiles, TEXT,

C:\Program Files)

Specifying a file attribute

attribute is a system property, a file or folder property, or a KACE Agent-assigned property on the device. The appliance provides operating system-dependent argument types.

Using Windows file attributes

You can use the FileInfoGreaterThan, FileInfoLessThan, and FileInfoEquals functions to test a file property on Windows in the following syntax:

FunctionName (fullpath, attribute, type, value)

The following table shows the attributes supported by Windows:

Attribute	Type	Description
AccessedDate	DATE	Last date and time the file was accessed.
Comments	TEXT	Additional information provided for diagnostic purposes.
CompanyName	TEXT	Name of the company that produced the file.
CreatedDate	DATE	When the file was created.
FileBuildPart	NUMBER	Third position of the File Version. For example: In version 1.2.3, 3=Build.
FileDescription	TEXT	File Description of the Windows File Properties Detail page.
FileMajorPart	NUMBER	First position of the File Version. For example: In version 1.2.3, 1=Major.
FileMinorPart	NUMBER	Second position of the File Version. For example: In version 1.2.3, 2=Minor.
FileName	TEXT	Current name of the file. Also see FileExists.
FilePrivatePart	NUMBER	Fourth position of the File Version: For example: In version 1.2.3.4, 4=Private.
FileVersion	TEXT	Complete File Version shown on the file properties Detail page. Also see FileVersionEquals, FileVersionGreaterThan, and FileVersionLessThan.
InternalName	TEXT	Internal name of the file, if one exists, such as the component name. If the file has no internal name, it is equal to the original filename, without an extension.
Language	TEXT	Language code, displays corresponding name on the File Properties Detail page.
LegalCopyright	TEXT	Copyright notices that apply to the file.
LegalTrademarks	TEXT	Trademarks and registered trademarks that apply to the file.
ModifiedDate	DATE	Last day and time the file was modified.
OriginalFilename	TEXT	Provides the full name of the file when it was put or installed on the device.
PrivateBuild	TEXT	Information about the version of the file.
ProductBuildPart	NUMBER	Third position of the Product Version. For example: In version 1.2.3, 3=Build.
ProductMajorPart	NUMBER	First position of the Product Version. For example: In version 1.2.3, 1=Major.
ProductMinorPart	NUMBER	Second position of the Product Version. For example: In version 1.2.3, 2=Minor.
ProductName	TEXT	String that matches the Product Name of the Windows property.
ProductPrivatePart	NUMBER	Fourth position of the Product Version. For example: In version 1.2.3.4, 4=Private.
ProductVersion	TEXT	The full production version. Also see ProductVersionEquals, ProductVersionGreaterThan, and ProductVersionLessThan.
SpecialBuild	TEXT	Additional information about the build.

Testing for Linux and Mac file attributes

On Linux and Mac devices you can use the following arguments to test file attributes:

Specifying the datatype

type identifies the type of data you are testing or returning.

The KACE Agent supports the following types:

•

TEXT is a string. Only valid for exactly matching in conditional rules such as Equals. In ValueReturn rules, this sets the Custom Inventory Field type to string and therefore limits search criteria and filtering to matching operators.

•

NUMBER is an integer. Valid in all conditional rules, this allows you to specify a whole number for comparison.

•

DATE must be in the format of MM/dd/yyyy HH:mm:ss. For example:09/28/2006 05:03:51. Time is required. For example, in a comparison such as greater than, you must at least specify the time as 00:00:00.

Specifying values to test

value typically follows type except in a rule where the datatype is known, such as in a version rule. The value you specify must match the type. See Specifying the datatype.

Specifying the name of a registry entry (Windows only)

valueName is a string that matches the name of the registry entry you want to test. Used only in registry tests for Windows devices.

Specifying a PLIST key (Mac only)

entry is either NUMBER, TEXT, or DATE and matches a key in a PLIST file on a Mac OS X device. If the wanted key is contained in an array/dictionary within the PLIST file, it can be referenced by specifying the name/integer for the array/dictionary, using a delineating colon, and then the name/integer of the key (dictionary:key) in the entry argument.

Argument examples:

•

A key, Item 0, within an array, PackageGroups, is referenced by using PackageGroups:0 for the argument

•

A key, contentType, within the dictionary, Item 102, is referenced by using 102:contentType for the argument.

Using a regular expression

regex is a regular expressions that matches a filename in a Conditional or Value Return rule. See Matching filenames to regular expressions for more details.

Defining commands

The shell command functions allow you to specify the command you want to run on the device. The guidelines for writing rule arguments do not apply to commands. However, white space after the opening parenthesis, and immediately before the closing parenthesis, is stripped from the command.

Test Custom Inventory rules

To test Custom Inventory rules you can run a custom inventory command on a KACE Agent-managed device. This ability enables you to debug Custom Inventory rules without running the entire inventory process.

Open a command prompt on a device that has the KACE Agent installed.

Enter the following command: kdeploy -custominventory

The Agent contacts the appliance and runs the Custom Inventory. Queries and return values are displayed.

Syntax	Win	RHEL	OS X	Description
FilenamesMatchingRegexExist (fullpath,regex)	X	X	X	Returns true if any files in the specified directory match the filename you entered using a regular expression.
FilenamesMatchingRegexGreaterThan (fullpath,regex,value)	X	X	X	True if the number of files that match is more than the value.
FilenamesMatchingRegexLessThan (fullpath,regex,value)	X	X	X	True if the number of files that match is less than the value.
FilenamesMatchingRegexEqual (fullpath,regex,value)	X	X	X	True if the number of files that match is the same as the value.
FilenamesMatchingRegexReturn (fullpath,regex,type)	X	X	X	Sets the Custom Inventory Field to the matching filenames (includes path).

Attribute	Type	Description
access_time	DATE	The last time the user or system accessed the file
block_size	NUMBER	The block size of the file
blocks	NUMBER	The number of blocks used by the file
creation_time	DATE	The time the file was created
device_number	NUMBER	The identification number of the device (disk) containing the file
group	TEXT	The group name of the file owner
inode	NUMBER	The inode number of the file
modification_time	DATE	The last time a change was made and saved
number_links	NUMBER	The number of hard links to the file
owner	TEXT	The username of the person who owns the file
size	NUMBER	The size of the file

제품을 선택하십시오.

더 나은 서비스 제공을 위해 채팅 목적을 작성해 주십시오.

문제에 대한 권장 솔루션

KACE Systems Management Appliance 13.2 Common Documents - KACE Service Desk Administrator Guide

Understanding regular expressions

Regular Expression Rule Reference

Defining rule arguments

Test Custom Inventory rules