Параметры командной строки инсталлятора

Программа установки принимает дополнительные параметры командной строки, которые могут пригодиться при автоматизации процесса установки приложений и использованы системными администраторами, пользователями или другими программами, вызывающими программу установки.

Смотрите также раздел "Параметры командной строки деинсталлятора".

/HELP, /?

Выводит справочную информацию по параметрам командной строки. Игнорируется, если директива UseSetupLdr в секции [Setup] имеет значение no.

/SP-

Отключает сообщение "Данная программа установит.., продолжить?" при запуске программы установки. Игнорируется, если директива DisableStartupPrompt в секции [Setup] имеет значение yes.

/SILENT, /VERYSILENT

Предписывает программе установке работать в тихом или очень тихом режиме. При тихой установке окно мастера и фоновое окно не отображаются, будет показано только окно с ходом выполнения установки. При очень тихой установке не отображается и окно с ходом выполнения установки. В остальном процесс установки протекает как обычно, так, например, отображаются сообщения об ошибках и уведомление при запуске (если только оно не отключено директивой DisableStartupPrompt или командной /SP-).

Если после установки необходима перезагрузка, а программа установки выполняется в тихом режиме и команда /NORESTART не использовалась, будет показано сообщение "Произвести перезагрузку сейчас?". При очень тихой установке перезагрузка будет выполнена автоматически, без уведомления.

/SUPPRESSMSGBOXES

Предписывает программе установки подавлять окна сообщений. Эффективно использовать только в сочетании с командой /SILENT или /VERYSILENT.

В ситуациях, в которых предусматривается сделать выбор, по умолчанию принимаются следующие ответы:

  • Да в ситуации "Сохранить существующий файл?".
  • Нет в ситуации "Заменить существующий файл?".
  • Прервать в ситуации Прервать / Повторить.
  • Отмена в ситуации Повторить / Отмена.
  • Да (=продолжить) в ситуации DiskSpaceWarning / DirExists / DirDoesntExist / NoUninstallWarning / ExitSetupMessage / ConfirmUninstall.
  • Да (=перезапустить) в ситуации FinishedRestartMessage / UninstalledAndNeedsRestart.
  • Рекомендуемый вариант в ситуации PrivilegesRequiredOverridesAllowed=dialog.

Для следующих 5-ти сообщений подавление не предусмотрено:

  • Окно сообщения "О программе".
  • Окно сообщения "Выйти из программы установки?".
  • Окно сообщения FileNotInDir2, когда при установке требуется вставить новый диск, который не был найден.
  • Любое окно сообщения (ошибка), которое может быть показано прежде, чем программа установки (или удаления) прочитает параметры командной строки.
  • Любой диалог задач или окно сообщения, показываемых при помощи функций TaskDialogMsgBox и MsgBox в секции [Code].
/ALLUSERS

Предписывает программе установки выполнить инсталляцию в режиме административной установки. Действует только в том случае, если в секции [Setup] используется директива PrivilegesRequiredOverridesAllowed со значением commandline.

/CURRENTUSER

Предписывает программе установки выполнить инсталляцию в режиме не административной установки. Действует только в том случае, если в секции [Setup] используется директива PrivilegesRequiredOverridesAllowed со значением commandline.

/LOG

Предписывает программе установки создать в пользовательском каталоге TEMP детальный отчёт установки файлов и действий [Run], предпринятых в процессе установки. Этот отчёт может быть использован для отладки сложных установок. К примеру, если какой-то файл не заменяется, в то время, как считается, что он должен быть перезаписан (или наоборот), отчёт установки покажет, действительно ли файл был пропущен и почему.

При создании файл отчёта получает уникальное имя на основе текущей даты, таким образом существующие файлы не будут дополнены или перезаписаны.

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

/LOG="filename"

Тоже самое, что и параметр /LOG, но в отличие от него позволяет указать путь и имя файла, которые будут использованы при создании отчёта. Если файл с таким именем уже существует, он будет перезаписан. Если же файл не может быть создан, программа установки будет прервана с сообщением об ошибке.

/NOCANCEL

Предотвращает отмену процесса установки путём отключения кнопки "Отмена" и игнорируя нажатия по кнопке "Закрыть". Целесообразно использовать вместе с командой /SILENT или /VERYSILENT.

/NORESTART

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

/RESTARTEXITCODE=exit code

Определяет дополнительный код выхода, который должна возвращать программа установки, если после успешного завершения установки необходимо перезапустить систему. (В противном случае, по умолчанию, код выхода будет равен 0.) Обычно используется вместе с командой /NORESTART. См. также: Коды выхода программы установки.

/CLOSEAPPLICATIONS

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

/NOCLOSEAPPLICATIONS

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

