Общие параметры командной строки

Указание свойств подключения

/F <путь> — путь к информационной базе, если она хранится в файле 1Cv8.1CD (имя файла указывать не надо).

/S <адрес> — адрес информационной базы, хранящейся на сервере "1С:Предприятия 8", складывается следующим образом:

<Имя компьютера, работающего сервером приложений>\ <Ссылочное имя информационной базы, известное в рамках сервера "1С:Предприятия 8">

/WS <url> — строка ws-соединения.

/IBName <имя информационной базы> — запуск информационной базы по имени базы в списке информационных баз. При необходимости имя должно быть взято в двойные кавычки. При этом, если имя содержит двойные кавычки, то нужно заменить каждые двойные кавычки на две двойные кавычки. Если в списках баз будет найдено более чем одна база с указанным именем, то пользователю будет выдана ошибка.

/IBConnectionString — позволяет задать строку соединения с информационной базой целиком в том виде, в котором ее возвращает функция СтрокаСоединенияИнформационнойБазы(). Части строки соединения могут быть переопределены параметрами /S и /F. Для этого нужно, чтобы /IBConnectionString находился в командной строке раньше них. Передавая строку соединения в качестве параметра командной строки, нужно помнить о том, что строка соединения содержит кавычки. Поэтому требуется взять всю строку в кавычки, а содержащиеся внутри кавычки удвоить.

Дополнительные параметры строки соединения в режиме тонкого клиента:

wsn — имя пользователя для аутентификации на веб-сервере;
wsp — пароль пользователя для аутентификации на веб-сервере;
wspauto — использовать автоматические настройки прокси сервера;
wspsrv — адрес прокси сервера;
wspport — порт прокси;
wspuser — имя пользователя для прокси с авторизацией;
wsppwd — пароль для прокси с авторизацией.

/O <скорость соединения> — определяет скорость соединения (используется в тонком клиенте):

 Normal — обычная,
 Low — низкая скорость соединения.

Наверх

Настройка аутентификации 

/N <имя> — имя пользователя. Должно быть указано так же, как в списке пользователей, создаваемом в Конфигураторе.

/P <пароль> — пароль пользователя, имя которого указано в параметре /N. Если у пользователя нет пароля, этот параметр можно опустить.

/WA[+/-] — определяет режим использования аутентификации операционной системы при запуске "1С:Предприятия". Если параметр /WA не указывается, то подразумевается, что используется параметр командной строки /WA+.

/WA- — запрет применения аутентификации операционной системы при старте "1С:Предприятия".

/WA+ — установка обязательного применения аутентификации операционной системы при старте "1С:Предприятия".

/SAOnRestart — указывает на обязательность запроса пароля при перезапуске системы из данного сеанса работы (не используется в тонком клиенте). По умолчанию пароль не запрашивается.

/WSA[+/-] — определяет режим использования аутентификации операционной системы на веб-сервере. Если параметр /WSA не указывается, то подразумевается, что используется параметр командной строки WSA+.

/WSA- — запрет применения аутентификации пользователя на веб-сервере.

/WSA+ — установка применения аутентификации пользователя на веб-сервере. Используется аутентификация средствами операционной системы.

/WSN <имя> — имя пользователя для аутентификации на веб-сервере в случае указания параметра /WSA+.

/WSP <пароль> — пароль пользователя, имя которого указано в параметре /WSN, для аутентификации на веб-сервере.

/AppAutoCheckVersion[+/-]  — определяет использование подбора нужной версии для каждой базы:

/AppAutoCheckVersion- — автоматический подбор версии платформы не выполняется.

/AppAutoCheckVersion+ — автоматический подбор версии платформы выполняется выполняется для каждой базы (по умолчанию).

/AppAutoCheckMode автоматическое определение приложения на основе данных информационной базы (основного режима запуска для конфигурации и режима запуска для пользователя).

/NoProxy — запретить использование прокси (только для ws-соединения тонкого клиента).

