Product Documentation

Filter conditions

May 22, 2017

Workspace Environment Management includes the following filter conditions which you use to configure the circumstances under which the agent assigns resources to users. (For details of using these conditions in the administration console, see filter conditions.)

Condition Name

Always True

Expected value type

N/A

Expected result type

N/A

Expected syntax

N/A

Returns

true

 

Condition Name

ComputerName Match

Expected value type

N/A

Expected result type

String

Expected syntax

Single name test : Computername

Multiple tests (OR) : Computername1;Computername2

Wildcard (also works with multiples) : ComputerName*

Returns

True if the current computer name matches the tested value false otherwise

 

Condition Name

ClientName Match

Expected value type

N/A

Expected value type

String

Expected syntax

Single name test : Clientname

Multiple tests (OR) : Clientname1;Clientname2

Wildcard (also works with multiples) : ClientName*

Returns

True if the current client name matches the tested value false otherwise

 

Condition Name

IP Address Match

Expected value type

N/A

Expected result type

IP address

Expected syntax

Single name test : IpAddress

Multiple tests (OR) : IpAddress1;IpAddress2

Wildcard (also works with multiples) : IpAddress*

Range (also works with multiples) :  IpAddress1-IpAddress2

Returns

True if the current computer ip address matches the tested value false otherwise

 

Condition Name

Client IP Address Match

Expected value type

N/A

Expected result type

IP address

Expected syntax

Single name test : ClientIpAddress

Multiple tests (OR) : ClientIpAddress1;ClientIpAddress2

Wildcard (also works with multiples) : ClientIpAddress*

Range (also works with multiples) :  IpAddress1-IpAddress2

Returns

True if the current client ip address matches the tested value false otherwise

 

Condition Name

Active Directory Site Match

Expected value type

N/A

Expected result type

Exact name of the Active Directory site to test

Expected syntax

Active directory site name

Returns

True if the specified site matches the current site false otherwise

 

Condition Name

Scheduling

Expected value type

N/A

Expected result type

Day of week (example: Monday)

Expected syntax

Single name test : DayOfWeek

Multiple tests (OR) : DayOfWeek1; DayOfWeek2

Returns

True if today matches the tested value false otherwise

 

Condition Name

Environment Variable Match

Expected value type

String. Name of the tested variable

Expected result type

String. Expected value of the tested variable

Expected syntax

Single name test : value

Not null test: ?

Returns

True if environment variable exists and value matches false otherwise.

 

Condition Name

Registry Value Match

Expected value type

String. Full path and name of the registry value to test. Example : Registry Key HKCU\Software\Citrix\TestValueName

Expected result type

String. Expected value of the tested registry entry

Expected syntax

Single name test : value

Not null test: ?

Returns

True if registry value exists and value matches false otherwise.

 

Condition Name

WMI Query result Match

Expected value type

N/A

Expected result type

String.

Expected syntax

Valid WMI query. https://msdn.microsoft.com/en-us/library/aa392902(v=vs.85).aspx

Returns

True if query is successful and has result false otherwise.

 

Condition Name

User Country Match

Expected value type

N/A

Expected result type

String.

Expected syntax

Two letter ISO language name.

Returns

True if user ISO language name matches the specified value false otherwise.

 

Condition Name

User UI Language Match

Expected value type

N/A

Expected result type

String.  Two letter ISO language name. Example FR

Expected syntax

Two letter ISO language name. Example FR

Returns

True if user UI ISO language name matches the specified value false otherwise.

 

Condition Name

User SBC Resource Type

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if user context (published desktop or application) matches selected value false otherwise.

 

Condition Name

OS Platform Type

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if machine platform type (x64 or x86) matches selected value false otherwise.

 

Condition Name

Connection State

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if connection state (online or offline) matches selected value false otherwise.

 

Condition Name

XenApp Version Match

Expected value type

N/A

Expected result type

String. XenApp Version. Example: 6.5

Expected syntax

N/A

Returns

True if version matches selected value false otherwise.

 

Condition Name

XenApp Farm Name Match

Expected value type

N/A

Expected result type

String. XenApp Farm Name (up to version 6.5). Example: Farm

Expected syntax

N/A

Returns

True if name matches selected value false otherwise.

 

Condition Name

XenApp Zone Name Match

Expected value type

N/A

Expected result type

String. XenApp Zone Name (up to version 6.5). Example: Zone

Expected syntax

N/A

Returns

True if name matches selected value false otherwise.

 