/FORCECLOSEAPPLICATIONS

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

/NOFORCECLOSEAPPLICATIONS

Запрещает программе установки принудительно закрывать приложения. Если также используется команда /FORCECLOSEAPPLICATIONS, этот параметр не учитывается.

/LOGCLOSEAPPLICATIONS

Предписывает программе установки при закрытии приложений создавать дополнительный отчёт в целях отладки.

/RESTARTAPPLICATIONS

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

/NORESTARTAPPLICATIONS

Запрещает программе установки перезапускать приложения. Если также используется команда /RESTARTAPPLICATIONS, этот параметр не учитывается.

/LOADINF="filename"

Предписывает программе установки загрузить настройки инсталляции из указанного файла. Этот файл может быть создан при помощи команды /SAVEINF=, описанной ниже.

Не забывайте использовать кавычки, если имя файла содержит пробелы.

/SAVEINF="filename"

Предписывает программе установки сохранить настройки инсталляции в указанный файл.

Не забывайте использовать кавычки, если имя файла содержит пробелы.

/LANG=language

Определяет используемый язык мастера установки. В качестве language необходимо указать внутренне имя языка, заданного в записях секции [Languages].

При использовании действительного значения параметра /LANG, диалог "Выбор языка" показан не будет.

/DIR="x:\dirname"

Переопределяет заданное по умолчанию имя каталога, который предлагается на странице "Выбор папки установки". Необходимо указывать полный путь. Может содержать приставку "expand:", которая указывает программе установки заменить любые константы в имени на соответствующие им значения. Например: /DIR=expand:{autopf}\My Program.

/GROUP="folder name"

Переопределяет заданное по умолчанию имя папки, которая предлагается на странице "Выбор папки в меню «Пуск»". Может содержать приставку "expand:" (см. описание команды /DIR=). Если директива DisableProgramGroupPage в секции [Setup] имеет значение yes, эта команда не учитывается.

/NOICONS

Предписывает программе установки изначально отметить опцию "Не создавать папку в меню «Пуск»" на странице мастера "Выбор папки в меню «Пуск»".

/TYPE=type name

Переопределяет заданный по умолчанию тип установки.

Если указанный тип существует и не является пользовательским, любой параметр /COMPONENTS будет проигнорирован.

/COMPONENTS="разделённый запятыми перечень компонентов"

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

Только указанные компоненты будут выбраны; выбор остальных будет отменён.

Если имя компонента начинается символом "*", также будут выбраны все дочерние компоненты (за исключением тех, которые имеют флаг dontinheritcheck). Если же имя компонента начинается символом "!", то его выбор будет отменён.

Этот параметр не может изменить состояние компонентов, которые содержат флаг fixed.

Пример:
Отменяется выбор всех компонентов и выбираются только "help" и "plugins": /COMPONENTS="help,plugins"


Пример:
Отменяется выбор всех компонентов и выбирается родительский со всеми дочерними компонентами за исключением одного: /COMPONENTS="*parent,!parent\child"

/TASKS="разделённый запятыми перечень задач"

Определяет перечень задач, которые должны быть изначально выбраны.

Будут выбраны только указанные задачи, остальные будут отменены. Если необходимо сохранить заданные по умолчанию задачи и только выбрать/отменить некоторые из них, используйте параметр /MERGETASKS вместо этого.

Если имя задачи начинается символом "*", также будут выбраны все дочерние задачи (за исключением тех, которые имеют флаг dontinheritcheck). Если же имя задачи начинается символом "!", то его выбор будет отменён.

Пример:
Отменяется выбор всех задач и выбираются только "desktopicon" и "fileassoc": /TASKS="desktopicon,fileassoc"


Пример:
Отменяется выбор всех задач и выбирается родительская со всеми дочерними задачами за исключением одной: /TASKS="*parent,!parent\child"

/MERGETASKS="разделённый запятыми перечень задач"

Подобен параметру /TASKS, за исключением того, что указанные задачи будут объединены с задачами, которые в противном случае были бы выбраны по умолчанию.

Если UsePreviousTasks имеет значение yes, то указанные задачи будут выбраны/отменены после восстановления всех предыдущих задач.

Пример:
Сохраняются выбранные по умолчанию задачи, но дополнительно ещё выбираются "desktopicon" и "fileassoc": /MERGETASKS="desktopicon,fileassoc"


Пример:
Сохраняются выбранные по умолчанию задачи, но выбор задачи "desktopicon" отменяется: /MERGETASKS="!desktopicon"

/PASSWORD=password

Определяет пароль для использования в установке. Если в секции [Setup] параметр Password не указан, этот параметр командной строки не учитывается.

Если указан неверный пароль, этот параметр также не учитывается.