Параметры запуска 1С:Предприятия 8.3 из командной строки и ярлыка

· 9 мин

Содержание

Чтобы запустить 1С с параметром, допишите ключи после пути к исполняемому файлу: "C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Иванов" /P"123". Первое слово задаёт режим (ENTERPRISE — пользовательский, DESIGNER — Конфигуратор), дальше идут ключи базы, пользователя и действия. Ту же строку можно вставить в поле «Объект» ярлыка, в bat-файл или в Планировщик заданий Windows.

Типичная ситуация: бухгалтер каждое утро открывает одну и ту же базу, выбирает её в списке, вводит логин. Или администратору нужно ночью выгружать базу в .dt без участия людей. Обе задачи решаются строкой запуска. Всё ниже относится к платформе 8.3 и не зависит от конфигурации: БП, ЗУП и УТ запускаются одинаково.

Как устроена строка запуска 1С: синтаксис и исполняемые файлы

Общая схема одна:

<путь к exe> <РЕЖИМ> <ключи базы> <ключи пользователя> <прочие ключи>

Правила, на которых чаще всего спотыкаются:

  • 🔹 каждый ключ начинается с косой черты /, регистр букв не важен;
  • 🔹 значение пишется сразу после ключа, без пробела: /N"Иванов";
  • 🔹 значение с пробелами, кириллицей или спецсимволами берите в двойные кавычки;
  • 🔹 если в значении нужна сама кавычка, её удваивают: "";
  • 🔹 режим ставится первым после пути к файлу; без него платформа покажет окно выбора базы.

Какой файл запускать

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

Для пакетных действий (DESIGNER, выгрузка, обновление) нужен именно 1cv8.exe: тонкий клиент Конфигуратор не открывает.

Если на компьютере стоит несколько версий платформы, указывайте полный путь к нужной папке bin. Иначе после очередного обновления скрипт начнёт запускаться другой версией.

Три режима

  • ENTERPRISE — обычная работа пользователя;
  • DESIGNER — Конфигуратор, в том числе пакетный (без окон);
  • CREATEINFOBASE — создание новой базы: 1cv8.exe CREATEINFOBASE File="D:\Bases\Test".

Ключи для подключения к файловой и серверной базе

Сначала платформе нужно понять, какую базу открыть. Для этого есть четыре варианта.

КлючДля чегоПример
/FФайловая база, путь к папке с 1Cv8.1CD/F"D:\Bases\Buh"
/SСерверная база: сервер\имя базы на кластере/S"srv1c\buh_2024"
/WSБаза, опубликованная на веб-сервере/WS"http://web/buh"
/IBNameИмя базы из списка в окне запуска/IBName"Бухгалтерия ООО Ромашка"

Для серверной базы с нестандартным портом менеджера кластера порт пишут через двоеточие: /S"srv1c:2541\buh_2024". Если кластер работает на стандартных портах (агент 1540, менеджер 1541), порт не нужен.

/IBName удобен, когда база уже есть в списке у пользователя. Если в списке две базы с одинаковым именем, платформа снова покажет окно выбора.

Пользователь и пароль

  • /N"Имя" — имя пользователя ровно так, как оно записано в списке пользователей базы;
  • /P"пароль" — пароль; если он пустой, ключ можно не писать;
  • /WA+ и /WA- — включить или запретить вход по учётной записи Windows (аутентификация ОС).

Пароль в ярлыке или bat-файле хранится открытым текстом. Любой, кто откроет свойства ярлыка, его увидит. Для пользователей лучше настроить аутентификацию Windows и запускать базу с /WA+, а пароль в строке держать только в служебных скриптах на защищённом сервере.

