Создает объект администрирования сервера.
Синтаксис
Новый АдминистрированиеСервера(<АдресАгента>, <Порт>)Полное описание, параметры и ограничения
АдминистрированиеСервера.По умолчанию
АдминистрированиеСервера (ServerAdministration)
По умолчанию
Доступен, начиная с версии 8.3.14.
Синтаксис:
Новый АдминистрированиеСервера(<АдресАгента>, <Порт>)
Параметры:
<АдресАгента> (необязательный)
Тип: Строка.
Имя (символический или IP-адрес) компьютера, на котором расположен сервис ras.
<Порт> (необязательный)
Тип: Число.
Порт, на котором расположен сервис ras.
Описание:
Создает объект администрирования сервера.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
RAS: записать и удалить своё требование назначения
Берём настоящее требование своего рабочего сервера. Запись и удаление меняют правила размещения, а не только локальную структуру.
Где и как запускать
Синтаксис в своей административной форме тонкого или толстого клиента либо серверном модуле. Соединение RAS относится только к выделенному собственному учебному серверу. Здесь соединения и изменения не выполнялись.
Подготовка
Подготовьте собственный отдельный учебный сервер 1С с RAS по 127.0.0.1:1545 и ровно одним своим кластером. Не направляйте пример на сервер рабочих пользователей.
В административной форме задайте строковые реквизиты ИмяАгента, ПарольАгента, ИмяАдминистратораКластера и ПарольКластера. Пароли вводятся в режиме пароля и не выводятся в сообщения. RAS аутентифицирует агента в порядке пароль, имя, а кластер — имя, пароль.
Подготовьте свой рабочий сервер УчебныйРабочийСервер с одним специально созданным ненужным требованием и своей ИБ УчебнаяБаза.
Сервер = Новый АдминистрированиеСервера("127.0.0.1", 1545);
Сервер.ВыполнитьАутентификацию(ПарольАгента, ИмяАгента);
Кластеры = Сервер.ПолучитьКластеры();
Если Кластеры.Количество() <> 1 Тогда
ВызватьИсключение "Нужен ровно один собственный учебный кластер";
КонецЕсли;
Кластер = Кластеры[0];
Кластер.ВыполнитьАутентификацию(ИмяАдминистратораКластера, ПарольКластера);
РабочийСервер = Неопределено;
Для Каждого Кандидат Из Кластер.ПолучитьРабочиеСерверы() Цикл
Если Кандидат.Имя = "УчебныйРабочийСервер" Тогда
РабочийСервер = Кандидат;
Прервать;
КонецЕсли;
КонецЦикла;
Если РабочийСервер = Неопределено Тогда
ВызватьИсключение "Свой учебный рабочий сервер не найден";
КонецЕсли;
Требования = РабочийСервер.ПолучитьТребованияНазначения();
Если Требования.Количество() <> 1 Тогда
ВызватьИсключение "Подготовьте одно собственное учебное требование";
КонецЕсли;
Требование = Требования[0];
Требование.ИмяИнформационнойБазы = "УчебнаяБаза";
Требование.Записать();
Требование.Удалить();
Сообщить("Вызваны запись и удаление своего учебного требования");Разбор по шагам
Получите реальный рабочий сервер через собственный кластер.
Укажите свою учебную ИБ и сохраните требование.
В отдельном согласованном опыте удалите это же собственное требование.
Как проверить результат
Массив требований должен содержать только одно подготовленное собственное правило.
Изменение списка правил проверяется отдельным повторным чтением, не сообщением после вызова.
Ожидаемый результат
Это короткий синтаксический пример для указанного учебного стенда. Здесь он не выполнялся; сообщение после вызова не заменяет отдельную проверку фактического состояния.
На что обратить внимание
Это последовательность реальных изменений при будущем выполнении, не транзакция и не обещание отката.
Запись требования не заменяет ПринятьТребованияНазначения; применение показано отдельно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
RAS: записать и удалить отдельного учебного администратора
Меняем описание специально подготовленной ненужной учётной записи, не текущего администратора соединения.
Где и как запускать
Синтаксис в своей административной форме тонкого или толстого клиента либо серверном модуле. Соединение RAS относится только к выделенному собственному учебному серверу. Здесь соединения и изменения не выполнялись.
Подготовка
Подготовьте собственный отдельный учебный сервер 1С с RAS по 127.0.0.1:1545 и ровно одним своим кластером. Не направляйте пример на сервер рабочих пользователей.
В административной форме задайте строковые реквизиты ИмяАгента, ПарольАгента, ИмяАдминистратораКластера и ПарольКластера. Пароли вводятся в режиме пароля и не выводятся в сообщения. RAS аутентифицирует агента в порядке пароль, имя, а кластер — имя, пароль.
Заранее вручную создайте своего УчебныйУдаляемыйАдминистратор. Для подключения используйте другую сохранённую административную учётную запись.
Сервер = Новый АдминистрированиеСервера("127.0.0.1", 1545);
Сервер.ВыполнитьАутентификацию(ПарольАгента, ИмяАгента);
Для Каждого Администратор Из Сервер.ПолучитьАдминистраторов() Цикл
Если Администратор.Имя = "УчебныйУдаляемыйАдминистратор" Тогда
Администратор.Описание = "Отдельный учебный опыт";
Администратор.Записать();
Администратор.Удалить();
Сообщить("Вызваны запись и удаление отдельной учебной записи");
КонецЕсли;
КонецЦикла;Разбор по шагам
Получите реальных администраторов своего сервера.
Измените описание только явно названной учебной записи.
После согласования удалите эту же отдельную запись.
Как проверить результат
Текущая учётная запись подключения не должна иметь указанное имя.
Если запись не найдена, запись и удаление не выполняются.
Ожидаемый результат
Это короткий синтаксический пример для указанного учебного стенда. Здесь он не выполнялся; сообщение после вызова не заменяет отдельную проверку фактического состояния.
На что обратить внимание
Удаление лишает эту учётную запись административного доступа; автоматическое восстановление не обещается.
Две операции не атомарны.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.