К статье
Практический материал

Администрирование · 10 мин

Как запустить 1С с параметром командной строки

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

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

Параметры передаются исполняемому файлу платформы: 1cv8.exe (тонкий клиент), 1cv8c.exe (тонкий клиент без модальных окон в некоторых сценариях) или 1cv8s.exe (стартер интерактивного выбора). Полный синтаксис выглядит так: путь к исполняемому файлу, режим запуска, строка подключения к информационной базе и дополнительные ключи, разделённые пробелами.

Какие режимы запуска поддерживает платформа

Первым параметром после пути к исполняемому файлу указывается режим. От него зависит, что именно сделает платформа при запуске. Основные режимы:

  • ENTERPRISE — режим «1С:Предприятие», обычная работа пользователей с базой;
  • DESIGNER — конфигуратор для разработки и администрирования;
  • WEBSERVER — работа через веб-сервер (используется редко, обычно для публикаций);
  • COM — запуск в режиме COM-соединения для интеграций;
  • CREATEINFOBASE — создание новой информационной базы из командной строки.
  • Если режим не указан, стартер 1cv8s.exe откроет стандартное окно выбора базы. Для автоматизации это нежелательно: любой диалог останавливает выполнение сценария до действия пользователя.

    Выбор режима определяется задачей. Для ежедневной работы бухгалтера достаточно ENTERPRISE с указанием базы и пользователя. Для ночного обновления конфигурации по расписанию используется DESIGNER с ключами пакетного режима.

    Строка подключения к информационной базе

    Для файловой базы используется параметр /F с путём к каталогу, где лежит файл 1Cv8.1CD:

    "C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Trade"

    Для клиент-серверной базы применяется параметр /S с адресом сервера и именем базы, разделёнными обратной косой чертой:

    "C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /S"server1c\Trade"

    Для базы, опубликованной на веб-сервере, используется параметр /WS с адресом публикации. Пути и адреса, содержащие пробелы или кириллицу, обязательно заключайте в кавычки — иначе командный интерпретатор разорвёт строку на отдельные аргументы, и запуск завершится ошибкой.

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

    Авторизация: как указать пользователя и пароль

    Параметр /N задаёт имя пользователя, /P — пароль. Если пароль пустой, параметр можно опустить. Пример запуска под конкретным пользователем:

    "C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Trade" /N"Иванова" /P"Secret123"

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

    Запуск обработок, отчётов и внешних файлов

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

    "C:\Program Files\1cv8\...\1cv8.exe" ENTERPRISE /F"D:\Bases\Trade" /N"Сервис" /Execute"D:\Scripts\Export.epf"

    Чтобы после выполнения сценария сеанс завершился автоматически, обработка должна сама вызвать завершение работы, либо используется связка с методом ЗавершитьРаботуСистемы() в коде. Без этого сеанс останется открытым и заблокирует, например, монопольные операции в ночное окно.

    Дополнительные ключи, которые часто используются вместе с запуском обработок:

    • /DisableStartupDialogs — подавить стартовые диалоги;
    • /DisableStartupMessages — подавить стартовые сообщения;
    • /C"текст" — передать произвольную строку, которую обработка прочитает через ПараметрЗапуска;
    • /Out"файл" — писать служебные сообщения в файл для последующего разбора.
    • Как создать ярлык для запуска с параметрами
      1. 1
        Щёлкните правой кнопкой на рабочем столе и выберите «Создать» → «Ярлык».
      2. 2
        В поле расположения вставьте полную строку: путь к 1cv8.exe, режим, /F или /S, ключи /N и /P.
      3. 3
        Нажмите «Далее», задайте понятное имя ярлыка и завершите мастер.
      4. 4
        Откройте свойства ярлыка и проверьте, что строка в поле «Объект» не обрезана.
      5. 5
        Запустите ярлык и убедитесь, что база открывается без диалога выбора и без запроса пароля.

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

      Режим DESIGNER с ключами пакетного выполнения позволяет делать то, что обычно требует ручной работы в конфигураторе: обновлять конфигурацию из файла, выгружать и загружать базу, тестировать и исправлять. Основные ключи:

      • /LoadCfg"файл.cf" — загрузить конфигурацию из файла;
      • /UpdateDBCfg — обновить конфигурацию базы данных;
      • /DumpIB"файл.dt" — выгрузить базу в dt;
      • /RestoreIB"файл.dt" — загрузить базу из dt;
      • /IBCheckAndRepair — тестирование и исправление.
      • Типовой сценарий ночного обновления выглядит так:

        "C:\Program Files\1cv8\...\1cv8.exe" DESIGNER /S"server1c\Trade" /N"Админ" /P"***" /LoadCfg"D:\Updates\1cv8.cf" /UpdateDBCfg /Out"D:\Logs\update.log"

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

        Запуск через bat-файл и планировщик заданий

        Для регулярных задач строку запуска оформляют в bat-файл и ставят в планировщик Windows. Это даёт контроль ошибок и логирование:

        @echo off
        

        "C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Trade" /N"Сервис" /Execute"D:\Scripts\Export.epf" /Out"D:\Logs\export.log"

        if errorlevel 1 echo Ошибка запуска >> D:\Logs\errors.log

        В планировщике заданий укажите запуск от имени учётной записи, у которой есть доступ к каталогу базы и сетевым ресурсам. Частая проблема — задание работает от системной учётной записи, у которой нет прав на сетевую папку с базой или обработкой, и сценарий молча не выполняется.

        Проверяйте результат не по факту запуска задания, а по фактическому результату: появлению выгруженного файла, записи в логе, отметке в базе. Только так можно отличить «задание отработало» от «задание запустилось, но ничего не сделало».

        Контрольные точки

        Как проверить результат

        Запуск ярлыка
        Норма

        База открывается сразу, без окна выбора и запроса пароля

        Тревожный признак

        Появляется диалог выбора базы или ошибка о неверном пути

        Пакетное обновление
        Норма

        В файле /Out нет строк об ошибках, конфигурация обновлена

        Тревожный признак

        В логе ошибка монопольного доступа или загрузки

        Задание планировщика
        Норма

        Создан ожидаемый файл выгрузки, лог заполнен

        Тревожный признак

        Задание завершено, но файл не появился

        Типичные ошибки при запуске с параметрами

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

        Вторая группа ошибок — несоответствие версии платформы. Ярлык ссылается на каталог старого релиза, который удалили при обновлении, и Windows сообщает, что файл не найден. Третья группа — права доступа: у пользователя, от имени которого выполняется запуск, нет доступа к каталогу базы, сетевому ресурсу или файлу лога.

        Типичные ошибки
        01
        Путь без кавычек — команда разрывается на пробеле, база не найдена
        02
        Пароль в открытом виде в общем bat-файле — компрометация учётной записи
        03
        Обновление без монопольного доступа — операция падает из-за активных сеансов
        04
        Запуск обработки без завершения сеанса — база остаётся заблокированной ночью
        05
        Жёсткая привязка к номеру версии платформы — ярлык ломается после обновления

        Частые вопросы о запуске 1С с параметрами

        Чем отличается 1cv8.exe от 1cv8c.exe при запуске с параметрами?

        Оба файла — тонкий клиент. 1cv8c.exe исторически использовался как вариант без поддержки некоторых модальных окон; в актуальных версиях различия минимальны, и для автоматизации обычно берут 1cv8.exe. Для выбора режима через диалог используется стартер 1cv8s.exe.

        Как запустить базу, если путь содержит пробелы и кириллицу?

        Заключите весь путь в двойные кавычки внутри значения параметра: /F"D:\Мои базы\Торговля". Кавычки ставятся сразу после ключа, без пробела между ключом и значением.

        Можно ли передать в обработку свои параметры?

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

        Почему пакетное обновление завершается ошибкой монопольного доступа?

        Потому что в базе есть активные сеансы пользователей или фоновые задания. Перед запуском завершите сеансы через консоль администрирования сервера 1С либо установите блокировку соединений с кодом разрешения и передайте его ключом /UC.

        Как запустить отладку через командную строку?

        Используйте ключ /DEBUG (и при необходимости /DEBUGURL с адресом сервера отладки) вместе с обычной строкой запуска. Сеанс запустится с включённой отладкой и подключится к конфигуратору, если он ожидает подключения.

        Работают ли параметры запуска для веб-клиента?

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

        Итог

        Что важно запомнить

        Запуск 1С с параметром строится по схеме: исполняемый файл → режим → строка подключения (/F, /S или /WS) → ключи авторизации и действий. Оформляйте строку в ярлык или bat-файл, не храните пароли в открытом виде, делайте копию перед пакетными операциями с конфигуратором и проверяйте результат по логам и фактическим файлам, а не по факту запуска.