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

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

Параметры командной строки в следующей таблице доступны в установщике Windows 3.0 и более ранних версий. Параметры стандартного установщика Command-Line также доступны начиная с установщика Windows 3.0.

Параметр Параметры Значение
Пакет |Код продукта Устанавливает или настраивает продукт.
/f [p|o|e|d|c|a|u|m|s|v] Пакет|Код продукта Восстанавливает продукт. Этот параметр игнорирует все значения свойств, введенные в командной строке. Список аргументов по умолчанию для этого параметра — omus. Этот параметр использует тот же список аргументов, что и свойство REINSTALLMODE .
p — переустановка, только если файл отсутствует.
o — переустановка, если файл отсутствует или установлена более старая версия.
e — переустановка, если файл отсутствует или установлена равная или более ранняя версия.
d — переустановка, если файл отсутствует или установлена другая версия.
c — переустановка, если файл отсутствует или хранимая контрольная сумма не соответствует вычисляемой сумме. Восстанавливает только файлы с msidbFileAttributesChecksum в столбце Атрибуты таблицы Файл .
a — принудительно переустанавливать все файлы.
u — перезаписывает все необходимые записи реестра, относящиеся к конкретному пользователю.
m — переписывает все необходимые записи реестра для конкретного компьютера.
s — перезаписывает все существующие ярлыки.
v — выполняется из источника и повторно кэширует локальный пакет. Не используйте параметр v переустановки для первой установки приложения или компонента.
/a Пакет Параметр административной установки . Устанавливает продукт в сети.
/X Пакет |Код продукта Удаляет продукт.
/J [u|m] Упаковыватель
[u|m] Список преобразованияpackage/t
или диспетчер конфигурации служб
[u|m] Package/gLanguageID
Объявляет продукт. Этот параметр игнорирует все значения свойств, введенные в командной строке.
u — объявляет текущему пользователю.
m — объявление для всех пользователей компьютера.
g — идентификатор языка.
t — применяет преобразование к объявленным пакетам.
/L [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] Файл журнала Записывает данные журнала в файл журнала по указанному существующему пути. Путь к расположению файла журнала должен уже существовать. Установщик не создает структуру каталогов для файла журнала. Флаги указывают, какие сведения следует регистрировать. Если флаги не указаны, по умолчанию используется значение iwearmo.
i — сообщения о состоянии.
w — некритические предупреждения.
e — все сообщения об ошибках.
a — запуск действий.
r — записи, относящиеся к действиям.
u — запросы пользователей.
c — начальные параметры пользовательского интерфейса.
m — сведения о выходе из памяти или неустранимые сведения о выходе.
o — сообщения об отсутствии места на диске.
p — свойства терминала.
v — подробные выходные данные.
x — дополнительные сведения об отладке. Установщик Windows 2.0: Не поддерживается. Параметр x доступен в установщике Windows версии 3.0.3790.2180 и более поздних.

+ — добавление в существующий файл.
! — Очистка каждой строки в журнале.
"*" — подстановочный знак, регистрируются все сведения, кроме параметров v и x. Чтобы включить параметры v и x, укажите "/l*vx".

Примечание.
Дополнительные сведения обо всех методах, доступных для настройки режима ведения журнала, см. в разделе Обычное ведение журнала в разделе Ведение журнала установщика Windows .


filename

Примечание.
Длина имени файла не должна превышать восемь символов.