Condition Name

XenDesktop Farm Name Match

Expected value type

N/A

Expected result type

String. XenDesktop Farm Name (up to version 5). Example: Farm

Expected syntax

N/A

Returns

True if name matches selected value false otherwise.

 

Condition Name

XenDesktop Desktop Group Name Match

Expected value type

N/A

Expected result type

String. XenDesktop Desktop Group Example: Group

Expected syntax

N/A

Returns

True if name matches selected value false otherwise.

 

Condition Name

Provisioning Services Image Mode

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if current provisioning services image mode matches selected value false otherwise.

 

Condition Name

Client OS

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if current client operating system matches selected value false otherwise.

 

Condition Name

Active Directory Path Match

Expected value type

N/A

Expected result type

String. Name of the tested Active Directory Path

Expected syntax

Single name test : strict LDAP path matching

Wilcard test: OU=Users*

Multiple entries: separate entries with semicolon (;)

Returns

True if attribute exists and value matches false otherwise.

 

Condition Name

Active Directory Attribute Match

Expected value type

String. Name of the tested Active Directory attribute

Expected result type

String. Expected value of the tested Active Directory attribute

Expected syntax

Single value test : value

Multiple value entries: separate entries with semicolon (;)

Test for not null: ?

Returns

True if attribute exists and value matches false otherwise.

 

Condition Name

Name or Value is in List

Expected value type

String. Full file path of the xml list generated by the Integrity List manager utility

Expected result type

String. Expected value of the name/value to look for in the list

Expected syntax

String

Returns

True if the value is found in the name/value pairs in the specified list false otherwise.

 

Condition Name

No ComputerName Match

Negative condition behavior

Will execute ComputerName Match and return the opposite result (true if false, false if true).

 

See condition ComputerName Match for more information.

 

Condition Name

No ClientName Match

Negative condition behavior

Will execute ClientName Match and return the opposite result (true if false, false if true).

 

See condition ClientName Match for more information.

 

Condition Name

No IP Address Match

Negative condition behavior

Will execute IP Address Match and return the opposite result (true if false, false if true).

 

See condition IP Address Match for more information.

 

Condition Name

No Client IP Address Match

Negative condition behavior

Will execute Client IP Address Match and return the opposite result (true if false, false if true).

 

See condition Client IP Address Match for more information.

 

Condition Name

No Active Directory Site Match

Negative condition behavior

Will execute Active Directory Site Match and return the opposite result (true if false, false if true).

 

See condition Active Directory Site Match for more information.

 

Condition Name

No Environment Variable Match

Negative condition behavior

Will execute Environment Variable Match and return the opposite result (true if false, false if true).

 

See condition Environment Variable Match for more information.

 

Condition Name

No Registry Value Match

Negative condition behavior

Will execute Registry Value Match and return the opposite result (true if false, false if true).

 

See condition Registry Value Match for more information.

 

Condition Name

No WMI Query result Match

Negative condition behavior

Will execute WMI Query result Match and return the opposite result (true if false, false if true).

 

See condition WMI Query result Match for more information.

 

Condition Name

No User Country Match

Negative condition behavior

Will execute User Country Match and return the opposite result (true if false, false if true).

 

See condition User Country Match for more information.

 

Condition Name

No User UI Language Match

Negative condition behavior

Will execute User UI Language Match and return the opposite result (true if false, false if true).

 

See condition User UI Language Match for more information.

 

Condition Name

No XenApp Version Match

Negative condition behavior

Will execute XenApp Version Match and return the opposite result (true if false, false if true).

 

See condition XenApp Version Match for more information.

 

Condition Name

No XenApp Farm Name Match

Negative condition behavior

Will execute XenApp Farm Name Match and return the opposite result (true if false, false if true).

 

See condition XenApp Farm Name Match for more information.

 

Condition Name

No XenApp Zone Name Match

Negative condition behavior

Will execute XenApp Zone Name Match and return the opposite result (true if false, false if true).

 

See condition XenApp Zone Name Match for more information.

 

Condition Name

No XenDesktop Farm Name Match

Negative condition behavior

Will execute XenDesktop Farm Name Match and return the opposite result (true if false, false if true).

 

See condition XenDesktop Farm Name Match for more information.

 

Condition Name

No XenDesktop Desktop Group Name Match

Negative condition behavior

Will execute XenDesktop Desktop Group Name Match and return the opposite result (true if false, false if true).

 

See condition XenDesktop Desktop Group Name Match for more information.

 