/Proxy -PSrv <адрес прокси> -PPort <порт> [-PUser <имя пользователя прокси> [-PPwd <пароль>] ] — использовать указанные настройки прокси, игнорируя умолчания (только для ws-соединения) (используется только в тонком клиенте). Например: /Proxy -PSrv 192.168.0.10 -PPort 3128.

/LogUI — логирование действий пользователя.

/OIDA[+/-] — применение сквозной аутентификации пользователя между разными информационными базами и/или внешними ресурсами. (Используется только для тонкого и веб-клиентов!) :

/OIDA+ — использовать OpenID-аутентификацию (по умолчанию). 

/OIDA- — не использовать OpenID-аутентификацию.

Если при запуске клиента параметр OIDA не задан, или задан параметр OIDA+, то производится попытка аутентификации через OpenID-провайдера, адрес которого задан в файле deafault.vrd публикации этой информационной базы.

Если OpenID-провайдер требует интерактивной аутентификации (происходит первое обращение или истекло время жизни признака аутентифицированности), клиент отображает диалог для ввода имени и пароля пользователя.

Аутентификация происходит по списку пользователей информационной базы OpenID-провайдера.

Аутентифицируемый пользователь информационной базы, использующих OpenID-аутентификацию, должен соответствовать по имени пользователю информационной базы OpenID-провайдера.

/Authoff выполняет OpenID logout (завершение сеанса работы пользователя). Завершение сеанса работы выполняется вне зависимости от используемого в дальнейшем метода аутентификации.

Наверх

Поиск локального ключа защиты

/UseHwLicenses[+/-] — определяет режим поиска локального ключа защиты.

/UseHwLicenses+ — поиск локального ключа защиты выполняется.

/UseHwLicenses- — поиск локального ключа защиты не выполняется.

Наверх

Настройки локализации

/L <код языка> — указывается код языка интерфейса платформы. Поддерживаемые языки интерфейса:

Язык

Код
Азербайджанский az
Английский en
Болгарский bg
Венгерский hu
Вьетнамский vi
Грузинский ka
Казахский kk
Китайский zh
Латышский lv
Литовский lt
Немецкий de
Польский pl
Румынский ro
Русский ru
Турецкий tr
Украинский uk
Французский fr

/VL <код локализации сеанса> — указывается код локализации сеанса, используемый при форматировании данных типа Число и Дата, а также в методах ЧислоПрописью() и ПредставлениеПериода().

Наверх

Настройка интерфейса (Только для управляемого приложения)

/iTaxi — Запуск в режиме интерфейса "Такси".

/itdi — Запуск в режиме интерфейса с использованием закладок.

/isdi — Запуск в режиме интерфейса с использованием отдельных окон (используется по умолчанию). 

/DisplayAllFunctions — включает команду меню "Все функции".

Наверх

Отладчик и показатели производительности

/Debug — указывает, что запуск 1С:Предприятия выполняется в отладочном режиме.

/DebuggerURL <URL отладчика> — идентификация отладчика, к которому приложение сразу после запуска должно подключиться. Указывается URL отладчика (протокол, компьютер и номер порта), на котором в отладчике можно создавать удаленные объекты.

/DisplayPerformance — показать количество вызовов сервера и объем данных, отправляемых на сервер и принимаемых с сервера.

/SimulateServerCallDelay [-CallXXXXX] [-SendYYYYY] [-ReceiveZZZZZ] — имитация работы клиента в условиях медленного соединения.

-Call — указывает величину задержки (XXXXX) при вызове сервера в секундах, если не указан, то 4.45 с;
-Send — указывает величину задержки (YYYYY) в секундах в расчете на каждые 1 Кбайт данных, отправляемых на сервер. Если не указан, то 0.45 с;
-Receive — указывает величину задержки (ZZZZZ) в секундах в расчете на каждые 1 Кбайт данных, принятых с  сервера. Если не указан, то 0,15 с.

Максимальное значение временных задержек — 10 сек.

Пример: /SimulateServerCallDelay -Call2.1 -Send1.3 -Receive1.2

Наверх

Автоматизированное тестирование

/TestManager — запуск толстого и тонкого клиента для управления другими клиентами с помощью специализированной объектной модели.

