Ключи запуска 1С:Предприятия 8.3 для ярлыков, bat-файлов и планировщика

· 9 мин

Содержание

Чтобы запустить 1С с параметрами, вызовите исполняемый файл платформы, укажите режим и ключи: "C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" ENTERPRISE /F"D:\Base\Buh" /N"Иванов" /P"123". Такая строка открывает файловую базу из папки D:\Base\Buh сразу под пользователем Иванов, без окна выбора базы и без запроса пароля.

Командная строка 1С:Предприятия нужна, когда базу открывают ярлыком в один клик, запускают ночную выгрузку через планировщик Windows или обновляют десяток баз скриптом. Всё ниже относится к платформе 8.3 и не зависит от конфигурации: ключи одинаково работают для Бухгалтерии, ЗУП, УТ и любой другой базы.

Какой файл запускать и как устроена строка

В папке платформы лежат несколько исполняемых файлов. От выбора зависит, какой клиент откроется и какие ключи он примет.

ФайлГде лежитЧто запускает
1cestart.exeC:\Program Files\1cv8\common\Стартер: окно выбора базы, сам подбирает версию платформы
1cv8.exe...\1cv8\8.3.xx.xxxx\bin\Толстый клиент и Конфигуратор
1cv8c.exe...\1cv8\8.3.xx.xxxx\bin\Тонкий клиент

Общий вид команды:

"путь\1cv8.exe" РЕЖИМ /Ключ1"значение" /Ключ2"значение" ...

Режим пишется первым словом после имени файла:

  • 🟢 ENTERPRISE — пользовательский режим (1С:Предприятие);
  • 🛠️ DESIGNER — Конфигуратор, в том числе пакетный;
  • 🆕 CREATEINFOBASE — создание новой информационной базы.

Если режим не указать, 1cv8.exe покажет окно выбора базы, как при обычном запуске. У 1cv8c.exe режим один — тонкий клиент, поэтому слово ENTERPRISE для него можно не писать.

Правила записи ключей простые:

  1. Ключ начинается с косой черты /, регистр букв не важен.
  2. Значение пишется сразу за ключом, без пробела: /N"Иванов".
  3. Значения с пробелами и кириллицей берите в двойные кавычки.
  4. Кавычки внутри значения удваиваются: "".

Путь к 1cv8.exe с номером версии надёжнее, чем 1cestart.exe: вы точно знаете, какая платформа откроет базу. Но после обновления платформы путь в ярлыках и скриптах придётся поправить.

Как указать базу и режим запуска 1С

База задаётся одним из ключей. Используйте тот, который соответствует типу подключения.

КлючТип базыПример
/FФайловая/F"D:\Base\Buh"
/SКлиент-серверная/S"srv1c\buh"
/WSЧерез веб-сервер/WS"http://web/buh"
/IBNameПо имени из списка баз/IBName"Бухгалтерия ООО Ромашка"
/IBConnectionStringСтрока соединения целикомсм. ниже

Для /F указывается папка, где лежит файл 1Cv8.1CD, а не сам файл. Для /S — имя сервера 1С и имя базы в кластере через обратную косую черту. Если кластер работает на нестандартном порту, порт пишут через двоеточие: /S"srv1c:2541\buh".

Ключ /IBName удобен в общих ярлыках: имя берётся из списка баз пользователя, и путь можно не знать. Если в списке две базы с одинаковым названием, 1С покажет окно выбора.

Строка соединения повторяет формат, который 1С сохраняет в списке баз. Кавычки внутри удваиваются:

1cv8.exe ENTERPRISE /IBConnectionString"File=""D:\Base\Buh"";"
1cv8.exe ENTERPRISE /IBConnectionString"Srvr=""srv1c"";Ref=""buh"";"

Толстый, тонкий или веб-клиент

Режим работы клиента тоже задаётся из командной строки:

  • 1cv8c.exe — тонкий клиент, подходит для управляемых конфигураций;
  • 1cv8.exe ENTERPRISE /RunModeManagedApplication — толстый клиент в режиме управляемого приложения;
  • 1cv8.exe ENTERPRISE /RunModeOrdinaryApplication — толстый клиент в режиме обычного приложения (для старых конфигураций на обычных формах);
  • /AppAutoCheckMode — платформа сама выберет клиент по свойствам конфигурации.

Для подключения к публикации на веб-сервере вместе с /WS используют тонкий клиент: 1cv8c.exe /WS"http://web/buh".

Логин, пароль и защита при запуске с параметрами

