Справочник команд CLI
Общие сведения
Справочник содержит команды интерфейса командной строки CLI сервера IVA Mail, сгруппированные по объектам и задачам.
Правила записи команд (кавычки, необязательные параметры, альтернативы, массивы и объекты JSON) описаны в разделе Правила записи команд.
Общие параметры
Параметры из таблицы встречаются во многих командах и в описаниях команд отдельно не поясняются.
| Параметр | Описание |
|---|---|
|
Домен: имя в кавычках или числовой UID. |
|
Аккаунт: имя в кавычках или числовой UID. |
|
Объект домена (аккаунт, ресурсный аккаунт, группа, переадресатор, список рассылки): имя в кавычках или числовой UID. |
|
Настройка: ключ или путь к вложенной настройке в виде массива ключей. Путь можно также записать строкой через точку: |
|
Значение настройки — любой объект JSON. |
|
Команда действует на уровне сервера или кластера (если это допускает команда). |
|
Массив ключей настроек, которые нужно удалить. Вместо них будут действовать значения по умолчанию. |
|
Массив вида |
|
Настройки создаваемого объекта: словарь или массив с чередующимися названиями настроек и их значениями. |
Общие команды
Quit
- Назначение
-
Завершает CLI-сессию и закрывает соединение.
- Синтаксис
Quit
Shutdown
- Назначение
-
Останавливает сервер.
- Синтаксис
Shutdown
Inline
- Назначение
-
Переключает режим вывода объектов в результатах команд между компактным и многострочным.
- Синтаксис
Inline
Ext
- Назначение
-
Переключает режим вывода объектов в результатах команд между стандартным и расширенным.
- Синтаксис
Ext
NoTimeout
- Назначение
-
Устанавливает тайм-аут чтения в соединении в 365 дней.
- Синтаксис
NoTimeout
NoEscape
- Назначение
-
Переключает флаг экранирования служебных символов в выводе последующих команд.
- Синтаксис
NoEscape
Help
- Назначение
-
Выводит список команд с возможностью фильтрации.
- Синтаксис
Help ("search")
| Параметр | Описание |
|---|---|
|
Параметр фильтрации при поиске команд (при необходимости). |
Ping
- Назначение
-
Отвечает фиксированным сообщением.
- Синтаксис
Ping
RaiseMem
- Назначение
-
Вызывает аварийное завершение процесса с генерацией системного сигнала
SIGSEGV.
Используется для проверки создания отладочных образов памяти выполняемой программы core dump.
- Синтаксис
RaiseMem
SchemaDump
- Назначение
-
Выдаёт описание схемы настроек.
- Синтаксис
SchemaDump "type" (false)
| Параметр | Описание |
|---|---|
|
Имя схемы настроек. Если указана пустая строка, возвращается список известных схем. |
|
При задании этого параметра описания объектов в схеме не содержат прав доступа |
ModulesList
- Назначение
-
Выдаёт список инициализированных модулей.
- Синтаксис
ModulesList
MailModulesList
- Назначение
-
Выдаёт список инициализированных почтовых модулей.
- Синтаксис
MailModulesList
MailQueueList
- Назначение
-
Выдаёт сведения о почтовой очереди модуля. Если имя модуля не указано или пустое, выдаётся общая очередь.
- Синтаксис
MailQueueList ("moduleName" (start limit))
| Параметр | Описание |
|---|---|
|
Имя почтового модуля. Если не указано или пустое — общая очередь. |
|
Список начинается с QUEUE ID больше указанного. |
|
Максимальное количество записей. Если |
- Пример
MailQueueList "SMTP"
MailBatchList
- Назначение
-
Выдаёт сведения об активных или ожидающих блоках доставки в очереди почтового модуля.
- Синтаксис
MailBatchList "moduleName" (true|false) (start limit)
| Параметр | Описание |
|---|---|
|
Имя почтового модуля. |
|
Список начинается с QUEUE ID больше указанного. |
|
Максимальное количество записей. Если |
ModuleReadConfig
- Назначение
-
Выдаёт словарь настроек модуля.
- Синтаксис
ModuleReadConfig "moduleName" (true)
| Параметр | Описание |
|---|---|
|
Имя почтового модуля. |
|
Не обязательный параметр. Если задано |
ModuleUpdateConfig
- Назначение
-
Обновляет настройки модуля.
- Синтаксис
ModuleUpdateConfig "moduleName" deleteKeys updateKeyVals
| Параметр | Описание |
|---|---|
|
Имя модуля. |
|
Массив ключей для удаления из настроек (вместо них будут использоваться значения по умолчанию). |
|
Массив пар ключ-значение, по которому значения указанных ключей заменяются на новые. |
ModuleSetLogLevel
- Назначение
-
Изменяет уровень журналирования модуля.
- Синтаксис
ModuleSetLogLevel "moduleName" level
| Параметр | Описание |
|---|---|
|
Имя модуля. |
|
Уровень журналирования. |
- Уровни журналирования
| Значение | Уровень |
|---|---|
|
Критические ошибки |
|
Ошибки |
|
Информация |
|
Предупреждения |
|
Подробности |
|
Отладочный |
- Пример
ModuleSetLogLevel "IMAP" 0
ModuleGetSetting
- Назначение
-
Выдаёт объект настроек модуля.
- Синтаксис
ModuleGetSetting "moduleName" "key"|["key1","key2",..]
| Параметр | Описание |
|---|---|
|
Имя модуля. |
|
Объект/объекты настроек модуля. |
ModuleSetSetting
- Назначение
-
Устанавливает объект настроек модуля.
- Синтаксис
ModuleSetSetting "moduleName" "key"|["key1","key2",..] {object}
ModuleDelSetting
- Назначение
-
Удаляет объект настроек модуля и возвращает значение по умолчанию.
- Синтаксис
ModuleDelSetting "moduleName" "key"|["key1","key2",..]
| Параметр | Описание |
|---|---|
|
Имя модуля. |
|
Объект/объекты настроек модуля. |
DigestList
- Назначение
-
Выдаёт список методов хэширования.
- Синтаксис
DigestList
CipherList
- Назначение
-
Выдаёт список методов шифрования.
- Синтаксис
CipherList
KDFList
- Назначение
-
Выдаёт список методов преобразования паролей в ключи.
- Синтаксис
KDFList
ThreadsList
- Назначение
-
Выдаёт список потоков выполнения.
- Синтаксис
ThreadsList ("filter")
| Параметр | Описание |
|---|---|
|
Не обязательный строковый параметр. Если параметр задан, то выводится информация только о тех потоках, чьё описание содержит эту строку. |
ConnectionsList
- Назначение
-
Выдаёт список активных сетевых соединений.
- Синтаксис
ConnectionsList ("moduleName") ("filter")
| Параметр | Описание |
|---|---|
|
Имя модуля. Если задано, то выводится информация только о соединениях этого модуля. |
|
Не обязательный строковый параметр. Если параметр задан, то выводится информация только о тех соединениях, чьё описание содержит эту строку. |
LogsList
- Назначение
-
Выдаёт список файлов журналов указанного типа с размерами в байтах.
- Синтаксис
LogsList (""|"MailQueue"|"Settings"|"Auth"|"Block")
| Параметр | Описание |
|---|---|
|
Тип журнала. Если не указан или пустая строка — возвращается список основных журналов сервера. |
LogsRemove
- Назначение
-
Удаляет файлы журналов указанного типа, перечисленные в массиве.
- Синтаксис
LogsRemove ""|"MailQueue"|"Settings"|"Auth"|"Block" ["logName1","logName2",...]
| Параметр | Описание |
|---|---|
|
Тип журнала. Пустая строка — основные журналы сервера. |
|
Имена файлов журнала без расширения. |
Maintenance
- Назначение
-
Запускает задачу обслуживания Maintenance для всего сервера, или для отдельного домена, или для отдельного аккаунта.
- Синтаксис
Maintenance "*"|"domain"|"user@domain" ("SubtaskName")
| Параметр | Описание |
|---|---|
|
Запуск обслуживания всего сервера, отдельного домена, отдельного аккаунта соответственно. |
|
Имя подзадачи (не обязательный параметр). Если не указано, то выполняются подзадачи с 1 по 8. Если указана, то выполняется только указанная. |
- Подзадачи
SubtaskName
| Номер | Имя | Описание |
|---|---|---|
1. |
|
Очистка папки Корзины от старых сообщений в аккаунте. |
2. |
|
Очистка папки Спам от старых сообщений в аккаунте. |
3. |
|
Удаление старых сообщений из всех папок в аккаунте. |
4. |
|
Перемещение старых сообщений из папок INBOX и Отправленные в подпапки Архивы с раскладкой по кварталам года. |
5. |
|
Перемещение старых сообщений из всех папок в подпапки Архивы с сохранением оригинальной структуры папок. |
6. |
|
Удаление старых старых календарных событий из всех календарей в аккаунте. |
7. |
|
Перемещение старых календарных событий из главного календаря в подпапки Архивы с раскладкой по кварталам года |
8. |
|
Удаляет из домена объекты, имеющие в настройках ключ |
SystemInfo
- Назначение
-
Выдаёт общие сведения о сервере.
- Синтаксис
SystemInfo
AdminAlertsGet
- Назначение
-
Выдаёт список активных (не просроченных) системных предупреждений: остановка сервера, потоки, соединения, слушатели, DNS, плагины, файлы, приближение истечения срока действия лицензии и т.д.
- Синтаксис
AdminAlertsGet
MyRights
- Назначение
-
Выдаёт текущие права администратора данного CMD-подключения.
- Синтаксис
MyRights
Geolocation
- Назначение
-
Выдаёт геолокационные данные по IP-адресу.
- Синтаксис
Geolocation "ip address" ("language")
| Параметр | Описание |
|---|---|
|
IP-адрес. |
|
Язык локали (не обязательный параметр). |
MailBatchInfo
- Назначение
-
Выдаёт сведения о блоке доставки
batchв очереди почтового модуляmoduleName. - Синтаксис
MailBatchInfo "moduleName" "batch"
MailBatchWake
- Назначение
-
Возобновляет обработку ожидающего блока доставки
batchв очереди почтового модуляmoduleName. - Синтаксис
MailBatchWake "moduleName" "batch"
MailQueueInfo
- Назначение
-
Выдаёт сведения о письме в очереди по его идентификатору
fileID. - Синтаксис
MailQueueInfo fileID
MailQueueFail
- Назначение
-
Удаляет письмо
fileIDиз очереди. Необязательный параметрreasonзадаёт текст ошибки, который записывается для адресатов письма. - Синтаксис
MailQueueFail fileID ("reason")
MyAdminRights
- Назначение
-
Выдаёт административные права, с которыми работает текущее CLI-соединение.
- Синтаксис
MyAdminRights
TotpGenerate
- Назначение
-
Создаёт TOTP-ключ для идентификатора
identifierи выдаёт ссылкуotpauth://для добавления ключа в приложение-аутентификатор. - Синтаксис
TotpGenerate "identifier"
Работа с доменами
DomainsList
- Назначение
-
Выдаёт список зарегистрированных доменов в виде словаря с числовыми ключами. Ключ —
UIDдомена, значение — основное имя домена. - Синтаксис
DomainsList ("filter"|false|true|null )
| Параметр | Описание |
|---|---|
|
Фильтр поиска. Если задан фильтр поиска, то будет произведена фидльтрация по наличию подстроки как в основном имени домена, так и в псевдониме. Если вместо фильтра указать Если вместо фильтра указать |
DomainCreate
- Назначение
-
Создаёт домен.
- Синтаксис
DomainCreate "domName" (null)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Указывается для создания кластерного домена. |
- Пример 1
DomainCreate "example.org"
- Пример 2
DomainCreate "cluster.dom" (null)
DomainRemove
- Назначение
-
Удаляет домен.
- Синтаксис
DomainRemove "domName"|domUID
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
DomainRename
- Назначение
-
Переименовывает домен.
- Синтаксис
DomainRename "domName"|domUID "newName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Новое имя домена. |
DomainGetID
- Назначение
-
Выдаёт UID домена по его имени.
- Синтаксис
DomainGetID "domName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
DomainListNames
- Назначение
-
Выдаёт список всех имён домена по его имени.
- Синтаксис
DomainListNames "domName"|domUID
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
DomainAddName
- Назначение
-
Добавляет домену дополнительное имя.
- Синтаксис
DomainAddName "domName"|domUID "newName" (flag)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Добавляемое имя домена. |
|
Необязательный флаг применения имени. По умолчанию |
DomainDelName
- Назначение
-
Удаляет имя домена.
- Синтаксис
DomainDelName "domName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
DomainUseName
- Назначение
-
Делает имя основным.
- Синтаксис
DomainUseName "domName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
DomainMoveName
- Назначение
-
Переносит новое имя домену.
- Синтаксис
DomainMoveName "domName"|domUID "newName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Новое имя домена. |
DomainGetFlags
- Назначение
-
Выдаёт флаги доменного имени.
- Синтаксис
DomainGetFlags "domName"
| Параметр | Описание |
|---|---|
|
Имя домена. |
DomainSetFlags
- Назначение
-
Устанавливает флаги доменного имени.
- Синтаксис
DomainSetFlags "domName" flag
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Флаг применения имени домена. |
DomainReadConfig
- Назначение
-
Выдаёт объект настроек домена.
- Синтаксис
DomainReadConfig "domName"|domUID (true|false)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Дополнительный параметр. Если указан |
DomainGetSetting
- Назначение
-
Выдаёт значение настройки домена по ключу или пути из массива ключей.
- Синтаксис
DomainGetSetting "domName"|domUID "key"|["key1","key2",..] (true)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Объект/объекты настроек домена. |
DomainSetSetting
- Назначение
-
Устанавливает значение настройки в объект настроек домена.
- Синтаксис
DomainSetSetting "domName"|domUID "key"|["key1","key2",..] {object}
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Объект/объекты настроек домена. |
|
Значение настройки. |
DomainDelSetting
- Назначение
-
Удаляет настройку домена, возвращая значение по умолчанию.
- Синтаксис
DomainDelSetting "domName"|domUID "key"|["key1","key2",..]
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Объект/объекты настроек домена для удаления. |
DomainUpdateConfig
- Назначение
-
Обновляет настройки домена.
- Синтаксис
DomainUpdateConfig "domName"|domUID deleteKeys updateKeyVals
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Массив ключей для удаления из настроек (вместо них будут использоваться значения по умолчанию). |
|
Массив вида ключ-значение, по которому значения, указанных ключей заменяются на новые. |
DomainsDefaults
- Назначение
-
Выдаёт объект настроек по умолчанию для доменов.
- Синтаксис
DomainsDefaults (true|false) (null)
| Параметр | Описание |
|---|---|
|
Дополнительный параметр. Если задан |
|
Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов. |
DomainsGetDefault
- Назначение
-
Выдаёт настройку доменов по умолчанию.
- Синтаксис
DomainsGetDefault "key"|["key1","key2",..] (null)
| Параметр | Описание |
|---|---|
|
Объект/объекты настроек по умолчанию. |
|
Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов. |
DomainsSetDefault
- Назначение
-
Изменяет настройки доменов по умолчанию.
- Синтаксис
DomainsSetDefault "key"|["key1","key2",..] {object} (null)
| Параметр | Описание |
|---|---|
|
Объект/объекты настроек по умолчанию. |
|
Значение для объекта настроек. |
|
Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов. |
DomainsDelDefault
- Назначение
-
Удаляет объект настроек по умолчанию для доменов.
- Синтаксис
DomainsDelDefault "key"|["key1","key2",..] (null)
| Параметр | Описание |
|---|---|
|
Объект/объекты настроек по умолчанию. |
|
Дополнительный параметр. Если параметр задан, то выдаются значения по умолчанию для кластерных доменов. |
DomainsUpdateDefaults
- Назначение
-
Обновляет настройки доменов по умолчанию.
- Синтаксис
DomainsUpdateDefaults deleteKeys updateKeyVals (null)
| Параметр | Описание |
|---|---|
|
Массив для удаления из настроек (вместо них будут использоваться значения по умолчанию). |
|
Массив вида ключ-значение, по которому значения указанных ключей заменяются на новые. |
|
Дополнительный параметр. Если параметр задан, то изменяются значения по умолчанию для кластерных доменов. |
DomainGetIPs
- Назначение
-
Выдаёт глобальную карту соответствия "IP-адрес — домен".
- Синтаксис
DomainGetIPs
DomainSetIPs
- Назначение
-
Устанавливает для домена список IP-адресов и обновляет глобальную карту.
- Синтаксис
DomainSetIPs "domName"|domUID {object}
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Список IP-адресов для домена. |
KerberosKeyAdd
- Назначение
-
Добавляет в домен запись keytab Kerberos. Содержимое keytab передаётся в параметре
keytabBase64в кодировке Base64. - Синтаксис
KerberosKeyAdd "domName"|domUID "keytabBase64"
KerberosKeyList
- Назначение
-
Выдаёт список записей keytab Kerberos домена.
- Синтаксис
KerberosKeyList "domName"|domUID
KerberosKeyRemove
- Назначение
-
Удаляет запись keytab Kerberos из домена по индексу
index. - Синтаксис
KerberosKeyRemove "domName"|domUID index
DomainGetMultiSet
- Назначение
-
Выдаёт значения нескольких настроек домена. Ключи настроек передаются массивом
requestKeys; допускаются только ключи верхнего уровня. - Синтаксис
DomainGetMultiSet "domName"|domUID requestKeys
DomainHasInList
- Назначение
-
Проверяет, есть ли значение
objectв списке, который хранится в настройке доменаkey. - Синтаксис
DomainHasInList "domName"|domUID "key"|["key1",..] {object}
DomainAddToList
- Назначение
-
Добавляет значение
objectв список, который хранится в настройке доменаkey. - Синтаксис
DomainAddToList "domName"|domUID "key"|["key1",..] {object}
DomainDelInList
- Назначение
-
Удаляет значение
objectиз списка, который хранится в настройке доменаkey. - Синтаксис
DomainDelInList "domName"|domUID "key"|["key1",..] {object}
DomainGetWebAccessURL
- Назначение
-
Выдаёт адрес (URL) веб-сервера для пользователей домена.
- Синтаксис
DomainGetWebAccessURL "domName"|domUID
DomainGetSecurity
- Назначение
-
Выдаёт сведения о TLS-контексте (профиле сертификата), который сейчас используется доменом.
- Синтаксис
DomainGetSecurity "domName"|domUID
DomainListSecureCTX
- Назначение
-
Выдаёт список TLS-контекстов (профилей сертификатов), настроенных в домене.
- Синтаксис
DomainListSecureCTX "domName"|domUID
DomainAddSecureCtx
- Назначение
-
Добавляет в домен TLS-контекст (профиль сертификата) с именем
name. В параметрах передаются сертификатcert, закрытый ключkeyи, при необходимости, цепочка сертификатовchain. - Синтаксис
DomainAddSecureCtx "domName"|domUID "name" "cert" "key" ("chain")
DomainDelSecureCtx
- Назначение
-
Удаляет из домена TLS-контекст с именем
name. - Синтаксис
DomainDelSecureCtx "domName"|domUID "name"
DomainGetSecureCtx
- Назначение
-
Выдаёт содержимое TLS-контекста
name: массив из сертификата, закрытого ключа и цепочки сертификатов в формате PEM. - Синтаксис
DomainGetSecureCtx "domName"|domUID "name"
DomainSelSecureCtx
- Назначение
-
Делает TLS-контекст
nameактивным для домена. Необязательным массивом[crt,key,chn]можно заменить отдельные части контекста: сертификат, ключ, цепочку. - Синтаксис
DomainSelSecureCtx "domName"|domUID "name" ([crt,key,chn])
DomainClrSecureCtx
- Назначение
-
Отменяет выбор TLS-контекста для домена.
- Синтаксис
DomainClrSecureCtx "domName"|domUID (false)
DomainGetStats
- Назначение
-
Выдаёт статистику использования ресурсов домена.
- Синтаксис
DomainGetStats "domName"|domUID
Работа с объектами в доменах
ObjectsList
- Назначение
-
Выдаёт список зарегистрированных объектов домена в виде словаря с числовыми ключами: ключ —
UIDобъекта, значение — основное имя объекта. - Синтаксис
ObjectsList "domName"|domUID ("filter"|false|true ) (start limit ([fields]))
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Фильтр поиска. Если указать фильтр поиска Если строка фильтра начинается с символа Если вместо фильтра поиска указать значение |
|
Числовые параметры. Если заданы |
|
Массив ключей (не обязательный параметр). Если массив указан, их значения должны быть включены в информацию об объекте, например |
ForwarderCreate
- Назначение
-
Создаёт переадресатор.
- Синтаксис
ForwarderCreate "domName"|domUID "fwdName" "destination"
GroupCreate
- Назначение
-
Создаёт группу.
- Синтаксис
GroupCreate "domName"|domUID "grpName" (settingsDict|settingsKeyValArray)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
Числовой идентификатор домена. |
|
Имя группы. |
|
Опциональный словарь |
MailingListCreate
- Назначение
-
Создаёт список рассылки.
- Синтаксис
MailingListCreate "domName"|domUID "mlName" "owner" ("mountName")
| Параметр | Описание |
|---|---|
|
Адрес владельца в формате строки. |
|
Точка монтирования в формате строки (опционально). |
ObjectRemove
- Назначение
-
Удаляет объект.
- Синтаксис
ObjectRemove "domName"|domUID "objName"|objUID
ObjectRename
- Назначение
-
Переименовывает объект.
- Синтаксис
ObjectRename "domName"|domUID "objName"|objUID "newName"
ObjectGetID
- Назначение
-
Выдаёт UID объекта по его имени
objName. - Синтаксис
ObjectGetID "domName"|domUID "objName" ("instanceid")
ObjectListNames
- Назначение
-
Выдаёт список имён объекта.
- Синтаксис
ObjectListNames "domName"|domUID "objName"|objUID
ObjectAddName
- Назначение
-
Добавляет объекту дополнительное имя
newName. Необязательный параметрflagзадаёт флаг применения имени (по умолчанию255). - Синтаксис
ObjectAddName "domName"|domUID "objName"|objUID "newName" (flag)
ObjectDelName
- Назначение
-
Удаляет имя объекта.
- Синтаксис
ObjectDelName "domName"|domUID "objName"
ObjectUseName
- Назначение
-
Делает имя
objNameосновным именем объекта (первым в списке его имён). Имя должно принадлежать объекту. - Синтаксис
ObjectUseName "domName"|domUID "objName"
ObjectMoveName
- Назначение
-
Переносит имя объекту.
- Синтаксис
ObjectMoveName "domName"|domUID "destName"|destUID "newName"
ObjectGetFlags
- Назначение
-
Выдаёт флаги имени объекта.
- Синтаксис
ObjectGetFlags "domName"|domUID "objName"
ObjectSetFlags
- Назначение
-
Устанавливает флаги имени объекта.
- Синтаксис
ObjectSetFlags "domName"|domUID "objName" flag
ObjectReadConfig
- Назначение
-
Выдаёт настройки объекта.
- Синтаксис
ObjectReadConfig "domName"|domUID "objName"|objUID (true|false)
ObjectGetSetting
- Назначение
-
Выдаёт настройку объекта.
- Синтаксис
ObjectGetSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..] (true)
ObjectSetSetting
- Назначение
-
Изменяет настройку объекта.
- Синтаксис
ObjectSetSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}
ObjectDelSetting
- Назначение
-
Удаляет настройку объекта.
- Синтаксис
ObjectDelSetting "domName"|domUID "objName"|objUID "key"|["key1","key2",..]
ObjectHasInList
- Назначение
-
Проверяет наличие значения в списке настройки.
- Синтаксис
ObjectHasInList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}
ObjectAddToList
- Назначение
-
Добавляет значение в список настройки.
- Синтаксис
ObjectAddToList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}
ObjectDelInList
- Назначение
-
Удаляет значение из списка настройки.
- Синтаксис
ObjectDelInList "domName"|domUID "objName"|objUID "key"|["key1","key2",..] {object}
ObjectUpdateConfig
- Назначение
-
Обновляет настройки объекта.
- Синтаксис
ObjectUpdateConfig "domName"|domUID "objName"|objUID deleteKeys updateKeyVals
ObjectsCount
- Назначение
-
Выдаёт количество объектов в домене.
- Синтаксис
ObjectsCount "domName"|domUID
AccountCreateMP
- Назначение
-
Создаёт аккаунт
accNameна точке монтированияmountNameдомена. Необязательный параметр — словарь настроекsettingsDictили массивsettingsKeyValArray, в котором чередуются названия настроек и их значения. Эти настройки применяются сразу после создания аккаунта. - Синтаксис
AccountCreateMP "domName"|domUID "mountName" "accName" (settingsDict|settingsKeyValArray)
ResourceCreate
- Назначение
-
Создаёт ресурсный аккаунт
resNameс владельцемowner. - Синтаксис
ResourceCreate "domName"|domUID "resName" "owner"
ResourceCreateMP
- Назначение
-
Создаёт ресурсный аккаунт
resNameс владельцемownerна точке монтированияmountNameдомена. - Синтаксис
ResourceCreateMP "domName"|domUID "mountName" "resName" "owner"
ForwarderCreateMP
- Назначение
-
Создаёт переадресатор
fwdNameна точке монтированияmountNameдомена. Письма, отправленные на адрес переадресатора, перенаправляются на адресdestination. - Синтаксис
ForwarderCreateMP "domName"|domUID "mountName" "fwdName" "destination"
GroupCreateMP
- Назначение
-
Создаёт группу
grpNameна точке монтированияmountNameдомена. Необязательный параметр — словарь настроекsettingsDictили массивsettingsKeyValArray, в котором чередуются названия настроек и их значения. Эти настройки применяются сразу после создания группы. - Синтаксис
GroupCreateMP "domName"|domUID "mountName" "grpName" (settingsDict|settingsKeyValArray)
ObjectGetMultiSet
- Назначение
-
Выдаёт значения нескольких настроек объекта. Ключи настроек передаются массивом
requestKeys; допускаются только ключи верхнего уровня. - Синтаксис
ObjectGetMultiSet "domName"|domUID "objName"|objUID requestKeys
ObjectSetInactive
- Назначение
-
Блокирует или разблокирует аккаунт.
-
inactive—true: аккаунт становится неактивным;false: аккаунт снова становится активным. -
killsessions— необязательный параметр. Еслиtrue, при блокировке закрываются все активные сессии аккаунта. Учитывается, только еслиinactiveравенtrue.
-
- Синтаксис
ObjectSetInactive "domName"|domUID "accName"|accUID inactive (killsessions)
ObjectExport
- Назначение
-
Выгружает объект домена в архив и выдаёт путь к папке с архивом.
Архивы сохраняются относительно рабочего каталога сервера: в
Cluster/Exportsв кластерной конфигурации и вExportsна одиночном сервере. Параметрprefixдобавляется к имени архива. - Синтаксис
ObjectExport "domName"|domUID "objName"|objUID "prefix"
ObjectImport
- Назначение
-
Загружает объект в домен из архива. Параметр
path— путь к папке с архивом относительно рабочего каталога сервера. - Синтаксис
ObjectImport "domName"|domUID "path"
Работа с аккаунтами
AccountCreate
- Назначение
-
Создаёт аккаунт в домене. Настройки из необязательного параметра применяются сразу после создания аккаунта.
- Синтаксис
AccountCreate "domName"|domUID "accName" (settingsDict|settingsKeyValArray)
| Параметр | Описание |
|---|---|
|
Имя домена. |
|
UID домена. |
|
Имя аккаунта. |
|
Необязательный словарь настроек или массив с чередующимися названиями настроек и их значениями. |
- Пример
AccountCreate "example.org" "user1"
AccountsDefaultProfileCreate
- Назначение
-
Создаёт профиль настроек аккаунтов.
- Синтаксис
AccountsDefaultProfileCreate "domName"|domUID|null "defaults_profile" (true)
Если вместо домена передан null, профиль создаётся на уровне кластера.
|
AccountsDefaultProfileRemove
- Назначение
-
Удаляет профиль настроек аккаунтов.
- Синтаксис
AccountsDefaultProfileRemove "domName"|domUID|null "defaults_profile" (true)
AccountsDefaultProfileList
- Назначение
-
Выдаёт список профилей настроек аккаунтов.
Уровень задаётся первым параметром:
-
имя или UID домена — уровень домена;
-
пустая строка или
0— уровень сервера; -
null— уровень кластера.
Если указать
true, выдаются профили без учёта профилей, унаследованных с вышестоящих уровней. Второй необязательный флаг используется для взаимодействия узлов кластера. -
- Синтаксис
AccountsDefaultProfileList "domName"|domUID|null (true|false (true))
AccountSetPassword
- Назначение
-
Задаёт пароль аккаунта. Необязательный параметр
tagзадаёт метку пароля; пустая строка — основной пароль. - Синтаксис
AccountSetPassword "domName"|domUID "accName"|accUID "password" ("tag")
- Пример
AccountSetPassword "example.org" "user1" "secret123"
AccountVerifyPwd
- Назначение
-
Проверяет пароль аккаунта.
- Синтаксис
AccountVerifyPwd "domName"|domUID "accName"|accUID "password" ("tag")
AccountGetPassword
- Назначение
-
Выдаёт пароль аккаунта с меткой
tag; пустая строка — основной пароль. - Синтаксис
AccountGetPassword "domName"|domUID "accName"|accUID ("tag")
AccountsDefaults
- Назначение
-
Выдаёт настройки аккаунтов по умолчанию.
- Синтаксис
AccountsDefaults "domName"|domUID|null ("profileName") (true|false)
AccountsGetDefault
- Назначение
-
Выдаёт настройку аккаунтов по умолчанию.
- Синтаксис
AccountsGetDefault "domName"|domUID|null "key"|["key1","key2",..] ("profileName")
AccountsSetDefault
- Назначение
-
Изменяет настройку аккаунтов по умолчанию.
- Синтаксис
AccountsSetDefault "domName"|domUID|null "key"|["key1","key2",..] obj ("profileName")
AccountsDelDefault
- Назначение
-
Удаляет настройку аккаунтов по умолчанию.
- Синтаксис
AccountsDelDefault "domName"|domUID|null "key"|["key1","key2",..] ("profileName")
AccountsUpdateDefs
- Назначение
-
Обновляет настройки аккаунтов по умолчанию.
- Синтаксис
AccountsUpdateDefs "domName"|domUID|null deleteKeys updateKeyVals ("profileName")
AccountListNamespaces
- Назначение
-
Выдаёт список пространств имён папок аккаунта.
- Синтаксис
AccountListNamespaces "domName"|domUID "accName"|accUID
AccountListMailboxes
- Назначение
-
Выдаёт список почтовых папок аккаунта.
- Синтаксис
AccountListMailboxes "domName"|domUID "accName"|accUID "namespace"
Пространство имён может быть пустым или иметь вид ~user@domain/.
|
AccountGetMailStorageSize
- Назначение
-
Выдаёт размер почтового хранилища аккаунта.
- Синтаксис
AccountGetMailStorageSize "domName"|domUID "accName"|accUID (true)
AccountDelPassword
- Назначение
-
Удаляет пароль аккаунта. Необязательный параметр
tagзадаёт метку пароля; пустая строка — основной пароль. - Синтаксис
AccountDelPassword "domName"|domUID "accName"|accUID ("tag")
AccountCloseSessions
- Назначение
-
Закрывает все сессии аккаунта.
- Синтаксис
AccountCloseSessions "domName"|domUID "accName"|accUID
AccountListOpenMboxes
- Назначение
-
Выдаёт список папок аккаунта, открытых в данный момент.
- Синтаксис
AccountListOpenMboxes "domName"|domUID "accName"|accUID
DataFilesRebuild
- Назначение
-
Восстанавливает сведения о файлах аккаунта по фактически хранящимся данным.
- Синтаксис
DataFilesRebuild "domName"|domUID "accName"|accUID
DataFilesList
- Назначение
-
Выдаёт сведения о файлах и папках аккаунта по пути
path. Необязательный параметрdepthзадаёт глубину обхода вложенных папок (по умолчанию1). - Синтаксис
DataFilesList "domName"|domUID "accName"|accUID "path" (depth)
DataFilesSetACL
- Назначение
-
Задаёт права доступа пользователя
userNameк файлу или папке аккаунта по путиpath.Параметр
aclможет содержать символы:-
r— чтение файла или просмотр содержимого папки; -
w— запись или удаление файла или папки.
Если
acl— пустая строка, права пользователя на этот путь удаляются.В параметре
userNameможно указать:-
полное имя аккаунта, например
user@domain.dom; -
полный идентификатор аккаунта в формате
=accountId@=domainId; -
anyone@— любой аккаунт домена владельца; -
anyone— любой аккаунт и анонимный доступ.
-
- Синтаксис
DataFilesSetACL "domName"|domUID "accName"|accUID "path" "userName" "acl"
DataFiles
- Назначение
-
Выполняет операцию с файлом или папкой аккаунта. Операция задаётся третьим параметром:
-
read— выдаёт содержимое файлаpath1; -
write— записывает в файлpath1содержимое из последнего параметра; существующий файл перезаписывается; -
remove— удаляет файл или папкуpath1; папки удаляются вместе с содержимым; -
mkdir— создаёт папкуpath1и все недостающие родительские папки; -
move— перемещает файл или папкуpath1вpath2; существующий файл перезаписывается; -
copy— копирует файл или папкуpath1вpath2без вложенного содержимого; существующий файл перезаписывается; -
url— выдаёт ссылку для скачивания файлаpath1.
-
- Синтаксис
DataFiles "domName"|domUID "accName"|accUID "read|write|remove|mkdir|move|copy|url" "path1" ["path2|content"]
Работа с группами
GroupListMembers
- Назначение
-
Выдаёт список участников группы.
-
mailsFlag— еслиtrue, выдаются адреса электронной почты участников; иначе для локальных участников выдаются их канонические имена. -
filter— шаблон, по которому отбираются участники.
Если вместо группы указать аккаунт, выдаётся список групп, в которые он входит.
-
- Синтаксис
GroupListMembers "domName"|domUID "grpName"|grpUID (mailsFlag ("filter"))
GroupAddAccount
- Назначение
-
Добавляет в группу участника или массив участников. Если указать
true, сохраняется адрес электронной почты; иначе для локальных участников сохраняется их UID. - Синтаксис
GroupAddAccount "domName"|domUID "grpName"|grpUID "addr"|[list] (mail)
GroupDelAccount
- Назначение
-
Удаляет из группы участника или массив участников. Если указать
true, участник ищется по адресу с учётом маршрутизации. - Синтаксис
GroupDelAccount "domName"|domUID "grpName"|grpUID "addr"|[list] (mail)
GroupHasAccount
- Назначение
-
Проверяет наличие участника в группе.
- Синтаксис
GroupHasAccount "domName"|domUID "grpName"|grpUID "addr" (mail)
GroupGetOwner
- Назначение
-
Выдаёт владельца группы.
- Синтаксис
GroupGetOwner "domName"|domUID "grpName"|grpUID
GroupSetOwner
- Назначение
-
Назначает владельца группы.
- Синтаксис
GroupSetOwner "domName"|domUID "grpName"|grpUID "addr"
Работа со списками рассылки
MailingListGetMembers
- Назначение
-
Возвращает адреса участников списка рассылки.
- Синтаксис
MailingListGetMembers "domName"|domUID "mlName"|mlUID
MailingListAddMember
- Назначение
-
Добавляет один или несколько адресов участников списка рассылки.
- Синтаксис
MailingListAddMember "domName"|domUID "mlName"|mlUID "addr"|[list]
| Параметр | Описание |
|---|---|
|
Адрес участника в формате строки или список адресов в формате массива JSON. |
MailingListDelMember
- Назначение
-
Удаляет один или несколько адресов участников списка рассылки.
- Синтаксис
MailingListDelMember "domName"|domUID "mlName"|mlUID "addr"|[list]
| Параметр | Описание |
|---|---|
|
Адрес участника в формате строки или список адресов в формате массива JSON. |
MailingListGetMember
- Назначение
-
Возвращает текущие параметры участника списка рассылки.
- Синтаксис
MailingListGetMember "domName"|domUID "mlName"|mlUID "addr"
| Параметр | Описание |
|---|---|
|
Адрес участника в формате строки. |
MailingListRouteMember
- Назначение
-
Возвращает список адресов на которые оформлена подписка участника списка рассылки.
- Синтаксис
MailingListRouteMember "domName"|domUID "mlName"|mlUID "addr"
| Параметр | Описание |
|---|---|
|
Адрес участника в формате строки. |
MailingListGetOwner
- Назначение
-
Возвращает адрес владельца списка рассылки.
- Синтаксис
MailingListGetOwner "domName"|domUID "mlName"|mlUID
MailingListSetOwner
- Назначение
-
Устанавливает адрес владельца списка рассылки.
- Синтаксис
MailingListSetOwner "domName"|domUID "mlName"|mlUID "addr"
| Параметр | Описание |
|---|---|
|
Адрес владельца в формате строки. |
MailingListGetSubscription
- Назначение
-
Возвращает статус подписки участника списка рассылки.
- Синтаксис
MailingListGetSubscription "domName"|domUID "mlName"|mlUID
MailingListSetSubscription
- Назначение
-
Устанавливает статус подписки участника списка рассылки.
- Синтаксис
MailingListSetSubscription "domName"|domUID "mlName"|mlUID "addr" "subscription"
| Параметр | Описание |
|---|---|
|
Адрес владельца в формате строки. |
|
Статус подписки. |
- Статусы подписки
subscription
| Статус | Описание |
|---|---|
|
Участник может принимать и отправлять сообщения, изменять статус подписки. |
|
Участник может только отправлять сообщения и изменять статус подписки. |
|
Участник может отправлять и получать автоматически сгенерированные сообщения, и изменять статус подписки. |
|
Подписка приостановлена, участник не может отправлять и получать сообщения, а также изменять статус подписки. |
Работа с папками
MailboxesList
- Назначение
-
Выдаёт словарь папок аккаунта. Ключи словаря — полные имена папок в формате, заданном параметром
mode. - Синтаксис
MailboxesList "domName"|domUID "accName"|accUID ("optClass" (mode (parent)))
| Параметр | Описание |
|---|---|
|
Класс папок, которые попадут в результат. |
|
Формат имён папок: |
|
UID папки, вложенные папки которой нужно вывести. |
MailboxCreate
- Назначение
-
Создаёт в аккаунте папку
newNameклассаoptClass. Если класс не указан, создаётся почтовая папка (mail).Поддерживаемые классы:
mail,calendar,contacts,notes,tasks.Любое написание имени
Inboxв корне аккаунта приводится кINBOX. - Синтаксис
MailboxCreate "domName"|domUID "accName"|accUID "newName" "optClass"
MailboxRename
- Назначение
-
Переименовывает папку.
- Синтаксис
MailboxRename "domName"|domUID "accName"|accUID "oldName" "newName"
MailboxRemove
- Назначение
-
Удаляет папку
toDeleteвместе со всеми вложенными папками. - Синтаксис
MailboxRemove "domName"|domUID "accName"|accUID "toDelete" ("timeToDelete")
MailboxGetACL
- Назначение
-
Выдаёт ACL папки.
- Синтаксис
MailboxGetACL "domName"|domUID "accName"|accUID "mboxName"
MailboxUpdateACL
- Назначение
-
Изменяет ACL папки.
- Синтаксис
MailboxUpdateACL "domName"|domUID "accName"|accUID "mboxName" "identifier" ("rights")
MboxGetInfo
- Назначение
-
Выдаёт значение метаданных папки по ключу
settings.key. Если ключ не указан, выдаются все сведения о папке. - Синтаксис
MboxGetInfo "domName"|domUID "accName"|accUID "mboxName"|mboxUID ("settings.key")
MboxSetInfo
- Назначение
-
Задаёт значение метаданных папки по ключу
settings.key. Если значениеobjectне указано, ключ удаляется из метаданных. - Синтаксис
MboxSetInfo "domName"|domUID "accName"|accUID "mboxName"|mboxUID "settings.key" (object)
ObjectGetInfo
- Назначение
-
Выдаёт значение метаданных объекта по ключу или пути из массива ключей.
- Синтаксис
ObjectGetInfo "domName"|domUID "accName"|accUID "key"|[keys]
ObjectSetInfo
- Назначение
-
Задаёт значение метаданных объекта по ключу. Если значение
objectне указано, ключ удаляется из метаданных. - Синтаксис
ObjectSetInfo "domName"|domUID "accName"|accUID "key"|[keys] (object)
ObjectIncInfo
- Назначение
-
Увеличивает значение счётчика объекта.
- Синтаксис
ObjectIncInfo "domName"|domUID "accName"|accUID "settings.key" "delta" "limit.key"
ObjectIncTimedInfo
- Назначение
-
Увеличивает значение временного счётчика объекта.
- Синтаксис
ObjectIncTimedInfo "domName"|domUID "accname"|accUID "settingskey" "delta" "limitkey"
MailboxGetMyRights
- Назначение
-
Выдаёт права аккаунта на папку.
- Синтаксис
MailboxGetMyRights "domName"|domUID "accName"|accUID "mboxName"
CalendarGetACL
- Назначение
-
Выдаёт ACL календаря.
- Синтаксис
CalendarGetACL "domName"|domUID "accName"|accUID "mboxName"
CalendarUpdateACL
- Назначение
-
Изменяет ACL календаря.
- Синтаксис
CalendarUpdateACL "domName"|domUID "accName"|accUID "mboxName" "identifier" ("rights")
CalendarGetMyRights
- Назначение
-
Выдаёт права аккаунта на календарь.
- Синтаксис
CalendarGetMyRights "domName"|domUID "accName"|accUID "mboxName"
MboxMessageInfo
- Назначение
-
Выдаёт сведения о письме с UID
msgUIDв папке аккаунта. Папка задаётся именемmboxNameили UIDmbxUID. - Синтаксис
MboxMessageInfo "domName"|domUID "accName"|accUID "mboxName"|mbxUID msgUID
Работа с административными правами
RolesList
- Назначение
-
Выдаёт список административных ролей.
- Синтаксис
RolesList "domName"|domUID|null
RoleCreate
- Назначение
-
Создаёт административную роль
roleNameс правами из массива. Уровень задаётся так же, как в командеRolesList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
RoleCreate "domName"|domUID|null "roleName" ([rights] (true))
RoleRemove
- Назначение
-
Удаляет административную роль
roleName. Уровень задаётся так же, как в командеRolesList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
RoleRemove "domName"|domUID|null "roleName" (true)
RoleGet
- Назначение
-
Выдаёт список прав роли.
- Синтаксис
RoleGet "domName"|domUID|null "roleName"
RoleUpdate
- Назначение
-
Изменяет административную роль
roleName: удаляет права из массиваrightsDelи добавляет права из массиваrightsAdd. Уровень задаётся так же, как в командеRolesList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
RoleUpdate "domName"|domUID|null "roleName" [rightsDel] [rightsAdd] (true)
AdminsList
- Назначение
-
Выдаёт список администраторов.
- Синтаксис
AdminsList "domName"|domUID|null
AdminCreate
- Назначение
-
Назначает пользователя
userадминистратором с правами из массива. Уровень задаётся так же, как в командеAdminsList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
AdminCreate "domName"|domUID|null "user" ([rights] (true))
AdminRemove
- Назначение
-
Удаляет пользователя
userиз списка администраторов. Уровень задаётся так же, как в командеAdminsList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
AdminRemove "domName"|domUID|null "user" (true)
AdminInfo
- Назначение
-
Выдаёт права администратора.
- Синтаксис
AdminInfo "domName"|domUID|null "user"
AdminUpdate
- Назначение
-
Изменяет права и роли администратора
user: удаляет права из массиваrightsDelи добавляет права из массиваrightsAdd. Уровень задаётся так же, как в командеAdminsList: домен, сервер или кластер. Необязательный флагtrueотключает рассылку уведомлений о смене прав по кластеру. - Синтаксис
AdminUpdate "domName"|domUID|null "user" [rightsDel] [rightsAdd] (true)
AccountGetRights
- Назначение
-
Выдаёт административные права аккаунта.
- Синтаксис
AccountGetRights "domName"|domUID "accName"|accUID
RightsList
- Назначение
-
Выдаёт список административных прав, доступных текущему администратору. Если указать
true, права выдаются вложенными словарями в соответствии с иерархией прав. - Синтаксис
RightsList (bWithHierarchy)
AccessDump
- Назначение
-
Выдаёт административные роли и список администраторов.
Уровень задаётся первым параметром:
-
имя или UID домена — уровень домена;
-
пустая строка или
0— уровень сервера; -
null— уровень кластера (на сервере вне кластера — уровень сервера).
-
- Синтаксис
AccessDump "domName"|domUID|null
AdminSet
- Назначение
-
Заменяет права и роли администратора
userв домене, на сервере или в кластере на права и роли из массива.Необязательные параметры:
-
первый — принудительный режим. Если пользователь не администратор и список прав не пуст, он назначается администратором. Если пользователь администратор и список прав пуст, он удаляется из списка администраторов;
-
второй — отключает рассылку уведомлений о смене прав по кластеру.
-
- Синтаксис
AdminSet "domName"|domUID|null "user" [rightsDel] (false) (false)
Работа со справочником
DirectoryFind
- Назначение
-
Выдаёт записи справочника, соответствующие запросу.
- Синтаксис
DirectoryFind "baseDn" "scope" "filter" ["field1","field2",...] "sorting" "cookie" limit
| Параметр | Описание |
|---|---|
|
Базовый DN. |
|
Область поиска: |
|
Фильтр в формате |
|
Атрибуты для каждой записи; |
|
Сортировка в формате |
|
Значение из последней записи предыдущего результата для загрузки следующей страницы; может быть пустым. |
|
Максимальное число записей в ответе (1..500, по умолчанию 100). |
DirectoryAdd
- Назначение
-
Добавляет в справочник запись с DN
dnи атрибутами из JSON-объектаattributes. - Синтаксис
DirectoryAdd "dn" {attributes}
DirectoryUpdate
- Назначение
-
Изменяет атрибуты записи справочника
dn: атрибуты из JSON-объектаchangedAttributesдобавляются к существующим или заменяют их. - Синтаксис
DirectoryUpdate "dn" {changedAttributes}
DirectoryMove
- Назначение
-
Перемещает запись справочника.
- Синтаксис
DirectoryMove "dn" "newDn"
DirectoryRemove
- Назначение
-
Удаляет запись справочника.
- Синтаксис
DirectoryRemove "dn"
DirectoryCleanup
- Назначение
-
Удаляет из справочника записи об удалённых объектах в DN
dnи всех дочерних записях. Обрабатывается только том, к которому относитсяdn.-
minTombstoneTime— удаляются записи только об объектах, удалённых раньше этого времени. По умолчанию — текущее время. -
Если
dnне указан, используется пустая строка.
-
- Синтаксис
DirectoryCleanup ("dn") ("minTombstoneTime")
DirectorySync
- Назначение
-
Запускает синхронизацию томов справочника, для которых настроено зеркалирование. Если указан
dn, синхронизируется только том с этим DN; иначе — все тома с зеркалированием. - Синтаксис
DirectorySync ("dn")
DomainsToDirectory
- Назначение
-
Синхронизирует справочник для доменов из массива. Если массив пустой, синхронизируются все домены.
- Синтаксис
DomainsToDirectory ["domName"|domUID]
Работа со справочником PostgreSQL
PgDirectoryFind
- Назначение
-
Выдаёт записи справочника, хранящегося в базе данных PostgreSQL, соответствующие запросу.
-
baseDn— базовый DN. -
scope— область поиска:base— запись с указанным DN,one— непосредственные дочерние записи,sub— все дочерние записи. -
filter— фильтр в формате(<поле>=<значение>); может быть пустым. В значении допускаются*(любое число символов) и?(один символ). Условия объединяются через(&(…)(…))(все условия) или(|(…)(…))(хотя бы одно). -
["field1","field2",…]— атрибуты для каждой записи;*— все доступные атрибуты. -
sorting— сортировка в формате[+-]<атрибут>; может быть пустой. -
cookie— значение из последней записи предыдущего результата для загрузки следующей страницы; может быть пустым. -
limit— максимальное число записей в ответе (1..500, по умолчанию 100). -
последний параметр — URI подключения к базе данных в формате
postgres://user:pass@host:port/db.
-
- Синтаксис
PgDirectoryFind "baseDn" "scope" "filter" ["field1","field2",...] "sorting" "cookie" limit 'postgres://user:pass@host:port/db'
PgDirectoryAdd
- Назначение
-
Добавляет запись с DN
dnи атрибутами из JSON-объектаattributesв справочник в базе данных PostgreSQL. Параметрserver— URI подключения в форматеpostgres://user:pass@host:port/db. - Синтаксис
PgDirectoryAdd "dn" {attributes} "server"
PgDirectoryUpdate
- Назначение
-
Изменяет атрибуты записи
dnв справочнике в базе данных PostgreSQL: атрибуты из JSON-объектаchangedAttributesдобавляются к существующим или заменяют их. Параметрserver— URI подключения в форматеpostgres://user:pass@host:port/db. - Синтаксис
PgDirectoryUpdate "dn" {changedAttributes} "server"
PgDirectoryMove
- Назначение
-
Перемещает запись PostgreSQL-справочника.
- Синтаксис
PgDirectoryMove "dn" "newDn" "server"
PgDirectoryRemove
- Назначение
-
Удаляет запись PostgreSQL-справочника.
- Синтаксис
PgDirectoryRemove "dn" "server"
Клиент LDAP
LdapClientSearch
- Назначение
-
Выдаёт записи LDAP-сервера, соответствующие запросу.
- Синтаксис
LdapClientSearch "baseDn" "scope" "deref" "filter" ["field1","field2",...] "attrsonly"|"all" sizeLimit timeLimit "sorting" "cookie" "ldap://user:pass@host:port"
| Параметр | Описание |
|---|---|
|
Базовый DN. |
|
Область поиска: |
|
Разыменование ссылок: |
|
LDAP-фильтр. |
|
Атрибуты результата. |
|
Возвращать только атрибуты или атрибуты и значения. |
|
Максимальное число записей. |
|
Максимальное время выполнения. |
|
Параметры сортировки. |
|
Маркер страницы. |
|
URI LDAP-сервера с параметрами доступа. |
Работа с плагинами
Параметры команд работы с плагинами:
| Параметр | Описание |
|---|---|
|
Тип плагина: |
|
Имя плагина. |
Подробнее о плагинах см. Модуль Менеджер плагинов.
PluginList
- Назначение
-
Выдаёт список плагинов с их настройками и статусом.
- Синтаксис
PluginList
PluginAdd
- Назначение
-
Создаёт плагин указанного типа с указанным именем.
- Синтаксис
PluginAdd "type" "name" {settings}
| Параметр | Описание |
|---|---|
|
Тип плагина: |
|
Имя плагина. |
|
Словарь настроек плагина. |
PluginDel
- Назначение
-
Удаляет плагин указанного типа с указанным именем.
- Синтаксис
PluginDel "type" "name"
PluginStart
- Назначение
-
Запускает плагин указанного типа с указанным именем.
- Синтаксис
PluginStart "type" "name"
PluginStop
- Назначение
-
Останавливает плагин указанного типа с указанным именем.
- Синтаксис
PluginStop "type" "name"
Работа с сессиями
SessionList
- Назначение
-
Выдаёт список сессий. Для каждой сессии выдаются поля:
-
token— токен сессии; -
tsCreated— время создания; -
tsActivity— время последнего обращения; -
remoteAddress— IP-адрес, с которого открыта сессия (если известен); -
clientAddress— IP-адрес клиента за прокси-сервером из заголовкаX-Forwarded-For(если известен); -
authAccount— имя аутентифицированного пользователя (если есть).
Если указан домен, выдаются только сессии аккаунтов этого домена; если указаны домен и аккаунт — только сессии этого аккаунта.
-
- Синтаксис
SessionList ("domName"|domUID ("accName"|accUID))
SessionCreate
- Назначение
-
Создаёт сессию для аккаунта и выдаёт токен сессии. Необязательный параметр
protocolVersionзадаёт версию протокола; по умолчанию используется последняя. - Синтаксис
SessionCreate "domName"|domUID "accName"|accUID (protocolVersion)
SessionClose
- Назначение
-
Закрывает сессию.
- Синтаксис
SessionClose "token"
SessionGetInfo
- Назначение
-
Выдаёт данные сессии.
- Синтаксис
SessionGetInfo "token"
SessionUpdateInfo
- Назначение
-
Дополняет данные сессии с токеном
tokenданными из объектаnewInfo. - Синтаксис
SessionUpdateInfo "token" {newInfo}
SessionSendEvent
- Назначение
-
Отправляет в сессию с токеном
tokenсобытиеevent. - Синтаксис
SessionSendEvent "token" {event}
Работа с точками монтирования
DomainListMounts
- Назначение
-
Выдаёт список точек монтирования домена.
- Синтаксис
DomainListMounts "domName"|domUID
DomainCreateMount
- Назначение
-
Создаёт в домене точку монтирования
name. В кластере дополнительно передаётся фактическое имя каталога точки монтированияpath. - Синтаксис
DomainCreateMount "domName"|domUID "name" ("path")
DomainRemoveMount
- Назначение
-
Удаляет точку монтирования
nameдомена. В точке монтирования не должно быть объектов. В кластере можно передатьtrue, чтобы удалить и каталог точки монтирования. - Синтаксис
DomainRemoveMount "domName"|domUID "name" (true)
ObjectSetMount
- Назначение
-
Переносит каталог объекта домена на точку монтирования
mountNameи выдаёт новый путь к каталогу. ЕслиmountNameне указан, каталог переносится в основной каталог домена. - Синтаксис
ObjectSetMount "domName"|domUID "objName"|objUID ("mountName")
ObjectGetMount
- Назначение
-
Выдаёт имя точки монтирования, на которой хранится каталог объекта. Пустая строка означает, что каталог находится в основном каталоге домена.
- Синтаксис
ObjectGetMount "domName"|domUID "objName"|objUID
DomainListMountObjects
- Назначение
-
Выдаёт список объектов, которые хранятся на точке монтирования
nameдомена. Если указать пустую строку, выдаются объекты, которые хранятся непосредственно в каталоге домена. - Синтаксис
DomainListMountObjects "domName"|domUID "name"
Работа с ресурсными аккаунтами
ResourceGetOwner
- Назначение
-
Выдаёт владельца ресурсного аккаунта, если он задан. Владелец может управлять ресурсом без административных прав.
- Синтаксис
ResourceGetOwner "domName"|domUID "resName"|resUID
ResourceSetOwner
- Назначение
-
Назначает владельца ресурсного аккаунта. Владелец может управлять ресурсом без административных прав.
- Синтаксис
ResourceSetOwner "domName"|domUID "resName"|resUID "addr"
Работа с правилами обработки почты
Первые два параметра команд задают уровень, на котором действует правило:
-
сервер —
nullиnull; -
кластер —
nullи0; -
домен — имя или UID домена и
null; -
аккаунт или другой объект домена — имя или UID домена и имя или UID объекта.
RulesListOptions
- Назначение
-
Выдаёт доступные для правил операции, условия или действия — в зависимости от последнего параметра. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).
Для
actionsExtвыдаётся словарь, где ключ — название действия, а значение:-
null— действие можно сочетать с любыми другими в любом порядке; -
true— завершающее действие: после него другие действия невозможны; -
false— действие нельзя сочетать ни с какими другими.
-
- Синтаксис
RulesListOptions "domName"|domUID|null "objName"|objUID|null "operations"|"conditions"|"actions"|"actionsExt"
RulesList
- Назначение
-
Выдаёт список правил обработки почты. Уровень правила задаётся первыми двумя параметрами (см. начало раздела).
- Синтаксис
RulesList "domName"|domUID|null "objName"|objUID|null
RuleGet
- Назначение
-
Выдаёт настройки правила
ruleName. Уровень правила задаётся первыми двумя параметрами (см. начало раздела). - Синтаксис
RuleGet "domName"|domUID|null "objName"|objUID|null "ruleName"
RuleDel
- Назначение
-
Удаляет правило
ruleName. Уровень правила задаётся первыми двумя параметрами (см. начало раздела). - Синтаксис
RuleDel "domName"|domUID|null "objName"|objUID|null "ruleName"
RuleAdd
- Назначение
-
Создаёт правило
ruleNameс настройками из объектаruleData. Уровень правила задаётся первыми двумя параметрами (см. начало раздела). - Синтаксис
RuleAdd "domName"|domUID|null "objName"|objUID|null "ruleName" {ruleData}
RuleSet
- Назначение
-
Изменяет правило
ruleNameв соответствии с объектомruleData. Чтобы переименовать правило, передайте вruleDataключnameс новым именем. Уровень правила задаётся первыми двумя параметрами (см. начало раздела). - Синтаксис
RuleSet "domName"|domUID|null "objName"|objUID|null "ruleName" {ruleData}
RuleAddVacation
- Назначение
-
Создаёт для аккаунта или домена правило автоответа
ruleNameпо шаблону из настройкиVacationTemplate.-
В период с
startDateпоstopDateправило отвечает на письма текстомmessage. Если дата не указана или пустая, период не ограничен с этой стороны. -
Если задана адресная книга
bookName, адреса, которым отправлен автоответ, добавляются в неё, и повторные письма с этих адресов не обрабатываются. -
Если в
addressesуказаны адреса, дополнительно создаётся правило, которое в тот же период пересылает копии писем на эти адреса.
-
- Синтаксис
RuleAddVacation "domName"|domUID "accName"|accUID "ruleName" "message" "addresses" ("startDate" ("stopDate" ("bookName")))
RuleGetVacation
- Назначение
-
Выдаёт настройки правила автоответа
ruleName. - Синтаксис
RuleGetVacation "domName"|domUID "accName"|accUID "ruleName"
RuleDelVacation
- Назначение
-
Удаляет правило автоответа
ruleName. - Синтаксис
RuleDelVacation "domName"|domUID "accName"|accUID "ruleName"
StringListDump
- Назначение
-
Выдаёт список именованных наборов строк или содержимое набора
listname, если он указан. Уровень правила задаётся первыми двумя параметрами (см. начало раздела). - Синтаксис
StringListDump "domName"|domUID|null "acc.name"|accUID|null ("listname" (true)
Общекластерные настройки
GlobalGetSetting
- Назначение
-
Выдаёт значение общекластерной настройки по ключу или пути из массива ключей.
- Синтаксис
GlobalGetSetting "key"|["key1","key2",..]
GlobalSetSetting
- Назначение
-
Задаёт значение общекластерной настройки по ключу или пути из массива ключей. Если
skipCast—true, новое значение не передаётся на другие узлы кластера. - Синтаксис
GlobalSetSetting "key"|["key1","key2",..] {object} (skipCast)
GlobalDelSetting
- Назначение
-
Удаляет значение общекластерной настройки. Если
skipCast—true, удаление не передаётся на другие узлы кластера. - Синтаксис
GlobalDelSetting "key"|["key1","key2",..] (skipCast)
Работа с хранилищем некорректных файлов
DefectedFileList
- Назначение
-
Выдаёт список файлов в хранилище некорректных файлов.
- Синтаксис
DefectedFileList
DefectedFileGet
- Назначение
-
Выдаёт содержимое файла
nameиз хранилища некорректных файлов в кодировке Base64. - Синтаксис
DefectedFileGet "name"
DefectedFileClear
- Назначение
-
Очищает хранилище некорректных файлов.
- Синтаксис
DefectedFileClear
Работа с белыми и чёрными списками сетевых адресов
GetWhitelisted
- Назначение
-
Выдаёт адреса из белого списка, входящие в указанный блок адресов (в нотации CIDR).
Пример — все адреса белого списка:
GetWhitelisted "0.0.0.0/0" - Синтаксис
GetWhitelisted "ip address/0"
GetBlacklisted
- Назначение
-
Выдаёт адреса из чёрного списка, входящие в указанный блок адресов (в нотации CIDR).
Пример — все адреса чёрного списка:
GetBlacklisted "0.0.0.0/0" - Синтаксис
GetBlacklisted "ip address/0"
SetWhitelisted
- Назначение
-
Добавляет адреса в белый список: в течение интервала, заданного в настройках сервера, они не блокируются. Адреса, которые были в чёрном списке, удаляются из него. Для адресов, которые уже есть в белом списке, срок продлевается.
- Синтаксис
SetWhitelisted "ip address"|["ip address1","ip address2",...]
SetBlacklisted
- Назначение
-
Добавляет адреса в чёрный список: они блокируются на интервал, заданный в настройках сервера. Адреса, которые были в белом списке, удаляются из него. Для адресов, которые уже есть в чёрном списке, срок продлевается.
- Синтаксис
SetBlacklisted "ip address"|["ip address1","ip address2",...]
DelWhitelisted
- Назначение
-
Удаляет адреса из белого списка.
- Синтаксис
DelWhitelisted "ip address"|["ip address1","ip address2",...]
DelBlacklisted
- Назначение
-
Удаляет адреса из чёрного списка.
- Синтаксис
DelBlacklisted "ip address"|["ip address1","ip address2",...]
Работа с календарями
Общие правила для команд раздела:
-
если параметр
calendarMboxName— пустая строка, используется календарь аккаунта по умолчанию; -
даты и время передаются в формате ISO 8601;
-
необязательный параметр
"jump"|"rfc"|"raw"задаёт формат результата.
CalendarUpdate
- Назначение
-
Создаёт или изменяет событие в календаре аккаунта. Событие передаётся объектом VCALENDAR или во внутреннем формате.
Параметр
actionзадаёт действие:-
publish,cancel,accept,decline,tentative,delegate,propose,progress; -
import— сохраняет событие с заменой существующего без дополнительных действий (уведомлений, обновления DTSTAMP и т. п.); -
forward— пересылает сохранённое приглашение на новые адреса, не изменяя календарь.
К действию можно добавить модификатор через
_или пробел, напримерforce_publish:-
force— не проверять версию события (SEQUENCE, DTSTAMP); -
silent— не рассылать уведомления участникам.
Дополнительные параметры в формате
имя=значение:-
delegate=email— адрес, которому делегируется участие; -
progress=число— процент выполнения задачи (100— выполнена); -
conflict=accept|decline|decline_conflicted— как поступать с конфликтующими событиями при принятии приглашения; -
to=email1,email2— адреса для действияforward.
-
- Синтаксис
CalendarUpdate "domName"|domUID "accName"|accUID "calendarMboxName" "calendarObject"|"calendarUID"|msgUID "action"
CalendarSearch
- Назначение
-
Выдаёт события календаря аккаунта за интервал от
fromTimeдоtillTime. Повторяющиеся события разбиваются на отдельные экземпляры по правилам повторения (RRULE). Выдаётся не болееcountBeforeсобытий до моментаreferenceTimeи не болееcountAfter— после него. - Синтаксис
CalendarSearch "domName"|domUID "accName"|accUID "calendarMboxName" "fromTime" "tillTime" "referenceTime" countBefore countAfter ("jump"|"rfc"|"raw")
CalendarShow
- Назначение
-
Выдаёт событие календаря по его UID или по номеру письма
msgUIDв том виде, в котором оно хранится. - Синтаксис
CalendarShow "domName"|domUID "accName"|accUID "calendarMboxName" "calendarUID"|msgUID ("jump"|"rfc"|"raw")
CalendarSetAlarm
- Назначение
-
Заменяет напоминания события на переданные в параметре
alarm(сокращённый VCALENDAR с VALARM или внутренний формат). Если передать пустой список, напоминания события удаляются. - Синтаксис
CalendarSetAlarm "domName"|domUID "accName"|accUID "calendarMboxName" "calendarUID" "calendar_recurrence" "alarm"
CalendarNextAlarm
- Назначение
-
Выдаёт ближайшее напоминание о событии в календаре. Если
fromTimeпустой, поиск начинается с текущего момента. ЕслиcalendarUIDпустой, ищется ближайшее напоминание среди всех событий. - Синтаксис
CalendarNextAlarm "domName"|domUID "accName"|accUID "calendarMboxName" "[fromTime]" "[calendarUID]"
CalendarFreeBusy
- Назначение
-
Выдаёт периоды занятости аккаунта за интервал от
fromTimeдоtillTime. Интервал должен лежать в пределах от текущего момента до 30 дней вперёд. Обязательный параметрaccessorMail— адрес аккаунта, от имени которого выполняется запрос; пустая строка — анонимный запрос. - Синтаксис
CalendarFreeBusy "domName"|domUID "accName"|accUID "fromTime" "tillTime" "accessorMail" ("jump"|"rfc"|"raw")
CalendarProposal
- Назначение
-
Принимает (
accept) или отклоняет (decline) предложение по событиюcalendarUID. Предложение хранится в письмеproposal_msgUIDв папкеproposalMboxName;recurrenceIDуказывает экземпляр повторяющегося события. - Синтаксис
CalendarProposal "domName"|domUID "accName"|accUID "proposalMboxName" proposal_msgUID "calendarMboxName" "calendarUID" "recurrenceID" "accept|decline"
CalendarListUids
- Назначение
-
Выдаёт UID всех событий календаря аккаунта.
- Синтаксис
CalendarListUids "domName"|domUID "accName"|accUID "calendarMboxName"
TimeZoneList
- Назначение
-
Выдаёт список часовых поясов, известных серверу.
- Синтаксис
TimeZoneList
Работа с контактами
Общие правила для команд раздела:
-
если параметр
contactsMboxName— пустая строка, используется адресная книга аккаунта по умолчанию; -
параметр
"jump"|"rfc"|"raw"задаёт формат результата.
ContactsUpdate
- Назначение
-
Создаёт или изменяет контакт в адресной книге аккаунта. Контакт передаётся объектом в формате vCard (RFC) или JUMP.
- Синтаксис
ContactsUpdate "domName"|domUID "accName"|accUID "contactsMboxName" "contactsObject"
ContactsSearch
- Назначение
-
Выдаёт контакты аккаунта, соответствующие запросу
searchUri, — не болееmaxCountзаписей.Формат запроса (все поля необязательны):
vcard://?uid=<uid>&fn=<fn_part>&email=<email_part>&title=<title_part>&name=<name_part> - Синтаксис
ContactsSearch "domName"|domUID "accName"|accUID "contactsMboxName" "searchUri" maxCount "jump"|"rfc"|"raw"
ContactsRemove
- Назначение
-
Удаляет контакт из адресной книги аккаунта по UID vCard или по номеру письма
msgUID, в котором хранится контакт. - Синтаксис
ContactsRemove "domName"|domUID "accName"|accUID "contactsMboxName" "vcardUID"|msgUID
Работа с полнотекстовым поиском
FullTextSearch
- Назначение
-
Ищет письма в папке аккаунта
mboxNameпо полнотекстовому индексу и выдаёт UID писем, которые содержат слова из запросаquery. Необязательный массив задаёт поля поиска:Body,Attachment,Subject,From,To,Cc,Bcc; по умолчанию поиск ведётся по всем полям. - Синтаксис
FullTextSearch "domName"|domUID "accName"|accUID "mboxName" "query" (["field1","field2",...])
FTIndexSync
- Назначение
-
Синхронизирует полнотекстовые индексы папок аккаунта
user@domain, всех аккаунтов доменаdomainили всего сервера (*). Отсутствующие индексы создаются, недостающие письма индексируются, а записи об удалённых письмах удаляются из индекса. - Синтаксис
FTIndexSync "*"|"domain"|"user@domain"
GlobalSearchMail
- Назначение
-
Ищет письма по всей системе. Параметры поиска передаются словарём
params. - Синтаксис
GlobalSearchMail { params }
Работа с профилями SMTP-Input
SMTPIProfilesList
- Назначение
-
Выдаёт профиль SMTP-Input
nameили все профили, если имя не указано. Если указатьtrue, в результат включаются описания полей; еслиfalse— результат не содержит значений по умолчанию. - Синтаксис
SMTPIProfilesList ("name") (true|false)
SMTPIProfilesUpdate
- Назначение
-
Изменяет профили SMTP-Input. Действие зависит от параметров:
-
param1— словарь: заменяет все профили; -
param1— строка,param2— словарь: заменяет профильparam1наparam2; -
param1— строка,param2—null: удаляет профильparam1; -
param1иparam2— строки,param3— словарь: заменяет в профилеparam1элементparam2наparam3; -
param1иparam2— строки,param3—null: удаляет в профилеparam1элементparam2.
-
- Синтаксис
SMTPIProfilesUpdate param1 (param2 (param3))
Работа с профилями SMTP-Output
SMTPOProfilesList
- Назначение
-
Выдаёт все профили SMTP-Output (без унаследованных значений по умолчанию) или профиль
name(с унаследованными значениями). Если указатьtrue, в результат включаются описания полей; еслиfalse— результат не содержит значений по умолчанию. - Синтаксис
SMTPOProfilesList ("name") (true|false)
SMTPOProfilesUpdate
- Назначение
-
Изменяет профили SMTP-Output. Действие зависит от параметров:
-
param1— словарь: заменяет все профили (словарь должен быть в формате, который ожидает сервер); -
param1— строка,param2— словарь: заменяет профильparam1наparam2; -
param1— строка,param2—null: удаляет профильparam1; -
param1иparam2— строки,param3— объект настроек: заменяет в профилеparam1элементparam2наparam3; -
param1иparam2— строки,param3—null: удаляет в профилеparam1элементparam2.
-
- Синтаксис
SMTPOProfilesUpdate param1 (param2 (param3))
Работа со списками адресов
AddressListCheck
- Назначение
-
Проверяет, входит ли IP-адрес в список адресов, переданный текстом. Результат:
-
1— адрес входит в список; -
0— не входит; -
-1— исключён из списка; -
-2— ошибка: неизвестный вложенный список; -
-3— ошибка: слишком глубокая вложенность списков.
При неверном формате адреса возвращается ошибка
500 Bad format for an IP address.Примеры:
AddressListCheck "10.0.0.1" "#NATed\n!10.0.0.2" AddressListCheck "178.177.53.210" "#@*iva.ru" -
- Синтаксис
AddressListCheck "IP address" "address list as text"
AddressListGet
- Назначение
-
Выдаёт список адресов с указанным именем или все именованные списки, если имя не указано.
Служебные списки не выводятся в общем перечне, но их можно получить и изменить по имени:
-
$BLOCKED— заблокированные адреса; -
$UNBLOCKABLE— неблокируемые адреса (белый список); -
$DEBUG— адреса с включённой отладкой.
Пример:
AddressListGet "LAN" -
- Синтаксис
AddressListGet ("list name")
AddressListUpdate
- Назначение
-
Изменяет списки адресов:
-
словарь
lists— заменяет все именованные списки; -
имя списка и строка
data— заменяет содержимое списка; -
имя списка и
null— удаляет список.
Пример:
AddressListUpdate "LAN_2" "10.1.1.0/8 ; сегмент2\n!10.1.1.2 ; исключение" -
- Синтаксис
AddressListUpdate {lists}|"list name" ("data"|null)
Работа с настройками федеративного доступа
FederatedSharingList
- Назначение
-
Выдаёт набор настроек федеративного доступа
nameили все наборы, если имя не указано. - Синтаксис
FederatedSharingList ("name") (true|false)
FederatedSharingUpdate
- Назначение
-
Изменяет настройки федеративного доступа. Действие зависит от параметров:
-
param1— словарь: заменяет все наборы настроек; -
param1— строка,param2— словарь: заменяет наборparam1наparam2; -
param1— строка,param2—null: удаляет наборparam1; -
param1иparam2— строки,param3— словарь: заменяет в набореparam1элементparam2наparam3; -
param1иparam2— строки,param3—null: удаляет в набореparam1элементparam2.
-
- Синтаксис
FederatedSharingUpdate param1 (param2 (param3))
Работа с планировщиком задач
TaskSchedule
- Назначение
-
Добавляет задание в планировщик.
-
objectId— объект задания:"*"(сервер), домен, аккаунт или=objUID@=domUID; -
action— название действия; -
deadline— время выполнения; -
period— необязательный интервал повторения; -
args— необязательный аргумент действия (любой объект).
Примеры:
TaskSchedule "postmaster@ivamail.local" "WriteToLog" "\/T 2025-08-27T11:00:00.000Z" "\/D 10m" TaskSchedule "*" "Maintenance" "\/T 2025-09-26T01:00:00.000Z" "\/D 24h" -
- Синтаксис
TaskSchedule "objectId" "action" "deadline" ("period") ("args")
TaskCancel
- Назначение
-
Удаляет задание
uidиз планировщика. - Синтаксис
TaskCancel "uid"
TasksList
- Назначение
-
Выдаёт список запланированных заданий.
-
bInCluster—true: кластерный планировщик,false: планировщик сервера; -
fromTime— необязательное время, начиная с которого выдаются задания; -
maxCount— необязательное максимальное количество заданий.
Пример:
TasksList false "\/T 2025-08-27T11:00:00.000Z" 100 -
- Синтаксис
TasksList bInCluster ("fromTime" ("maxCount"))
Работа с отложенными почтовыми отправлениями
DeferredDeliveryPlan
- Назначение
-
Планирует отправку письма
messageIDна времяdelayTill. После успешной отправки письмо перемещается в папкуtargetMbox; если папка не указана, письмо не сохраняется. - Синтаксис
DeferredDeliveryPlan "domName"|domUID "accName"|accUID delayTill "messageID" "targetMbox"
DeferredDeliveryList
- Назначение
-
Выдаёт сведения об отложенных письмах аккаунта (не более 100).
- Синтаксис
DeferredDeliveryList "domName"|domUID "accName"|accUID
DeferredDeliverySend
- Назначение
-
Управляет отложенным письмом
messageIDв зависимости от параметраmode:-
later— переносит отправку на времяdeadline(оно должно быть позже текущего); -
now— отправляет письмо немедленно; -
never— отменяет отправку.
-
- Синтаксис
DeferredDeliverySend "domName"|domUID "accName"|accUID "messageID" "mode" ("deadline")
Маршрутизация
RouteAddress
- Назначение
-
Проверяет маршрутизацию адреса и выдаёт результат: домен, объект и папку, тег, возможность ретрансляции и внешний маршрут. Необязательный параметр
modeзадаёт таблицу маршрутизатора,noextотключает вывод внешних маршрутов. - Синтаксис
RouteAddress "address@string" (mode (noext))
RouterGetTable
- Назначение
-
Выдаёт текст таблицы маршрутизатора:
mode—0для почты,1для доступа. Если указанnull, выдаётся общекластерная таблица. - Синтаксис
RouterGetTable mode (null)
RouterSetTable
- Назначение
-
Заменяет таблицу маршрутизатора
modeтекстомtabletextи применяет её. Если указанnull, заменяется общекластерная таблица. - Синтаксис
RouterSetTable mode "tabletext" (null)
DNS-резолвер
ResolverGetServers
- Назначение
-
Выдаёт список DNS-серверов, настроенных на сервере.
- Синтаксис
ResolverGetServers
ResolverQuery
- Назначение
-
Выполняет DNS-запрос записи типа
recordType(A,AAAA,MX,TXT,NS,CNAME,PTR) для имени или адресаdomName. - Синтаксис
ResolverQuery "domName" "recordType"
Работа с кластером
Команды раздела используются для диагностики кластера и вывода узлов из его состава.
ClusterGetImage
- Назначение
-
Выдаёт текущее состояние кластера (образ кластера) со сведениями обо всех узлах.
- Синтаксис
ClusterGetImage
ClusterLockList
- Назначение
-
Выдаёт список блокировок объектов домена
domUID; если указанaccUID— только для этого объекта. - Синтаксис
ClusterLockList (domUID (accUID))
ClusterMLockList
- Назначение
-
Выдаёт блокировки, которые удерживает узел
memberUID. Результат можно ограничить доменомdomUIDи объектомaccUID. - Синтаксис
ClusterMLockList (memberUID (domUID (accUID)))
ClusterGetStats
- Назначение
-
Выдаёт статистику по узлам кластера: число объектов и подключений.
- Синтаксис
ClusterGetStats
ClusterLeave
- Назначение
-
Выводит текущий узел из кластера: узел переходит в режим офлайн. Роль диспетчера при этом может перейти к резервному узлу.
- Синтаксис
ClusterLeave
ClusterExclude
- Назначение
-
Исключает узел
memberUIDиз кластера. - Синтаксис
ClusterExclude memberUID
Лицензии
LicenseRequest
- Назначение
-
Формирует запрос на лицензию, подписанный ключом сервера, и сохраняет его в файл
fileили выдаёт в формате PEM. Словарьobjectсодержит данные запроса: название организации, количество аккаунтов и т. п. - Синтаксис
LicenseRequest "file" {object}
LicenseInstall
- Назначение
-
Проверяет и устанавливает лицензию из файла, строки PEM или словаря. В кластере лицензия передаётся диспетчеру.
- Синтаксис
LicenseInstall "file"|"pem"|object