Инструменты. Утилита для командной строки 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 базы данных сохранив                       в указанной папке/файле. /PWD <пароль>       - Пароль для авторизации с удаленным сервером.                       Не используется при соединении с локальным сервером. /LDAP [update|sync|syncall] [bygroups] [createunits] [creategroups] <имена>                     - Импортировать/обновить учетные записи пользователей                       из каталога Active Directory. Утилита для командной строки Bopup Communication Server версии x.x.xx.xxxx.

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

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

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

bcscmd.exe /LDAP sync bygroups createunits group-first,admins,group-last

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