Администрирование · 10 мин
1С: что позволяет использование командной строки
Что позволяет командная строка в 1С: запуск базы, конфигуратора, пакетный режим, ключи обновления и выгрузки. Примеры команд и типовые ошибки.
Командная строка 1С — это способ запустить платформу с заранее заданными параметрами: указать базу, режим работы, пользователя и действие, которое нужно выполнить автоматически. Вместо ручного выбора базы в стартовом окне администратор формирует команду вида «1cv8.exe ENTERPRISE /F "путь_к_базе" /N "Пользователь" /Execute "обработка.epf"», и платформа выполняет задачу без лишних диалогов.
Такой подход незаменим при автоматизации: регламентные обновления конфигурации по расписанию, ночная выгрузка базы, пакетное тестирование, запуск отчётов по триггеру планировщика Windows. Всё, что администратор делает руками в конфигураторе, в большинстве случаев можно оформить как команду и повесить на планировщик задач.
Важно понимать: командная строка работает с исполняемыми файлами платформы — 1cv8.exe (толстый клиент), 1cv8c.exe (тонкий клиент), 1cv8s.exe (толстый клиент в режиме тонкого). Параметры передаются после имени файла, а синтаксис различается для файловых и клиент-серверных баз.
Какие режимы запуска задаёт командная строка
Первый параметр после имени исполняемого файла определяет режим работы платформы. Основных режимов два: ENTERPRISE — запуск прикладного решения (предприятие), и DESIGNER (в русской версии также CONFIG) — запуск конфигуратора. От выбора режима зависят все последующие ключи.
Режим ENTERPRISE используют для автоматического входа пользователя в базу, запуска внешней обработки или отчёта, открытия конкретной формы. Режим DESIGNER нужен для административных операций: обновления конфигурации, загрузки и выгрузки данных, тестирования и исправления, объединения конфигураций.
Также существует вспомогательный режим WEBSERVER для публикации на веб-сервере и режимы пакетного выполнения внутри конфигуратора — когда конфигуратор запускается, выполняет команду и завершает работу без открытия окон. Именно пакетный режим — основа автоматизации обслуживания баз.
Параметры подключения к базе: файловый и клиент-серверный варианты
Для файловой базы путь задаётся ключом /F с указанием каталога, где лежит файл 1Cv8.1CD. Путь с пробелами обязательно заключается в кавычки. Для клиент-серверной базы вместо /F используется ключ /S в формате «ИмяСервера\ИмяБазы» — это имя сервера 1С и имя информационной базы в кластере.
Дополнительно передаются данные аутентификации: /N — имя пользователя, /P — пароль. Если пароль пустой, ключ /P можно опустить. Для аутентификации средствами операционной системы используется ключ /WA+ (включить) или /WA- (запретить). При /WA+ платформа попытается войти под текущей учётной записью Windows.
1cv8.exe ENTERPRISE /F "D:\Bases\Trade" /N "Администратор" /P "Secret123"Для серверного варианта команда выглядит иначе:
1cv8.exe ENTERPRISE /S "srv1c\TradeBase" /N "operator" /WA-Если база опубликована на веб-сервере, подключение задаётся ключом /WS с адресом публикации. Это позволяет запускать тонкий клиент через веб без настройки списка баз на компьютере пользователя.
Пакетный режим конфигуратора: обновление и обслуживание
Главное применение командной строки в администрировании — пакетный режим конфигуратора. Ключ /DisableStartupDialogs подавляет стартовые диалоги, /DisableStartupMessages — информационные сообщения при запуске. После них указывается команда, которую нужно выполнить.
Типовые команды пакетного режима: /UpdateDBCfg — обновление конфигурации базы данных после загрузки новой конфигурации; /DumpCfg и /LoadCfg — выгрузка и загрузка конфигурации в файл .cf; /DumpIB и /RestoreIB — выгрузка и загрузка информационной базы в файл .dt; /CheckConfig — проверка логической целостности конфигурации.
- 1Сделайте резервную копию: выгрузите базу через /DumpIB или скопируйте файл 1Cv8.1CD при отсутствии активных сеансов
- 2Загрузите новую конфигурацию командой /LoadCfg с указанием файла .cf
- 3Выполните /UpdateDBCfg для обновления конфигурации базы данных
- 4Проверьте код возврата команды: 0 — успех, ненулевое значение — ошибка, детали смотрите в журнале
- 5Запустите базу в режиме предприятия и убедитесь, что обработчики обновления отработали корректно
Для диагностики ошибок пакетного режима используется ключ /Out, задающий файл, куда платформа запишет служебные сообщения. Без этого файла понять причину сбоя ночного обновления практически невозможно. Ключ /UC с кодом разрешения нужен, если на базе установлена блокировка соединений.
Запуск обработок и передача параметров в режиме предприятия
В режиме ENTERPRISE командная строка позволяет сразу выполнить внешнюю обработку или отчёт: ключ /Execute с путём к файлу .epf или .erf. Это стандартный способ запускать регламентные выгрузки, обмены с другими системами, формирование отчётов по расписанию.
Ключ /C передаёт произвольную строку параметра, которую конфигурация может прочитать через глобальный контекст (ПараметрЗапуска). Так обработка получает настройки конкретного запуска: дату периода, склад, формат выгрузки. Строка разбирается уже в коде конфигурации.
1cv8.exe ENTERPRISE /F "D:\Bases\Trade" /N "robot" /Execute "D:\Scripts\Export.epf" /C "Period=Month;Format=XML"Дополнительные полезные ключи: /AppAutoCheckMode — автоматический контроль конфигурации, /RunModeOrdinaryApplication или /RunModeManagedApplication — принудительный выбор режима приложения, /L и /VL — язык интерфейса и язык сообщений. Полный перечень параметров зависит от версии платформы, актуальный список приведён в документации к конкретному релизу.
Автоматизация через планировщик задач Windows
Командная строка раскрывается полностью в связке с планировщиком задач Windows. Администратор создаёт bat-файл с командой запуска 1С и настраивает его выполнение по расписанию: ночная выгрузка .dt, ежечасный запуск обработки обмена, еженедельное тестирование базы.
Практические правила для таких сценариев: указывайте полные пути к 1cv8.exe конкретной версии платформы, чтобы обновление платформы не сломало скрипт; запускайте задачу под отдельной учётной записью с минимально необходимыми правами; проверяйте код возврата и логируйте результат каждого запуска.
Пароль в командной строке виден в списке процессов и в истории планировщика. Для регламентных задач заведите отдельного пользователя 1С с ограниченными правами (только нужные объекты) и храните bat-файлы в каталоге с ограниченным доступом. Для серверных баз предпочтительнее аутентификация ОС через /WA+ под служебной учётной записью задачи.
Если планируется несколько операций подряд — выгрузка, затем обновление, затем проверка — оформляйте их последовательными командами в одном bat-файле с проверкой кода возврата после каждой. Так при сбое первой операции последующие не выполнятся поверх повреждённых данных.
Типичные ошибки и ограничения командной строки
Самая частая ошибка — отсутствие кавычек вокруг путей с пробелами. Команда молча не выполняется или подключается не к той базе. Вторая типичная проблема — несоответствие версии платформы: база требует более новую версию, чем та, чей 1cv8.exe указан в скрипте.
Ограничения, о которых стоит помнить: пакетный режим конфигуратора требует монопольного доступа для ряда операций, и при активных сеансах команда завершится ошибкой; тонкий клиент не поддерживает часть административных ключей; команды, завязанные на интерфейс (например, открытие форм), бессмысленны в фоновых сценариях без пользователя.
Как проверить результат
0 — операция завершена успешно
Ненулевое значение — смотрите файл, заданный ключом /Out
Содержит сообщения об успешном выполнении операции
Сообщения об ошибках, отказе в доступе, занятости базы
База открывается, версия конфигурации соответствует ожидаемой
Ошибка открытия, требование обновления конфигурации БД
Файл создан, имеет ненулевой размер, открывается при тестовой загрузке
Файл отсутствует, нулевого размера или не читается
Частые вопросы о командной строке 1С
Можно ли запустить 1С из командной строки без ввода логина и пароля?
Да. Передайте имя пользователя ключом /N и пароль ключом /P — платформа войдёт автоматически. Альтернатива — ключ /WA+ для аутентификации средствами Windows, если она настроена для пользователя базы. Учтите, что пароль в команде виден в командной строке процесса, поэтому для постоянных сценариев безопаснее аутентификация ОС.
Чем отличаются ключи /F и /S?
/F указывает каталог файловой базы — путь к папке с файлом 1Cv8.1CD. /S задаёт клиент-серверное подключение в формате «Сервер\ИмяБазы». Использовать оба ключа одновременно нельзя: формат подключения определяется типом базы.
Как узнать, почему не сработала ночная команда обновления?
Добавьте в команду ключ /Out с путём к файлу журнала — туда платформа пишет служебные сообщения пакетного режима. Дополнительно проверьте код возврата команды в планировщике задач и журнал регистрации базы. Чаще всего причина — активные сеансы, нехватка прав или неверный путь.
Можно ли через командную строку обновить сразу несколько баз?
Напрямую одна команда обновляет одну базу, но в bat-файле можно последовательно перечислить команды для каждой базы с проверкой кода возврата после каждой. Такой скрипт вешается на планировщик и обслуживает все базы за один запуск. При сбое одной базы логика скрипта должна остановить обработку или зафиксировать ошибку.
Работает ли командная строка для тонкого клиента?
Да, 1cv8c.exe поддерживает основные ключи подключения (/F, /S, /WS, /N, /P) и запуск в режиме предприятия. Однако режим конфигуратора и пакетные административные команды доступны только в толстом клиенте 1cv8.exe — тонкий клиент для обслуживания баз не подходит.
Как передать в обработку параметры при запуске через /Execute?
Используйте ключ /C со строкой параметров, например /C "DateFrom=01.01;Mode=Full". Внутри конфигурации эта строка доступна через значение ПараметрЗапуска, и обработка может разобрать её по собственным правилам. Формат строки платформа не регламентирует — соглашение о разборе задаёт разработчик обработки.
Что важно запомнить
Командная строка 1С — инструмент автоматизации: она запускает базу без диалогов, выполняет конфигуратор в пакетном режиме и позволяет строить регламентные сценарии через планировщик. Ключевые правила: резервная копия перед любыми изменяющими операциями, ключ /Out для диагностики, отдельная учётная запись с минимальными правами и проверка кода возврата каждой команды.