Создает MIF-файл состояния SMS. Должен использоваться с параметрами установки (-i), удаления (-x), административной установки (-a) или переустановки (-f). ISMIF32.DLL устанавливается как часть SMS и должен находиться в пути.
Поля MIF-файла состояния заполняются следующими сведениями:
Производитель — автор
Продукт — номер редакции
Версия — тема
Языковой стандарт — шаблон
Серийный номер — не задан
Установка — для ISMIF32.DLL задано значение "DateTime"
InstallStatus — "Успешно" или "Сбой"
Описание — сообщения об ошибках в следующем порядке: 1) Сообщения об ошибках, созданные установщиком. 2) Ресурс из Msi.dll, если не удалось начать установку или пользователь завершил работу. 3) Файл сообщения о системной ошибке. 4) Форматируемое сообщение: "Ошибка установщика %i", где %i является ошибкой, возвращенной из Msi.dll.
/p PatchPackage[;p atchPackage2 ] Применяет исправление. Чтобы применить исправление к установленному административному образу, необходимо объединить следующие параметры:
/p <PatchPackage>[;p atchPackage2 ] /a \<Package>
/q n|b|r|f Задает уровень пользовательского интерфейса.
q , qn — нет пользовательского интерфейса
qb — базовый пользовательский интерфейс. Используйте qb! , чтобы скрыть кнопку Отмена .
qr — сокращенный пользовательский интерфейс без модального диалогового окна, отображаемого в конце установки.
qf — полный пользовательский интерфейс и все созданные в конце модальные диалоговые окна FatalError, UserExit или Выход .
qn+ — нет пользовательского интерфейса, за исключением модального диалогового окна, отображаемого в конце.
qb+ — базовый пользовательский интерфейс с модальным диалоговым окном в конце. Модальное поле не отображается, если пользователь отменит установку. Используйте qb+! или qb!+, чтобы скрыть кнопку Отмена .
qb- — базовый пользовательский интерфейс без модальных диалоговых окон. Обратите внимание, что /qb+- не является поддерживаемым уровнем пользовательского интерфейса. Используйте qb-! или qb!, чтобы скрыть кнопку Отмена .
Обратите внимание, что ! Параметр доступен в установщике Windows 2.0 и работает только с базовым пользовательским интерфейсом. Это недопустимо для полного пользовательского интерфейса.
/? или /h Отображает сведения об авторских правах для установщика Windows.
/Y Модуль Вызывает системную функцию DllRegisterServer для самостоятельной регистрации модулей, переданных в командной строке. Укажите полный путь к библиотеке DLL. Например, для MY_FILE.DLL в текущей папке можно использовать:
msiexec /y .\MY_FILE.DLL
Этот параметр используется только для сведений о реестре, которые нельзя добавить с помощью таблиц реестра .msi файла.
/Z Модуль Вызывает системную функцию DllUnRegisterServer для отмены регистрации модулей, переданных в командной строке. Укажите полный путь к библиотеке DLL. Например, для MY_FILE.DLL в текущей папке можно использовать:
msiexec /z .\MY_FILE.DLL
Этот параметр используется только для сведений о реестре, которые нельзя удалить с помощью таблиц реестра .msi файла.
/c Объявляет новый экземпляр продукта. Должен использоваться в сочетании с параметром /t. Доступно начиная с версии установщика Windows, поставляемой с Windows Server 2003 и Windows XP с пакетом обновления 1 (SP1).
/N ProductCode Указывает конкретный экземпляр продукта. Используется для идентификации экземпляра, установленного с помощью поддержки нескольких экземпляров с помощью преобразований изменения кода продукта. Доступно начиная с версии установщика Windows, поставляемой с Windows Server 2003 и Windows XP с пакетом обновления 1 (SP1).

Параметры /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y и /z не следует использовать вместе. Исключением из этого правила является то, что для установки исправлений для административной установки требуется использование /p и /a. Параметры /t, /c и /g следует использовать только с /j. Параметры /l и /q можно использовать с /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a и /p. Параметр /n можно использовать с /i, /f, /x и /p.

Чтобы установить продукт из A:\Example.msi, установите его следующим образом:

msiexec /i A:\Example.msi

С помощью командной строки можно изменить только открытые свойства . Все имена свойств в командной строке интерпретируются как прописные, но значение сохраняет чувствительность к регистру. Если ввести MyProperty в командной строке, установщик переопределяет значение MYPROPERTY, а не значение MyProperty в таблице Property. Дополнительные сведения см. в разделе Сведения о свойствах.

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

Правильный синтаксис:

msiexec /i A:\Example.msi PROPERTY=VALUE

Неправильный синтаксис:

msiexec /i PROPERTY=VALUE A:\Example.msi

Значения свойств, которые являются строковыми литералами, должны быть заключены в кавычки. Включите все пробелы в строку между метками.

msiexec /i A:\Example.msi PROPERTY="Embedded White Space"

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

msiexec /i A:\Example.msi PROPERTY=""

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

msiexec /i A:\Example.msi PROPERTY="Embedded ""Quotes"" White Space"

В следующем примере показана сложная командная строка.

msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme "Widgets"" and "Gizmos".""

В следующем примере показаны параметры объявления. Обратите внимание, что параметры не чувствительны к регистру.

msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt

В следующем примере показано, как установить новый экземпляр продукта для объявления. Этот продукт предназначен для поддержки преобразований нескольких экземпляров.

msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt

В следующем примере показано, как установить исправление экземпляра продукта с помощью нескольких преобразований экземпляров.

msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb

При применении исправлений к определенному продукту параметры /i и /p нельзя указать вместе в командной строке. В этом случае вы можете применить исправления к продукту следующим образом.

msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb

Свойство PATCH не может быть задано в командной строке, если используется параметр /p. Если свойство PATCH задано при использовании параметра /p, значение свойства PATCH игнорируется и перезаписывается.