Пользователь и пароль передаются ключами /N и /P:

1cv8c.exe /F"D:\Base\Buh" /N"Администратор" /P"Qw12!x"

Если пароля у пользователя нет, ключ /P не пишите. Если имя не указано, а в базе включена аутентификация Windows, 1С попробует войти под пользователем ОС.

Аутентификацией операционной системы управляют два ключа:

  • /WA+ — требовать вход через учётную запись Windows;
  • /WA- — запретить вход через Windows, использовать только /N и /P.

/WA- полезен в скриптах на сервере. Без него задание, запущенное от служебной учётной записи, может войти не под тем пользователем, которого вы указали.

Пароль в ярлыке или bat-файле лежит открытым текстом. Любой, кто откроет свойства ярлыка, его увидит. Для скриптов заведите отдельного пользователя 1С с минимальными правами, а файл положите в папку с ограниченным доступом.

Вход в заблокированную базу

Когда администратор блокирует начало сеансов (например, перед обновлением), в форме блокировки задают код разрешения. Чтобы войти, несмотря на блокировку, передайте этот код ключом /UC:

1cv8.exe DESIGNER /F"D:\Base\Buh" /N"Администратор" /P"Qw12!x" /UC"KodObnovleniya"

Без /UC ночной скрипт обновления упрётся в собственную же блокировку и завершится ошибкой.

Ещё два ключа, связанных с правами:

  • /UsePrivilegedMode — запуск сеанса в привилегированном режиме, если у пользователя есть на это право;
  • /UseHwLicenses- — не искать аппаратный ключ защиты (когда используются только программные лицензии, это ускоряет старт).

Параметры интерфейса и действия при старте

Эта группа ключей определяет, что пользователь увидит сразу после входа.

КлючЧто делает
/C"текст"Передаёт строку в конфигурацию, в коде она доступна через ПараметрЗапуска
/Execute"файл.epf"Сразу открывает внешнюю обработку
/L"ru"Язык интерфейса платформы
/VL"ru"Язык (локализация) сеанса: формат дат и чисел
/DisplayAllFunctionsВключает команду «Все функции» в главном меню
/DisableStartupMessagesНе показывать стартовые предупреждения (например, о том, что конфигурация базы данных отличается от основной)
/DisableStartupDialogsНе показывать стартовые диалоги, в том числе окно выбора базы

Ключ /C — главный инструмент для автоматизации внутри конфигурации. Типовые конфигурации на БСП понимают несколько значений. Например, /C"ЗапуститьОбновлениеИнформационнойБазы" после пакетного обновления конфигурации запускает обработчики обновления. В своей доработке можно прочитать ПараметрЗапуска в модуле приложения и выполнить нужное действие: сформировать отчёт, выгрузить данные, закрыть сеанс.

Ключ /Execute часто используют для разовых обработок: ярлык открывает базу и сразу показывает форму исправления данных. Внешнюю обработку платформа откроет, только если у пользователя есть право на интерактивное открытие внешних обработок, а безопасный режим не запрещает её.

Ярлык на рабочем столе и поле в списке баз

Готовую строку можно вписать в поле «Объект» в свойствах ярлыка Windows. Второй вариант — список баз в стартере: при изменении базы на последней странице мастера есть поле «Дополнительные параметры запуска». Туда пишут ключи без пути и без режима, например /DisplayAllFunctions /N"Иванов". Эти параметры будут применяться при каждом входе в эту базу из окна выбора.

Готовые строки для типовых задач

Тонкий клиент с паролем и командой «Все функции» — для бухгалтера, которому нужен доступ к служебным объектам:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8c.exe" /F"D:\Base\Buh" /N"Петрова" /P"pass" /DisplayAllFunctions

Серверная база с открытием обработки исправления сразу после входа:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8c.exe" /S"srv1c\buh" /N"Администратор" /P"pass" /Execute"D:\epf\Ispravlenie.epf"

Конфигуратор той же базы без окна выбора — удобно держать отдельным ярлыком у разработчика:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /S"srv1c\buh" /N"Разработчик" /P"pass"

Отладка, журнал и служебные ключи 1С

Отладка

Чтобы подключить сеанс к отладчику Конфигуратора, запустите клиент с ключом /Debug. В платформе 8.3 есть два механизма отладки — по TCP и по HTTP. Для HTTP-отладки указывают адрес сервера отладки:

1cv8c.exe /F"D:\Base\Buh" /N"Разработчик" /Debug -http /DebuggerURL"http://localhost:1550"

