Параметры запуска 1С:Предприятия 8.3 из командной строки и ярлыка
Содержание
Чтобы запустить 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.exe | C:\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
- Откройте
Планировщик заданий→ «Создать задачу ». - На вкладке «Общие» выберите служебную учётную запись и отметьте «Выполнять для всех пользователей».
- На вкладке «Триггеры» задайте время, например 02:00.
- На вкладке «Действия» укажите путь к bat-файлу.
- После первого запуска откройте файл из
/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".Как задать параметры запуска для базы в окне выбора, а не в ярлыке?
Как сделать отдельный ярлык для каждой базы?
ENTERPRISE /IBName"Зарплата". Название ярлыка задайте по имени базы.Почему /C не срабатывает в моей конфигурации?
ПараметрЗапуска, параметр ни на что не влияет.