Режим запуска и интерфейс: как управлять клиентом из строки

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

  • 🖥 /RunModeOrdinaryApplication — принудительно запустить обычное приложение в толстом клиенте. Нужно для старых конфигураций на обычных формах.
  • 🖥 /RunModeManagedApplication — принудительно управляемое приложение.
  • 🔇 /DisableStartupMessages — не показывать предупреждения при старте (например, о несовпадении конфигурации с основной).
  • 🔇 /DisableStartupDialogs — не показывать стартовые диалоги, в том числе окно ввода логина. Если данных для входа не хватает, запуск завершится с ошибкой, а не будет ждать человека.
  • 🔇 /DisableSplash — убрать заставку при запуске.
  • 🌐 /L"ru" — язык интерфейса, /VL"ru" — локаль для форматов дат и чисел.
  • 🧭 /DisplayAllFunctions — сразу включить пункт «Все функции» в главном меню.
  • 🧹 /ClearCache — очистить кэш клиента перед запуском.

Готовый ярлык бухгалтера, который открывает нужную базу без окна выбора и без ввода логина:

"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /S"srv1c\buh_2024" /WA+ /DisableStartupMessages

Код блокировки /UC

Когда администратор включил блокировку сеансов (Администрирование → Обслуживание → Блокировка работы пользователей), войти в базу можно только с кодом разрешения. Его передают ключом /UC:

1cv8.exe DESIGNER /S"srv1c\buh_2024" /N"Админ" /P"***" /UC"Регламент"

Этот приём нужен в каждом ночном скрипте обновления серверной базы: сначала блокируете вход, потом скрипт заходит с кодом и работает монопольно.

Автоматизация: параметр /C, внешняя обработка и пакетный Конфигуратор

Здесь строка запуска превращается в инструмент автоматизации.

Передать свой параметр в базу: /C

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

Процедура ПриНачалеРаботыСистемы()

    Если СтрНайти(ПараметрЗапуска, "ЗакрытьМесяц") > 0 Тогда
        // запустить свою процедуру и завершить сеанс
        ВыполнитьЗакрытиеМесяца();
        ЗавершитьРаботуСистемы(Ложь);
    КонецЕсли;

КонецПроцедуры

Запуск: 1cv8.exe ENTERPRISE /F"D:\Bases\Buh" /N"Робот" /P"***" /C"ЗакрытьМесяц".

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

ПараметрЗапуска — строка целиком. Если передаёте несколько значений, разделите их символом, например ;, и разберите через СтрРазделить().

Открыть внешнюю обработку при старте: /Execute

/Execute"путь\к\файлу.epf" открывает внешнюю обработку сразу после входа. Так удобно запускать разовые выгрузки, загрузки и проверки без доработки конфигурации:

1cv8.exe ENTERPRISE /F"D:\Bases\Buh" /N"Робот" /P"***" /Execute"D:\Scripts\Vygruzka.epf" /DisableStartupMessages

Чтобы процесс завершался сам, в модуле формы обработки после выполнения действия вызывают ЗавершитьРаботуСистемы(Ложь).

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

Пакетный Конфигуратор: выгрузка, обновление, загрузка

В режиме DESIGNER с ключами-командами платформа выполняет действие без окон и закрывается.

КлючЧто делает
/DumpIB"файл.dt"Выгрузить информационную базу в .dt
/RestoreIB"файл.dt"Загрузить базу из .dt (заменит текущие данные)
/DumpCfg"файл.cf"Сохранить конфигурацию в .cf
/LoadCfg"файл.cf"Загрузить конфигурацию из .cf
/UpdateCfg"файл.cfu"Обновить конфигурацию файлом поставки
/UpdateDBCfgОбновить конфигурацию базы данных
/DumpConfigToFiles"папка"Выгрузить конфигурацию в XML-файлы
/LoadConfigFromFiles"папка"Загрузить конфигурацию из XML-файлов
/Out"лог.txt"Записать сообщения в файл (с -NoTruncate дописывать, а не перезаписывать)
/DumpResult"файл.txt"Записать код результата: 0 — успех, другое число — ошибка
/VisibleПоказать окно Конфигуратора во время пакетной работы

Ночная выгрузка файловой базы в архив с датой в имени:

@echo off
set V8="C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe"
set D=%date:~6,4%-%date:~3,2%-%date:~0,2%
%V8% DESIGNER /F"D:\Bases\Buh" /N"Админ" /P"***" /DisableStartupDialogs ^
  /DumpIB"E:\Backup\buh_%D%.dt" /Out"E:\Backup\log_%D%.txt" /DumpResult"E:\Backup\res_%D%.txt"

Формат %date% зависит от региональных настроек Windows; в примере он рассчитан на вид ДД.ММ.ГГГГ.

Выгрузка в .dt и обновление структуры базы требуют монопольного доступа. Все пользователи должны выйти, для серверной базы включите блокировку сеансов и передайте /UC. Иначе скрипт завершится ошибкой, а в логе будет сообщение о невозможности установить монопольный режим.

Ключ /RestoreIB перезаписывает данные базы целиком. Пробуйте его только на копии, а перед загрузкой в рабочую базу сделайте свежую выгрузку.

Планировщик заданий Windows

  1. Откройте Планировщик заданий → «Создать задачу ».
  2. На вкладке «Общие» выберите служебную учётную запись и отметьте «Выполнять для всех пользователей».
  3. На вкладке «Триггеры» задайте время, например 02:00.
  4. На вкладке «Действия» укажите путь к bat-файлу.
  5. После первого запуска откройте файл из /Out и убедитесь, что выгрузка прошла.

Отладка и диагностика через параметры запуска

Для разработчика и администратора полезны несколько ключей.

  • 🐞 /Debug — запустить клиент в режиме отладки, чтобы к нему мог подключиться Конфигуратор.
  • 🐞 /Debug -http /DebuggerURL"http://localhost:1550" — отладка по протоколу HTTP через сервер отладки (так подключается, например, 1С:EDT).
  • 🧪 /TESTMANAGER и /TESTCLIENT — режимы менеджера и клиента тестирования для автотестов.
  • 📝 /Out и /DumpResult — главный способ понять, почему пакетная команда не сработала. Без них ошибка пропадает вместе с невидимым окном.
  • 🧹 /ClearCache — первое, что пробуют, когда после обновления конфигурации у пользователя отображаются старые формы или клиент ведёт себя странно.

Перед очисткой кэша закройте программу у этого пользователя: ключ действует при новом запуске, остальные сеансы он не затрагивает.

Проверка кода возврата в bat-файле

Код из /DumpResult можно прочитать и отправить уведомление:

set /p RES=<"E:\Backup\res_%D%.txt"
if not "%RES%"=="0" echo Ошибка выгрузки базы, код %RES% >> "E:\Backup\alerts.txt"

Ошибки при запуске 1С с параметрами и как их исправить

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

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

Если для освобождения базы приходится завершать сеансы через консоль кластера, предупредите людей заранее: несохранённые документы пропадут. Такие действия планируют на нерабочее время.

Частые вопросы о параметрах командной строки 1С

Где посмотреть полный список ключей запуска 1С?
В справке платформы: в Конфигураторе откройте Справка → Содержание справки и найдите раздел о параметрах командной строки. Список зависит от версии платформы, новые ключи появляются в релизах 8.3.
Можно ли запустить 1С с параметрами на Linux?
Да. Исполняемый файл лежит в /opt/1cv8/x86_64/<версия>/, ключи те же, но пути к базе записывают в формате Linux: /F"/home/user/bases/buh".
Как задать параметры запуска для базы в окне выбора, а не в ярлыке?
Выберите базу в списке, нажмите «Изменить» и дойдите до последней страницы мастера. Там есть поле «Дополнительные параметры запуска»: ключи из него применяются при каждом входе в эту базу.
Как сделать отдельный ярлык для каждой базы?
Скопируйте ярлык 1С на рабочий стол, откройте его свойства и допишите в поле «Объект» после пути режим и ключ базы: ENTERPRISE /IBName"Зарплата". Название ярлыка задайте по имени базы.
Почему /C не срабатывает в моей конфигурации?
Платформа только передаёт строку, а читать её должен код конфигурации. Если в модуле приложения нет обработки ПараметрЗапуска, параметр ни на что не влияет.