PEImg Command-Line Options

PEimg.exe is a command-line tool for creating and modifying Windows PE 2.0 images offline.

PEImg Command-Line Options

The following command-line options are available for PEImg.exe.

peimg {/import | /inf | /install | /lang | /scratchspace/targetpath/timezone/list/prep | /uninstall } <%WINDIR%> [/verbose] [/quiet]

Option Description

/?

Displays command-line help.

<%WINDIR%>

Specifies the path to the Windows directory within the base Windows PE image. The image must first be applied or mounted to a local directory by using ImageX. Path can also be written as /image=<path>.

/import=<path>

Imports a Windows PE package from a .cab file or directory structure. The package will be made available for installation. After importing a package, you must install the package by using the /install option. Winpe.wim provides several Windows PE packages.

For example,

peimg /import=c:\feature.cab c:\winpe_x86\mount\windows

/inf=<inf>

Installs an .inf package (typically a driver) to a Windows PE image, where <path> is the path to the .inf file or package. You can perform this on an image that was previously prepared with the /prep option.

For, example,

peimg /inf=c:\mydevice.inf c:\winpe_x86\mount\windows

/install=<pkg>

Installs a package, where <pkg> denotes the package name. A list of available packages and their names can be obtained by using the /list option. Wildcards can be used when specifying a package name; any packages with matching names will be installed.

For example,

peimg /install=WinPE-HTA-Package c:\winpe_x86\mount\windows

-OR-

peimg /install=*HTA* c:\winpe_x86\mount\windows

where wildcards denote any package with HTA in the package name.

/lang=<culture> [/layerdriver=<ID>]

Sets the locale and the user interface language of a Windows PE image, where <culture> is the culture name of the specified language. A language pack for the specified language must already be installed. For the ja-JP or ko-KR cultures, the /layerdriver option can be used to specify which keyboard layer driver should be installed. For a complete list of <culture> and <ID> values, see Supported Language Packs and Default Settings.

You can perform this command on a Windows PE image that was previously prepared with the /prep option.

For example,

peimg /lang=en-us c:\winpe_x86\mount\windows

/scratchspace =<size>

Sets the available scratch space, in megabytes. Valid values are 32, 64, 128, 256 and 512.

/targetpath=X:\

For hard disk boot scenarios, sets the location of the Windows PE image on the disk. This path must be equal to or a subdirectory of X:\ (this is the default). You can perform this only on a Windows PE image that was previously prepared with the /prep option.

/timezone =<culture or name>

Sets the default time zone of a Windows PE image. The time zone can be specified by culture name or time zone name. For a complete list of supported <culture> and <name> values, see, Supported Language Packs and Default Settings.

You can perform this only on a Windows PE image that was previously prepared with the /prep option.

/list

Displays a list of packages in the current image. In the INS column, a plus sign (+) denotes installed packages and a minus sign (-) denotes not installed. The /verbose option will display the full package name.

For example,

peimg /list c:\winpe_x86\mount\windows

/prep [/f]

Optimizes the Windows PE image for size. This operation cannot be reverted, and after the /prep option is issued, the /install, /uninstall, /import, and /list options will not function. The /lang and /inf options will continue to function. The tool will prompt the user to confirm the option. To suppress this prompt for scripting, specify the /f option.

For example,

peimg /prep c:\winpe_x86\mount\windows

/uninstall=<pkg>

Uninstalls a package, where <pkg> is the package name. A list of available packages and their names can be obtained, by using the /list option. Wildcards can be used when specifying a package name; any packages with matching names will be installed.

For example,

peimg /uninstall=WinPE-HTA-Package c:\winpe_x86\mount\windows

-OR-

peimg /uninstall=*HTA* c:\winpe_x86\mount\windows

where wildcards denote any component with HTA in the package name.

The following options can also be set.

Flag Description

/verbose

Displays full package identities.

For example,

peimg /list c:\winpe_x86\mount\windows /verbose

/quiet

Suppresses the progress bar.

For example,

peimg /prep c:\winpe_x86\mount\windows /quiet