/TestClient [-TPort<Номер TCP-порта>] — запуск толстого и тонкого клиента как управляемого другими клиентами с помощью менеджера тестирования.

-TPort<Номер TCP-порта> указывает номер порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538.

/UILOGRECORDER [–TPort<Номер порта TCP/IP>] [-File<Путь>]  — запись журнала интерактивных действий пользователя и формирование на их основе сценария на встроенном языке "1С:Предприяти"е, позволяющего воспроизводить записанные действия. Может совмещаться с параметром /TESTCLIENT.

-TPort<Номер TCP-порта> указывает номер порта для взаимодействия клиента и менеджера тестирования. По умолчанию используется порт 1538.

-File<Путь> имя файла, в который будет сохраняться журнал действий пользователя после завершения записи, если к клиенту не подключён менеджер тестирования.

Наверх

Использование клиентских сертификатов (только для тонкого клиента)

/HttpsCert [-windows] [-recent] [-auto] [-choose] [-file <path>] [-pwd <password>] [-none] — указывает источник клиентского сертификата. Если данный параметр не указан, то источник клиентского сертификата определяется настройками диалога настройки соединения с информационной базой.  (Используется только в тонком клиенте!)

-windows — указывает, что при соединении нужно использовать клиентский сертификат из системного хранилища сертификатов операционной системы Microsoft Windows. Данная опция игнорируется, если установленовлена хотя бы одна из опций -file или –none.

-recent — выбирать или использовать ранее выбранный клиентский системный сертификат Microsoft Windows.

Если в системном хранилище пользовательских сертификатов присутствует более одного подходящего сертификата, то пользователю предоставляется выбор используемого сертификата через системный диалог выбора сертификата. В дальнейшем выбранный сертификат используется автоматически.

Данный способ выбора клиентского сертификата выбран по умолчанию для опции -windows, если опции -auto и -choose не установлены. Данный параметр игнорируется.

-auto — использовать автоматически выбранный клиентский сертификат из установленных в системном хранилище сертификатов операционной системы Microsoft Windows. Данный параметр игнорируется, если у параметра отсутствует опция –windows.

-choose — всегда выбирать используемый клиентский сертификат Microsoft Windows.

Если в системном хранилище пользовательских сертификатов присутствует более одного подходящего сертификата, то пользователю предоставляется выбор используемого сертификата через системный диалог выбора сертификата независимо от того, был ли ранее выбран какой-либо сертификат. Выбранный сертификат в дальнейшем может использоваться автоматически с опцией –recent.

Данную опцию можно указать, если необходимо избежать автоматического использования ранее выбранного клиентского сертификата из системного хранилища сертификатов операционной системы Microsoft Windows, и выбрать новый сертификат из установленных в системе сертификатов подходящих для данного соединения. Данный параметр игнорируется, если у параметра отсутствует опция -windows или установлена опция -auto.

-file <path> — указывает, что необходимо использовать клиентский сертификат и приватный ключ из указанного файла. Данный параметр игнорируется, если у параметра установлена опция -none.

-pwd <password> — указывает пароль файла, содержащего клиентский сертификат и его приватный ключ. Если сервер требует предоставления клиентского сертификата и файл сертификата защищен паролем, то соединение возможно только при правильно указанном пароле. Данная опция игнорируется, если у данного параметра не указана опция -file.

-none — указывает, что клиентский сертификат не используется. Соединение возможно только с серверами, не требующими проверки клиентского сертификата.

Если ни одна из опций -windows, -file или -none не установлена, то параметр /HttpsCert игнорируется.

/HttpsCA [-windows] [-file <path>] [-pwd <password>] [-none] — указывает источник CA сертификатов, используемых для проверки сертификата сервера.  Если данный параметр не указан, то источник сертификатов CA  определяется настройками диалога настройки соединения с информационной базой. (Используется только в тонком клиенте!)

-windows — указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты CA из системного хранилища сертификатов операционной системы Microsoft Windows. Данный параметр игнорируется, если установлена хотя бы одна из опций параметра -file или -none.

