Use payload variables with Profile Manager
Enter variables in payload fields to create profiles that can be used across a variety of situations and devices. The variables are dynamically resolved by Profile Manager when the configuration profile is sent to managed devices or assigned to a user.
The substitution variables you can specify are described below. You can combine the variables with static text, such as “%shortname%@example.com”.
Note: The following payload variables can be used with Profile Manager. Consult your MDM solution’s documentation to learn which variables they support.
User information variables
User information variables are resolved using information from the user’s 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 globally unique identifier (GUID)—for example, 237 |
Device information variables
Device information variables are resolved using information from the device record.
Variable | Substitution |
|---|---|
%DeviceName% %device_name% | The name of the device |
%OSVersion% | The common version number of the device’s operating system, such as “10.15.6” |
%SerialNumber% | The device’s serial number |
%ProductName% | The device’s product name, such as “MacBook Pro” |
%UDID% | The device’s Unique Device Identifier (UDID) |
%BluetoothMAC% | The MAC address of the device’s Bluetooth interface |
%WiFiMAC% | The MAC address of the device’s Wi-Fi interface |
%IMEI% (iOS devices only) | The device’s International Mobile Equipment Identity (IMEI), if present |
%MEID% (iOS devices only) | The device’s Mobile Equipment Identifier (MEID), if present |
%EthernetMAC% (Mac only) | The MAC address of the device’s Ethernet interface, if present |
%DeviceID% (Apple TV only) | The device ID of the Apple TV |
802.1X network variables
On Mac computers, you can use the following network 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 |