Позвоните нам: 8 800 505 2228 (Бесплатный звонок по всей России)

Инструменты. Утилита для командной строки BCSCmd.exe

Сервер Bopup Communication Server включает утилиту для командной строки BCSCmd.exe, с помощью которой возможно отправлять Новостные сообщения, доставлять мгновенные сообщения пользователям, отсылать широковещательные сообщения на группы, создавать резервные копии (backup) SQL базы данных, а так же обновлять и импортировать пользователей из Active Directory каталога используя интерфейс командной строки. Данная утилита может быть запущена из различных сторонних приложений, скриптов или исполняемых файлов.

Файл BCSCmd.exe устанавливается совместно с программным продуктом Bopup Communication Server и расположен в папке установки сервера. Для отправки сообщений из командной строки должны быть указаны необходимые параметры и аргументы включая имена учетных записей пользователей, групп и/или Новостей, на которые идет отправка данных, а также сам текст сообщения. Для показа поддерживаемых аргументов командной строки запустите утилиту BCSCmd.exe с параметром /? или /h или же без указания каких бы то ни было параметров.


Используйте следующие ключи для запуска программы из интерфейса командной строки:

bcscmd.exe [КЛЮЧИ]
/N <новость>        - Имя существующего Новостного сообщения для отправки.
/G <группа>         - Имя существующей группы для отправки сообщения.
/U <пользователь>   - Имя учетной записи пользователя для отправки сообщения.
/M <"сообщение">    - Текст сообщения для отправки (для ключей /G, /U, /A).
/A                  - Отправить сообщение всем пользователям на сервере.
/OFFLINE            - Позволить сохранение сообщения на сервере как офлайн
                      (для ключей /G, /U, /A).
/URGENT             - Доставить сообщение как важное (для ключей /G, /U, /A).
/DB <"путь">        - Создать резервную копию SQL базы данных сохранив
                      в указанной папке/файле.
/LDAP [update|sync|syncall] [bygroups]
                    - Импортировать/обновить учетные записи пользователей
                      из каталога Active Directory.

Утилита для командной строки Bopup Communication Server версии x.x.xx.xxxx.
(C) 2000– B Labs. Все права защищены.


Следуйте нижеприведенным правилам при вызове утилиты из командной строки:

  • Если имя Новостного сообщения или группы содержит знак пробела (состоит из нескольких слов), тогда помещайте имя в двойные скобки;
  • Ключи /M, /URGENT и /OFFLINE применяются только при отправке сообщений пользователям и на группы. Указанные ключи игнорируются при отправке Новостных сообщений или при создании резервных копий базы данных;
  • Путь при использовании ключа /DB может быть директорией или конечным файлом. В случае указания директории утилита создаст в папке файл с именем в формате bcs-ГГГГММДД-ВРЕМЯ.backup, включающий текущий год, месяц, день, часы и минуты, например bcs-20181105-1924.backup.
  • Параметр /LDAP update только обновляет существующие учетные записи пользователей на сервере сообщений, ключ /LDAP sync добавляет новых пользователей найденные в Active Directory и ключ /LDAP syncall добавляет новые и отключает все существующие учетные записи на сервере, которые не были найдены в каталоге. Используйте параметр bygroups для поиск и импорта пользователей по LDAP Группам (по-умолчанию используется критерий по Подразделениям).
  • Если соедиенения с каталогом Active Directory должно быть установлено используя отличный от текущей учетной записи пользователей и/или используя определенный OU контейнер, в таком случае используются данные введенные в диалоге Интеграция с Active Directory (LDAP) (даже в случае, если эта функция не используется).


Примеры:

Этот пример показывает инициирование немедленной отправки Новостного сообщения с именем "News1" с сервера сообщений:

bcscmd.exe /N News1


Этот пример показывает отправку мгновенного сообщения сразу нескольким пользователям с указанием текста, параметра офлайн доставки и приоритета сообщения:

bcscmd.exe /U administrator /U guest /U sergey /M "Это сообщение было отправлено из командной строки" /URGENT /OFFLINE


Этот пример показывает одновременную отправку сообщения пользователю, на группу и инициирование немедленной отправки указанного Новостного сообщения:

bcscmd.exe /U administrator /G Group1 /M "Это сообщение отправлено пользователям и на группы" /N News2


Этот пример показывает отправку сообщения всем пользователям, которые в настоящий момент подключены к серверу сообщений:

bcscmd.exe /A /M "Это сообщение отправлено только онлайн пользователям"


Данный пример создает резервную копию SQL базы данных в указанной директории:

bcscmd.exe /DB "C:\Temp"


Этот ключ обновляет существующие учетные записи пользователей по критерию Группы и назначает/удаляет их из связанных LDAP групп (если таковые найдены) на сервере сообщений:

bcscmd.exe /LDAP update bygroups


Запуск с данными параметрами обновляет существующие учетные записи по критерию Подразделения, перемещает из в новые связанные Подразделения (если таковые найдены) и назначает/удаляет их из связанных LDAP групп (если таковые найдены) на сервере сообщений.

bcscmd.exe /LDAP update


Пример запуска утилиты с поиском пользователей по критерию Подразделения для добавления новых учетных записей и отключения существующих на сервере сообщений, если таковые не были найдены в каталоге Active Directory:

bcscmd.exe /LDAP syncall


Функциональность создания резервной копии базы данных сервера мгновенных сообщений доступна только при использовании сервера Microsoft SQL Server.