-file <path> — указывает, что для проверки сертификата сервера при соединении нужно использовать сертификаты CA загружаемые из указанного файла. Данный параметр игнорируется, если установлена опция параметра -none.

-pwd <password> — пароль файла, содержащего сертификаты CA. Если файл сертификата защищен паролем, то соединение возможно только при правильно указанном пароле. Данный параметр игнорируется, если у данного параметра не указана опция -file.

-none — указывает, что сертификаты CA не используются и сертификат сервера не проверяется.

Если ни одна из опций -windows, -file или -none не установлена, то параметр /HttpsCA игнорируется.

 

/HttpsForceSSLv3 — определяет принудительное использование протокола SSL версии 3.0 независимо от настроек информационной базы (Используется только в тонком клиенте!)

Наверх

Регистрация "1С:Предприятия 8" в качестве OLE-Automation-сервера

/RegServer — регистрация приложения.

/UnregServer — удаление регистрации приложения.

Наверх

Прочие параметры

/@ <имя файла> — параметры командной строки записаны в указанном файле.

/AllowExecuteScheduledJobs -Off|-Force  — управление запуском регламентных заданий. Регламентные задания начинают выполняться на первом запущенном по порядку клиенте, у которого не AllowExecuteScheduledJobs –Off. После завершения сеанса этого клиента, выполнение переходит к какому-либо из других запущенных сеансов. Если запускается сеанс с AllowExecuteScheduledJobs –Force, то регламентные задания начинают выполняться на нем, не зависимо от наличия других сеансов.

/AppAutoInstallLastVersion+/- — управляет автоматической установкой новых версий приложения. "+" — установка новых версий включена; "-" — установка новых версий выключена.

/C <строка текста> — передача параметра в прикладное решение. Для доступа к параметру из встроенного языка используется свойство глобального контекста ПараметрЗапуска.

/ClearCache — очистка кэша клиент-серверных вызовов, в котором хранятся метаданные форм, модули и т.д.

/DisableStartupDialogs  — подавляет вызов стартового диалога и диалогов аутентификации. При этом:

  • если командной строки недостаточно для выбора информационной базы или определения режима запуска, выдается ошибка;
  • если командной строки недостаточно для авторизации пользователя в информационной базе, выдается ошибка;
  • если в командной строке отсутствует авторизация в хранилище конфигурации, конфигуратор запускается без связи с хранилищем;
  • если в командной строке ошибочная авторизация в хранилище конфигурации, выдается ошибка. 

/DisableStartupMessages — подавляет стартовые сообщения:

  • "Конфигурация базы данных не соответствует сохраненной конфигурации. Продолжить?";
  • "Возможностей Вашего компьютера недостаточно для редактирования справки по конфигурации. Для редактирования справки необходимо установить Microsoft Internet Explorer версии 7.0 или выше.";
  • "Возможностей Вашего компьютера недостаточно для редактирования html-документов, в том числе разделов справки. Для редактирования html-документов необходимо установить Microsoft Internet Explorer версии 7.0 или выше. В данном запуске редактирование html-документов будет недоступно.".

/EnableCheckExtensionsAndAddInsSyncCalls — включает режим строгой проверки использования синхронных вызовов расширений работы с файлами и криптографией и внешних компонент.

/EnableCheckModal — предназначен для запуска в режиме "строгой" проверки использования модальных методов.  В конфигурации, для которой режим модальности установлен в значение "Не использовать" или "Использовать с предупреждениями", при вызове модального метода будет сгенерирована исключительная ситуация или отображено предупреждение.

/Execute <имя файла внешней обработки> — предназначен для запуска внешней обработки в режиме "1С:Предприятие" непосредственно после старта системы.

/Out <имя файла> [-NoTruncate]] — установка файла для вывода служебных сообщений. Если задан параметр -NoTruncate (через пробел), файл не очищается.
Во время исполнения пакетных команд файл сообщений можно открыть для просмотра. Запись сообщений в файл не буферизуется (сообщения записываются сразу).

/RunModeOrdinaryApplication — запуск толстого клиента в обычном режиме, несмотря на настройки конфигурации и пользователя, от имени которого будет выполняться запуск.  Не используется в тонком клиенте.

