Share via


Oscdimg Command-Line Options

3/21/2011

Oscdimg is a command-line tool for creating an image (.iso) file of a customized 32-bit or 64-bit version of Windows Preinstallation Environment (Windows PE) 3.0. You can then burn that .iso file to a CD-ROM.

Note

Merely copying the .iso file to the CD-ROM does not work. To create a bootable CD-ROM, you must use CD-recording software that unpacks the .iso file and burns it to a CD-ROM.

Where to Find Oscdimg

In order to run oscdimg on a computer with Windows Embedded Standard 7 Toolkit installed, open the Windows PE Tools Command Prompt. This will load the Standard 7 environment variables and allow you to use oscdimg from your command prompt.

Alternatively, to copy oscdimg to a storage device or a remote location, you can find oscdimg at the following locations, where C is the drive on which you installed Standard 7 and E is a DVD drive containing the Standard 7.installation media. Replace <device architecture> with x86 or AMD64, depending upon your device architecture.

C:\Program Files\Windows Embedded Studio\Tools\<device architecture>
E:\Windows Embedded Studio\Program Files\Windows Embedded Studio\Tools\<device architecture>

Note

If your development computer uses a 64-bit architecture, your install location will change to C:\Program Files (x86)\Windows Embedded Studio.

Oscdimg Command-Line Options

The following command-line options are available for Oscdimg.

oscdimg [-blocation] [-d] [-h] [-j1] [-j2] [-llabelname] [-n] [-nt] [-o[i][s]] [-tmm/dd/yyyy,hh:mm:ss [-g]] [-x] sourceroot [image_file]

Option Description

-b location

Specifies the location of the El Torito boot sector file. Do not use any spaces.

For example,

-bc:\directory\Etfsboot.com 

-d

Does not force lowercase file names to uppercase.

-g

Uses the Universal Coordinated Time (UCT) for all files instead of the local time.

-h

Includes hidden files and directories.

-j1

Encodes Joliet Unicode file names and generates DOS-compatible 8.3 file names in the ISO-9660 namespace. These file names can be read by either Joliet systems or conventional ISO-9660 systems, but Oscdimg may change some file names in the ISO-9660 namespace to comply with DOS 8.3 and ISO-9660 naming restrictions.

When you use the -j1 or -j2 options, the -d, -n, and -nt options do not apply and cannot be used.

-j2

Encodes Joliet Unicode file names without standard ISO-9660 names. (Requires a Joliet operating system to read files from the CD-ROM.)

When you use the -j1 or -j2 options, the -d, -n, and -nt options do not apply and cannot be used.

-l labelname

Specifies the volume label. Do not use spaces between the l and the labelname.

For example,

-lMYLABEL 

-n

Enables long file names.

-nt

Enables long file names that are compatible with Windows NT 3.51.

-o

Optimizes storage by encoding duplicate files only one time.

-oi

Optimizes storage by encoding duplicate files only one time. When it compares files, ignores Diamond compression timestamps.

-os

Optimizes storage by encoding duplicate files only one time. Shows duplicate files when it creates the image.

-ois

Optimizes storage by encoding duplicate files only one time. When it compares files, ignores Diamond compression timestamps. Shows duplicate files when it creates the image.

-t mm/dd/yyyy,hh:mm:ss

Specifies the time stamp for all files and directories. Do not use any spaces. Use the United States of America date format and a 24-hour clock. You can use any delimiter between the items.

For example,

-t12/31/2000,15:01:00

-x

Computes and encodes the AutoCRC value in the image.

sourceroot

Required. Specifies the location of the Windows PE files that you intend to build into an .iso image.

image_file

Specifies the name of the .iso image file that you intend to create from the Windows PE files.

See Also

Other Resources

Command-Line Tools Technical Reference