Порт 1550 — порт сервера отладки по умолчанию для HTTP-механизма. Если в Конфигураторе выбран другой порт, укажите его.

Очистка кэша

Ключ /ClearCache очищает клиентский кэш метаданных перед запуском. Это первое средство, когда после обновления конфигурации формы открываются со старыми реквизитами или 1С падает на старте:

1cv8c.exe /S"srv1c\buh" /ClearCache

Кэш очищается только для пользователя Windows, от которого выполнен запуск. Открытые сеансы этот ключ не трогает.

Пакетный режим Конфигуратора

Самое частое применение командной строки — обслуживание без участия человека. Ключи работают в режиме DESIGNER:

КлючДействие
/DumpIB"файл.dt"Выгрузить информационную базу
/RestoreIB"файл.dt"Загрузить базу из выгрузки (полностью заменяет данные)
/DumpCfg"файл.cf"Сохранить конфигурацию в файл
/LoadCfg"файл.cf"Загрузить конфигурацию из файла
/UpdateCfg"файл.cfu"Обновить конфигурацию поставки
/UpdateDBCfgОбновить конфигурацию базы данных
/IBCheckAndRepairТестирование и исправление базы
/Out"файл.log"Записать сообщения в текстовый журнал
/DumpResult"файл"Записать код результата: 0 — успех

Пример ночной выгрузки файловой базы:

@echo off
chcp 65001 >nul
set V8="C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe"
set BASE=D:\Base\Buh
set DT=E:\Backup\buh_%date:~6,4%%date:~3,2%%date:~0,2%.dt

start "" /wait %V8% DESIGNER /F"%BASE%" /N"Архив" /P"pass" /WA- ^
  /DisableStartupDialogs /DumpIB"%DT%" /Out"E:\Backup\dump.log"

Разбор строки:

  1. start "" /wait — скрипт ждёт завершения 1С, а не идёт дальше сразу.
  2. /DisableStartupDialogs — Конфигуратор не повиснет на диалоге, который некому закрыть.
  3. /Out — после выполнения в журнале видно, чем закончилась выгрузка.
  4. Имя файла собирается из даты. Формат %date% зависит от региональных настроек Windows, проверьте его командой echo %date%.

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

Обновление конфигурации обычно делают в два вызова: сначала /UpdateCfg или /LoadCfg, затем /UpdateDBCfg. После этого запускают пользовательский режим с /C"ЗапуститьОбновлениеИнформационнойБазы", чтобы отработали обработчики обновления.

Создание новой базы

Режим CREATEINFOBASE создаёт пустую базу или базу из шаблона:

1cv8.exe CREATEINFOBASE File="D:\Base\Test" /AddInList"Тестовая база" /UseTemplate"D:\cf\1Cv8.cf"

/AddInList сразу добавляет базу в список пользователя под указанным именем. /UseTemplate принимает файл .cf или .dt.

Почему 1С не запускается с параметрами

Большая часть проблем — в записи строки, а не в самой платформе.

Диагностика: выберите симптом

Если ошибка непонятна, запустите ту же команду вручную из cmd без /DisableStartupDialogs. Окно с текстом ошибки покажет, на каком шаге всё сломалось. Для пакетного режима сначала смотрите файл из /Out: там записано, что Конфигуратор не смог сделать.

Частые вопросы

Можно ли передать в 1С несколько значений через /C?
Да, но платформа передаёт строку целиком. Разделите значения своим символом, например точкой с запятой, и разберите строку в коде через СтрРазделить(ПараметрЗапуска, ";").
Как узнать, с какими параметрами запущен текущий сеанс?
Значение ключа /C возвращает глобальное свойство ПараметрЗапуска. Остальные ключи из конфигурации напрямую не читаются.
Работают ли ключи с 1cestart.exe?
Да, стартер передаёт их платформе. Но версию он выбирает сам по настройкам базы, поэтому для скриптов надёжнее вызывать 1cv8.exe нужной версии.
Как запустить обработку по расписанию без участия пользователя?
Создайте задание в планировщике Windows: 1cv8c.exe с ключами базы, пользователя и /Execute"обработка.epf". Обработка должна сама выполнить действие при открытии и закрыть сеанс через ЗавершитьРаботуСистемы(Ложь).
Чем /DisableStartupMessages отличается от /DisableStartupDialogs?
Первый подавляет информационные предупреждения при старте, второй — диалоги, требующие выбора, включая окно списка баз. В пакетных скриптах ставьте оба.