/RunModeManagedApplication — запуск толстого клиента в режиме управляемого приложения, при этом учитывается настройка в списке информационных баз:

  • "Выбирать автоматически" — запускается тонкий клиент;
  • "Тонкий клиент" — запускается тонкий клиент;
  • "Веб-клиент" — запускается веб-клиент;
  • "Толстый клиент" — запускается толстый клиент в режиме управляемого приложения.

При этом, при запуске клиента отключается механизм автоматического подбора клиентского приложения.

/RunShortcut <имя файла> — позволяет запустить систему "1С:Предприятие 8" со списком информационных баз, полученным с помощью указанного файла. В качестве файла может быть указан файл списка общих информационных баз (*.v8i), или файл ярлыка информационных баз (*.v8l).

/SLev — определяет уровень защищенности соединения клиента с сервером "1С:Предприятия" (используется для тонкого и веб-клиентов в режиме "1С:Предприятие").

Возможные значения:
   /SLev0 — незащищенное соединение;
   /SLev1 — защищенное соединение только в процессе выполнения аутентификации;
   /SLev2 — защищенное соединение в течение всего сеанса;
Если не указан, используется значение /SLev0.

/TComp [-None | -Deflate | -SDC] — устанавливает режим сжатия трафика между сервером и клиентом (только для тонкого клиента).

-None — сжатие отключено;
-Deflate — используется стандартное http сжатие трафика по алгоритму deflate;
-SDC — используется собственный алгоритм сжатия;
По умолчанию используется SDC-сжатие трафика.

/UC <код доступа> — позволяет выполнить установку соединения с информационной базой, на которую установлена блокировка установки соединений. Если при установке блокировки задан непустой код доступа, то для установки соединения необходимо в параметре /UC указать этот код доступа. Не используется при работе тонкого клиента через веб-сервер.

/URL <адрес> — указывает необходимость перехода по ссылке. Поддерживаются ссылки формата e1c:

Если указана внешняя ссылка - выполняется поиск запущенного клиентского приложения с той же строкой соединения, которая указана в параметре. В найденном клиентском приложении не должно быть открыто модальное или блокирующее окно. После этого выполняется попытка перехода по локальной ссылке из исходной навигационной ссылки и активизируется основное окно приложения. В случае неудачи клиентское приложение продолжает работу. Если исходная навигационная ссылка не содержит локальной ссылки (содержит только адрес информационной базы), то попытка перехода не выполняется, активируется основное окно найденного клиентского прложения.

Если подходящего клиентского приложения не найдено, строка соединения определяется из параметра командной строки /URL.

Если указана локальная ссылка - клиентское приложение запускается в общем порядке. После запуска выполнится попытка перехода по переданной локальной ссылке.

Для ссылок формата http(s) всегда запускается (или находится активный) тонкий клиент.

/UsePrivilegedMode — запуск в режиме привилегированного сеанса. Разрешен аутентифицированному пользователю, имеющему административные права. Журнал регистрации фиксирует установку или отказ в возможности установки режима привилегированного сеанса.

/Z<Общий реквизит 1>,<Общий реквизит 2>,...,<Общий реквизит N> — установка разделителей.

<Общий реквизит> = [<+>|<->]<значение общего реквизита>

[<+>|<->] — признак использования: "+" (по умолчанию) — реквизит используется; "-" — не используется;

Если разделитель не используется, то перед значением должен быть "-". Если первым символом в значении разделителя содержится символ "+" или "-", то при указании его нужно удваивать.

<значение общего реквизита> - значение общего реквизита. Если в значении разделителя присутствует запятая, то при указании ее нужно удваивать. Если значение разделителя пропущено, но разделитель должен использоваться, то используется символ "+".

Разделители разделяются запятой.

Например:

"/Z-ПервыйРазделитель,+,---ТретийРазделитель", что означает:

Первый разделитель выключен, значение — "ПервыйРазделитель",

Второй разделитель включен, значение — пустая строка,

Третий разделитель выключен, значение — "-ТретийРазделитель".

Наверх

1C:Enterprise Developer's Community