¶ Использование переменных в Ринго
Переменные в Ринго позволяют создавать универсальные конфигурационные профили и скрипты, которые автоматически подставляют индивидуальные значения для каждого устройства. Вместо создания отдельного профиля для каждого устройства вы можете использовать один профиль с переменными, которые будут заменены на актуальные данные устройства или пользователя при развёртывании.
¶ Поддерживаемые переменные
¶ Переменные Ринго
Ринго подставляет переменные в формате $VARIABLE непосредственно при развёртывании профиля или выполнении скрипта. Эти переменные работают на всех устройствах (macOS, iOS, iPadOS) и могут использоваться как в профилях, так и в скриптах.
| Переменная | Описание |
|---|---|
$USERNAME |
Имя пользователя, привязанного к устройству |
$FULLNAME |
Полное имя сотрудника, привязанного к устройству |
$EMAIL |
E-mail сотрудника, привязанного к устройству |
$MANAGEMENTID |
Системный ID устройства в Ринго |
$COMPUTERNAME |
Имя устройства |
$UDID |
UDID номер устройства |
$SERIALNUMBER |
Серийный номер устройства |
$MACADDRESS |
MAC-адрес устройства |
$PHONE |
Телефон сотрудника, привязанного к устройству |
$POSITION |
Должность сотрудника, привязанного к устройству |
$EXTENSIONATTRIBUTE_# |
Дополнительный атрибут, где # заменяется на значение из поля «Строка названия переменной» |
Вы также можете использовать собственные переменные в Ринго, созданные через дополнительные атрибуты). Их значения могут быть гибко настроены под ваши задачи.
Важно! Переменные Ринго чувствительны к регистру и должны указываться только в верхнем регистре.
¶ Переменные Apple для macOS
Apple macOS поддерживает собственные переменные в формате %Variable%, которые обрабатываются непосредственно операционной системой. Важно: эти переменные работают только на macOS и только в профилях конфигурации (не в скриптах). На iOS и iPadOS переменные Apple не поддерживаются.
Использование переменных Apple ограничено специфическими сценариями:
- Настройка сертификатов (ACME, SCEP)
- Создание локальных учётных записей
- Настройка VPN-подключений
| Переменная | Описание |
|---|---|
%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)». -->
Если для устройства значение переменной не сохранено в Ринго, вместо $VARIABLE будет подставлена пустая строка.
¶ Использование переменных Ринго в параметрах скрипта
¶ Подготовка скрипта
Ринго поддерживает использование до 8 параметров скрипта: от $4 до $11. Параметры $1-$3 зарезервированы системой.
Важно! В bash номера параметров больше 9 заключаются в фигурные скобки:
${10},${11}. Переменные Apple (%Variable%) не работают в скриптах — используйте только переменные Ринго.
В нужных местах скрипта укажите номер параметра, который будете использовать при создании политики. Если итоговое значение параметра может содержать пробелы или спецсимволы, заключите номер параметра в кавычки:
¶ Настройка параметров в политике
После добавления скрипта в политику укажите значения для параметров, используемых в скрипте. Значение каждого параметра может включать одну или несколько переменных Ринго в сочетании с обычным текстом.
Примеры заполнения параметров:
- Параметр
$4:$USERNAME - Параметр
$5:$EMAIL - Параметр
$6:Устройство: $COMPUTERNAME (S/N: $SERIALNUMBER)
¶ Результат выполнения
При выполнении политики на устройстве все переменные $VARIABLE, указанные в параметрах, автоматически заменяются на сохранённые в Ринго значения для конкретного устройства:
Если для устройства значение переменной не сохранено в Ринго, вместо $VARIABLE будет подставлена пустая строка:
