Переменные в Ринго позволяют создавать универсальные профили конфигурации, которые автоматически подставляют индивидуальные значения для каждого устройства. Вместо создания отдельного профиля для каждого устройства вы можете использовать один профиль с переменными, которые будут заменены на актуальные данные устройства или пользователя при развёртывании.
Ринго подставляет переменные в формате $VARIABLE непосредственно при развёртывании профиля. Эти переменные работают на всех устройствах (macOS, iOS, iPadOS).
| Переменная | Описание |
|---|---|
$USERNAME |
Имя пользователя, привязанного к устройству |
$FULLNAME |
Полное имя сотрудника, привязанного к устройству |
$EMAIL |
E-mail сотрудника, привязанного к устройству |
$MANAGEMENTID |
Системный ID устройства в Ринго |
$COMPUTERNAME |
Имя устройства |
$UDID |
UDID номер устройства |
$SERIALNUMBER |
Серийный номер устройства |
$MACADDRESS |
MAC-адрес устройства |
$PHONE |
Телефон сотрудника, привязанного к устройству |
$POSITION |
Должность сотрудника, привязанного к устройству |
$EXTENSIONATTRIBUTE_# |
Дополнительный атрибут, где # заменяется на значение из поля «Строка названия переменной» |
Важно! Переменные Ринго чувствительны к регистру и должны указываться только в верхнем регистре.
Apple macOS поддерживает собственные переменные в формате %Variable%, которые обрабатываются непосредственно операционной системой. Эти переменные работают только на macOS и только в профилях конфигурации. На iOS и iPadOS переменные Apple не поддерживаются.
Использование переменных Apple ограничено специфическими сценариями:
| Переменная | Описание |
|---|---|
%ComputerName% |
Имя Mac-компьютера из настроек «Общий доступ» |
%HardwareUUID% |
Уникальный идентификатор Mac-компьютера |
%HostName% |
DNS-имя Mac-компьютера (например, mac1.company.com) |
%LocalHostName% |
Локальное сетевое имя Mac-компьютера (например, Mac1.local) |
%MACAddress% |
MAC-адрес Ethernet-интерфейса (en0) |
%SerialNumber% |
Серийный номер Mac-компьютера |
%AD_ComputerID% |
ID компьютера в Active Directory |
%AD_Domain% |
Домен Active Directory |
%AD_DomainForestName% |
Имя леса Active Directory |
%AD_DomainGuid% |
GUID домена Active Directory |
%AD_DomainNameDNS% |
DNS-имя домена Active Directory |
%AD_KerberosID% |
Kerberos ID в Active Directory |
Ограничения переменных Apple: работают только на macOS, только в профилях конфигурации, и ограничены специфическими payload-типами (сертификаты, VPN, учётные записи).
Для использования переменной Ринго в профиле конфигурации введите её в формате $VARIABLE в любое текстовое поле. Переменные можно комбинировать друг с другом и с обычным текстом.
Пример использования переменной в XML-профиле:
<key>Label</key>
<string>Hello $USERNAME</string>
При развёртывании профиля на устройство переменная $USERNAME будет автоматически заменена на имя пользователя, привязанного к этому устройству.
Переменные можно комбинировать друг с другом и со статическим текстом для создания составных значений:
Пример комбинирования переменных Ринго:
<key>DisplayName</key>
<string>$FULLNAME - $POSITION ($EMAIL)</string>
<!-- Этот пример создаст строку вида: «Иван Петров - Системный администратор (ivan.petrov@company.com)». -->
Пример использования переменной Apple совместно с переменной Ринго (только на macOS):
<key>AccountDisplayName</key>
<string>%ComputerName% - $USERNAME</string>
Если для устройства значение переменной не сохранено в Ринго, вместо $VARIABLE будет подставлена пустая строка.