Condition Name

No Active Directory Path Match

Negative condition behavior

Will execute Active Directory Path Match and return the opposite result (true if false, false if true).

 

See condition Active Directory Path Match for more information.

 

Condition Name

No Active Directory Attribute Match

Negative condition behavior

Will execute Active Attribute Path Match and return the opposite result (true if false, false if true).

 

See condition Active Attribute Path Match for more information.

 

Condition Name

Name or Value is not in List

Negative condition behavior

Will execute Name or Value is in List and return the opposite result (true if false, false if true).

 

See condition Name or Value is in List for more information.

 

Condition Name

Client Remote OS Match

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if current remote client operating system matches selected value false otherwise.

 

Condition Name

No Client Remote OS Match

Negative condition behavior

Will execute Client Remote OS Match and return the opposite result (true if false, false if true).

 

See condition Client Remote OS Match for more information.

 

Condition Name

Dynamic Value Match

Expected value type

String. Any dynamic expression using environment variables or Dynamic Tokens

Expected result type

String. Expected value of the tested expression

Expected syntax

Single name test : value

Not null test: ?

Returns

True if dynamic expression result value exists and value matches false otherwise.

 

Condition Name

No Dynamic Value Match

Negative condition behavior

Will execute Dynamic Value Match and return the opposite result (true if false, false if true).

 

See condition Dynamic Value Match for more information.

 

Condition Name

Transformer Mode State

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if current Transformer state matches selected value false otherwise.

 

Condition Name

No Client OS Match

Negative condition behavior

Will execute Client OS Match and return the opposite result (true if false, false if true).

 

See condition Client OS Match for more information.

 

Condition Name

Active Directory Group Match

Expected value type

N/A

Expected result type

String

Expected syntax

Single name test : group netbios name (DOMAIN\Groupname)

Multiple tests (OR) : Groupname1;Groupname2

Returns

True if any of the current user groups matches the tested value false otherwise

 

Condition Name

No Active Directory Group Match

Negative condition behavior

Will execute Active Directory Group Match and return the opposite result (true if false, false if true).

 

See condition Active Directory Group Match for more information.

 

Condition Name

File Version Match

Expected value type

String. Full path and name of the file to test.
Example : C:\Test\TestFile.dll

Expected result type

String. Expected file version value of the tested file

Expected syntax

Single name test : value

Not null test: ?

Returns

True if registry value exists and value matches false otherwise.

 

Condition Name

No File Version Match

Negative condition behavior

Will execute File Version Match and return the opposite result (true if false, false if true).

 

See condition File Version Match for more information.

 

Condition Name

Network Connection State

Expected value type

N/A

Expected result type

Select from dropbox

Expected syntax

N/A

Returns

True if current network connection state matches selected value false otherwise.

 

Condition Name

Published Resource Name

Expected value type

N/A

Expected result type

String. Name of the published resource (XenApp/XenDesktop/RDS)

Expected syntax

Single name test : published resource name

Multiple tests (OR) : Name1;Name2

Wildcard test: Name*

 

Returns

True if the current published resource name matches the tested value false otherwise

 

Condition Name

Name is in List

Expected value type

String. Full file path of the xml list generated by the Integrity List manager utility

Expected result type

String. Expected value of the name to look for in the list

Expected syntax

String

Returns

True if there is a name match in the name/value pairs in the specified list false otherwise.

 

Condition Name

Name is not in List

Negative condition behavior

Will execute Name is in List and return the opposite result (true if false, false if true).

 

See condition Name is in List for more information.

 

Condition Name

File/Folder exists

Expected value type

N/A

Expected result type

String.

Expected syntax

Full path of the file system entry (file or folder) to test

Returns

True if the specified file system entry exists false otherwise

 

Condition Name

File/Folder does not exist

Negative condition behavior

Will execute File/Folder exists and return the opposite result (true if false, false if true).

 

See condition File/Folder exists for more information.

 

Condition Name

DateTime Match

Expected value type

N/A

Expected result type

DateTime as String. Date/time to test

Expected syntax

Single Date: 06/01/2016

Date Range: 06/01/2016-08/01/2016

Multiple entries: entry1;entry2 Ranges and single dates can be mixed

Returns

True if execution datetime matches any of the specified entry false otherwise.

 

Condition Name

No DateTime Match

Negative condition behavior

Will execute DateTime Match and return the opposite result (true if false, false if true).

 

See condition DateTime Match for more information.