Category Filter

How to pass device and user information using the wildcards supported by Hexnode?

Hexnode supports wildcards containing information about each device and user to which you are assigning the management policies. You can use these variables for the commonly used device and user fields instead of entering them manually. This lets you create policies that can be pushed to a bulk of devices. When the policy/action is sent to a device/user, these variables will be automatically populated with the corresponding data retrieved from the details that have been provided during device enrollment.

Wildcards supported by Hexnode

The below table lists the wild cards supported by Hexnode:

Wildcard Substitution
%devicename% Name of the device as shown in the portal.
%model% Name of the device’s model or product.
%serialnumber% The serial number of the device.
%imei% The International Mobile Equipment Identity assigned to the device. This number uniquely identifies the mobile device.
%osname% Name of the operating system running on the device.
%osversion% The version number of the device’s OS.
%deviceid% A number assigned to each device in the order in which they had been enrolled.
%iccid% The ICCID from the device’s SIM card, if present.
%udid% The unique identifier assigned to the device by the manufacturer.
%phonenumber% The phone number associated with the mobile device.
%wifimacaddress% The Media Access Control address that uniquely identifies the network interface on the device.
%name% Name of the device user as displayed in the portal.
%email% The email address associated with a particular user.
%username% Name of the user or the email address associated with the user.
%domain% AD (Azure AD) domain name associated with the user.
%netbiosname% NetBIOS name of the Active Directory domain.
%ssid% Service Set Identifier (SSID) or simply the name for a Wi-Fi network.
%assettag% Asset tag information (provided by admin as a custom attribute in the device summary page) to identify the device.
%department% Department name as provided by the admin in the device summary page.
%devicenotes% Device notes provided by the admin in the device summary page.
%userPrincipalName% Provide to use the enrollment information to populate the user principal name (UPN) .
%alternateemail% An email other that the users email ID.
%newline% Use this wildcard to insert a line break.
%null% Use this wildcard to return no value.
Hexnode supports the use of logical OR operator in the fields that permit using two or more wildcards. You can enter wildcard combinations, each item separated by the keyword ‘OR’. This auto-populates the field with the first available wildcard data from among the combination. For example: Entering %email%OR%alternateemail% in the Username field of the iOS CalDAV configuration fetches the user’s email from the enrollment information. If email is unavailable, it checks for the user’s alternate email and replaces the whole wildcard combination with it.

Where are these wildcards used?

Broadcast Message

The following wildcards can be included in the messages broadcasted to iOS and Android devices.
  • %devicename%
  • %email%
  • %imei%
  • %deviceid%
  • %serialnumber%
  • %domain%
  • %name%
  • %udid%
  • %model%
  • %phonenumber%
  • %iccid%
  • %wifimacaddress%

Network Configurations

Wildcards like %username%, %email%, %domain%, %netbiosName%, %userPrincipalName%,%phonenumber%, %name% are used to fill in certain configuration fields in the Wi-Fi, Email, Exchange ActiveSync, VPN Policies for iOS, Android and macOS devices.

iOS Google Accounts

%email% can be used to fill in the email address field in iOS Google Accounts policy.

Account Configurations

  • CalDAV, CardDAV and LDAP policies for macOS and iOS and Calendar policy for iOS support %email% and %alternateemail% to fill in the User Name.

    iOS Lockscreen Message

    Asset Tag Information for iOS lock screen message supports the following wildcards:
    • %devicename%
    • %imei%
    • %serialnumber%
    • %name%
    • %email%
    • %deviceid%
    • %domain%
    • %netbiosname%
    • %udid%
    • %model%
    • %phonenumber%
    • %iccid%
    • %wifimacaddress%
    • %username%
    • %assettag%
    • %department%
    • %devicenotes%

    Web Apps

    While adding web apps to be opened with Hexnode Browser Lite to the app inventory, the following device information can be passed:

    • %deviceid%
    • %serialnumber%
    • %devicename%
    • %imei%
    • %wifimacaddress%
    • %name%
    • %email%
    • %domain%
    • %netbiosname%
    • %udid%
    • %model%
    • %phonenumber%
    • %iccid%
    • %department%
    • %assettag%
    • %devicenotes%

    App Configurations

    Android App Configurations policy supports the use of the following wildcards:

    • %newline%
    • %username%
    • %email%
    • %phonenumber%
    • %udid%
    • %deviceid%
    iOS App Configuration using XML supports the use of the following wildcards:
    • %username%
    • %domain%
    • %netbiosName%
    • %email%
    • %udid%
    • %iccid%
    • %imei%
    • %model%
    • %phoneNumber%
    • %wifiMacAddress%
    • %deviceID%
    • %devicename%
    • %serialNumber%
    • %name%
    • %assettag%
    • %department%
    • %devicenotes%
    • %alternateemail%

    Execute Custom Script on Mac and Windows

    Arguments used for executing scripts on Mac and Windows devices support the following wildcards:
    • %devicename%
    • %model%
    • %serialnumber%
    • %imei%
    • %osname%
    • %osversion%
    • %deviceid%
    • %iccid%
    • %udid%
    • %phonenumber%
    • %wifimacaddress%
    • %name%
    • %email%
    • %username%
    • %domain%
    • %netbiosname%
    • %ssid%
    • %assettag%
    • %department%
    • %devicenotes%
    • %userPrincipalName%
    • %alternateemail%
    • %newline%
    • %null% (Supported only with macOS scripts)

    Create User Account for macOS

    The Create User Account action supports the use of the wildcards in the fields: Full Name, Account Name, Password, Password Hint, and Aliases. Each field supports the following wildcards:
    • %devicename%
    • %model%
    • %serialnumber%
    • %imei%
    • %osname%
    • %osversion%
    • %deviceid%
    • %iccid%
    • %udid%
    • %phonenumber%
    • %wifimacaddress%
    • %name%
    • %email%
    • %username%
    • %domain%
    • %netbiosname%
    • %ssid%
    • %assettag%
    • %department%
    • %devicenotes%
    • %userPrincipalName%
    • %alternateemail%
    • %newline%
    Notes:

    • You cannot include multiple OR operators in the fields that support the use of different wildcards. %wildcard%OR%wildcard%OR%wildcard%OR%wildcard%%wildcard%OR%wildcard%
    • When you use the ‘OR’ operator to append a set of wildcards in Broadcast Messages, Remote ring, or iOS Lock Screen Message, separate the OR combination from other wildcards in the list using space. For example: %name%OR%email%%deviceid%%department%%name%OR%email% %deviceid%%department%