Payload variables

In any payload field, you can use variables to create information that’s dynamically resolved by Profile Manager when the configuration profile is sent to managed devices or assigned to a user. This lets you create profiles that can be used across a variety of situations and devices.

The substitution variables you can specify are described below. You can combine the variables with static text, such as “%shortname%@example.com”.

User information variables

These variables are resolved using information from the user’s directory (Open Directory) record.

Variable

Substitution

%full_name%

The user’s full name—for example, Karl Bohn

%first_name%

The user’s first name—for example, Karl

%last_name%

The user’s last name—for example, Bohn

%email%

The user’s email address

%job_title%

The user’s job title

%mobile_phone%

The user’s mobile telephone number

%short_name%

The user’s short name—for example, kbohn

%guid%

The user’s guid—for example, 237

Device information variables

These variables are resolved using information from the device record in Profile Manager.

Variable

Substitution

%ICCID%

The ICCID from the device’s SIM card, if present

%OSVersion%

The common version number of the device’s OS, such as “10.9”

%SerialNumber%

The device’s serial number

%ProductName%

The device’s product name, such as “MacBook”

%BuildVersion%

An alphanumeric representation of the OS version installed on the device, such as “11J66”

%IMEI%

The device’s International Mobile Equipment Identity (IMEI), if present

%WiFiMAC%

The MAC address of the device’s Wi-Fi interface

802.1X network variables

On Mac computers, you can use the following variables in the 802.1X user name fields. These variables are resolved on the device during installation of the configuration profile. You can combine these variables with static text, such as Mac.%HardwareUUID%, to create a compound user name.

Variable

Substitution

%AD_ComputerID%

Active Directory computer ID

%AD_Domain%

Active Directory domain

%AD_DomainForestName%

Active Directory forest name

%AD_DomainGuid%

Active Directory GUID

%AD_DomainNameDNS%

Active Directory DNS Name

%AD_KerberosID%

Active Directory Kerberos ID

%ComputerName%

The computer’s name, as set in System Preferences > Sharing

%HardwareUUID%

The computer’s unique identifier

%HostName%

The computer’s DNS name, such as mac1.example.com

%LocalHostName%

The computer’s local network name, such as Mac1.local

%MACAddress%

The computer’s default (en0) MAC address

%SerialNumber%

The computer’s serial number