Ключи запуска 1С:Предприятия 8.3 для ярлыков, bat-файлов и планировщика
Содержание
Чтобы запустить 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.exe | C:\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 для него можно не писать.
Правила записи ключей простые:
- Ключ начинается с косой черты
/, регистр букв не важен. - Значение пишется сразу за ключом, без пробела:
/N"Иванов". - Значения с пробелами и кириллицей берите в двойные кавычки.
- Кавычки внутри значения удваиваются:
"".
Путь к 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"
Разбор строки:
start "" /wait— скрипт ждёт завершения 1С, а не идёт дальше сразу./DisableStartupDialogs— Конфигуратор не повиснет на диалоге, который некому закрыть./Out— после выполнения в журнале видно, чем закончилась выгрузка.- Имя файла собирается из даты. Формат
%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?
Как запустить обработку по расписанию без участия пользователя?
/Execute"обработка.epf". Обработка должна сама выполнить действие при открытии и закрыть сеанс через ЗавершитьРаботуСистемы(Ложь).