Image Builder Command-Line Options
3/21/2011
Image Builder is the program that installs and configures Windows Embedded Standard 7 and Windows Welcome. Image Builder supports custom installations and unattended installations.
Where to Find Image Builder
Image Builder is found in the root directory of your installation media. For example, if E contains a Windows Embedded Standard 7 Toolkit installation disk, you would run E:\setup.exe. If you boot your device off the Standard 7 Toolkit installation disk, Image Builder will run automatically.
Image Builder Command-Line Options
The following command-line options are available for Image Builder:
setup.exe [**/1394debug:**channel [**baudrate:**baud_rate]]
[**/debug:**channel [**baudrate:**baudrate]]
[/ds:path to distribution share] [/dudisable]
[/emsport: {com1 | com2 | usebiossettings | off} [**/emsbaudrate:**baudrate]]
[/installfrom:wim_file]
[/m:folder_name] [/noreboot] [**/tempdrive:**drive_letter]
[**/unattend:**answer_file]
[**/usbdebug:**hostname]
| Option | Description |
|---|---|
[/1394debug:channel [baudrate:baudrate]] |
Enables kernel debugging over an IEEE 1394 (FireWire) port while Standard 7 is running and during the windowsPE configuration pass of Image Builder. channel The debugging channel. The default value for channel is 1. [baudrate:baudrate] Specifies the baud to use while transferring data during debugging. The default is 19200. baudrate can also be set to 115200 or 57600. For example, |
[/debug:channel [baudrate:baudrate]] |
Enables kernel debugging over a communications (Com) port while Standard 7 is running and during the windowsPE configuration pass of Image Builder. channel The debugging channel. The default value for channel is 1. [baudrate:baudrate] Specifies the baud to use while transferring data during debugging. The default is 19200. baudrate can also be set to 115200 or 57600. For example, |
[/ds:path to distribution share] |
Sets the path to the distribution share containing the packages, drivers and other files referenced by your answer file. If this location requires credentials, you may have to logon prior to using this command. For example, |
[/dudisable] |
Disables Standard 7 dynamic update during Image Builder. Only original Image Builder files are used to install Standard 7. This option disables dynamic updates even if the DynamicUpdate option is specified in an unattended Image Builder answer file. For example, |
[/emsport: {com1 | com2 | usebiossettings | off} [/emsbaudrate:baudrate]] |
Enables or disables Emergency Management Services during Image Builder and after the server operating system has been installed. The following arguments are used to specify the behavior of EMS during Image Builder. com1 Enables EMS over COM1. Supported for x86 systems only. com2 Enables EMS over COM2. Supported for x86 systems only. usebiossettings Uses the setting specified in the BIOS. For x86 systems, the value from the Serial Port Console Redirection (SPCR) table is used. For Itanium-based systems, the Extensible Firmware Interface (EFI) is used. If no SPCR table or EFI console device path is specified in the BIOS, usebiossettings will be disabled. off Disables EMS. If EMS is disabled in Image Builder, you can later enable EMS by modifying the boot settings. For more information, see the Resource Kits for the Windows Server 2003 family. [/emsbaudrate:baudrate] Specifies the baud to use while transferring data during debugging. The default is 19200. baud can also be set to 115200 or 57600. For example, |
[/installfrom:wim_file] |
Instructs Image Builder to install the specified WIM file. For example,
You can also use [/unattend:answer_file] to apply an answer file to your WIM. For example,
|
[/m:folder_name] |
Specifies Image Builder to copy alternative files from another location. This option instructs Image Builder to look in the alternative location first, and, if files are present, to use them instead of the files from the default location. folder_name The name and location of the folder that contains the replacement files. folder_name can be any local drive location. UNC paths are not supported. You must know where the files will be installed on the Standard 7 installation. All the additional files must be copied to a $OEM$ folder in your installation sources or in the folder_name. The $OEM$ structure provides a representation of the destination installation disk. For example, $OEM$\$1 Maps to %SYSTEMDRIVE%, for example, drive C. $OEM$\$$ Maps to %WINDIR%, for example, C:\Standard 7\. $OEM$\$progs Maps to the program files directory. $OEM$\$docs Maps to the Users folder. For example, to copy an updated C:\Program Files\Messenger\Msmsgs.exe file into the Standard 7 installation, create the following folder structure on the installation source (Pro\Sources\$OEM$\$progs\Messenger\Msmsgs.exe) by using the Image Builder command: If you replace a file protected by Standard 7 file protection, you must also copy the updated file to the local sources to be installed with Standard 7 (C:\Standard 7\i386). The file name must be the same as what is used in Image Builder. For example, add this file and folder structure to your $OEM$ directory: If you use files that are not on an installation share, specify the folder name. For example, Where C:\additional_files is your customized $OEM$ directory. For example, If you make resource changes in your replacement files, you must add the updated MUI files to the installation. |
[/noreboot] |
Instructs Image Builder not to restart the computer after the downlevel phase of Image Builder finishes. The /noreboot option enables you to execute additional commands before Standard 7 restarts. This will suppress only the first restart. Successive restarts, if they are required, will not be suppressed. For example, |
[/tempdrive:drive_letter] |
Instructs Image Builder to copy temporary installation files on the specified partition. drive_letter The partition to copy installation files to during Image Builder. For example, |
[/unattend:answer_file] |
Enables unattended Image Builder mode. You can also specify a value for answer_file. If you specify a value for answer_file, Image Builder applies the values in the answer file during installation. If you do not specify a value for answer_file, Image Builder upgrades your existing version of Standard 7. All settings are taken from the previous installation so that minimal user intervention is required. answer_file The file path and file name of the unattended Image Builder answer file. The paths to an answer file can be a local path or UNC path. For example, |
[/usbdebug:hostname] |
Sets up debugging on a USB port. Debug data is effective on the next restart. hostname The name of the computer to debug. For example, |