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 |