Oscdimg Command-Line 选项Oscdimg Command-Line Options

Oscdimg 是一个命令行工具,可用于创建 Windows 预安装环境 (Windows PE) 的自定义32位或64位版本的映像 ( .iso) 文件。Oscdimg is a command-line tool that you can use to create an image (.iso) file of a customized 32-bit or 64-bit version of Windows Preinstallation Environment (Windows PE). 然后,可以将 .iso 文件刻录到 CD 或 DVD。You can then burn the .iso file to a CD or DVD. Oscdimg 支持 (UDF) 文件系统的 ISO 9660、Joliet 和通用磁盘格式。Oscdimg supports ISO 9660, Joliet, and Universal Disk Format (UDF) file systems.

本主题内容:In this topic:

Oscdimg Command-Line 选项Oscdimg Command-Line Options

以下命令行选项可用于 Oscdimg。The following command-line options are available for Oscdimg.

Oscdimg [< options > ] < sourceLocation > < destinationFile >Oscdimg [<options>] <sourceLocation> <destinationFile>

文件系统选项File System Options

Oscdimg 工具和 Microsoft Windows image 主控 API (IMAPI.EXE) 支持三种文件系统格式: ISO 9660、Joliet 和 UDF。The Oscdimg tool and Microsoft Windows image mastering API (IMAPI) support three file system formats: ISO 9660, Joliet, and UDF.

ISO 9660 选项ISO 9660 Options

ISO 9660 选项不能与 Joliet 或 UDF 选项结合。ISO 9660 options cannot be combined with Joliet or UDF options. ISO 9660 文件系统中与文件扩展名的长度相结合的文件名长度不能超过30个字符。The length of the file name combined with the length of the file name extension cannot exceed 30 characters in the ISO 9660 file system.

-D-nt 选项不能一起使用。The -d and -nt options cannot be used together.

选项Option 描述Description

-d-d

允许用小写的文件名。Permits lower case file names. 不会将小写的文件名强制为大写。Does not force lowercase file names to upper case.

-n-n

允许文件名超过 DOS 8.3 文件名。Permits file names longer than DOS 8.3 file names.

-nt-nt

允许与 Windows NT 3.51 兼容的长文件名。Permits long file names that are compatible with Windows NT 3.51.

Joliet 选项Joliet Options

Joliet 是 ISO 9660 文件系统的扩展。Joliet is an extension of the ISO 9660 file system. Joliet 允许较长的文件名、Unicode 字符和目录深度大于8。Joliet allows longer file names, Unicode characters, and directory depths larger than eight. Joliet 选项不能与 ISO 9660 选项组合。Joliet options cannot be combined with ISO 9660 options.

-J2 Joliet 选项不能与任何 UDF 选项一起使用。The -j2 Joliet option cannot be used with any UDF options.

选项Option 描述Description

-j1-j1

允许两个文件系统查看磁盘上的所有数据。Permits both file systems to view all the data on the disk. 使用此选项不会复制映像上的所有文件。Using this option does not duplicate all files on the image. 此选项对 Joliet Unicode 文件名进行编码,并在 ISO 9660 命名空间中生成与 DOS 兼容的8.3 文件名。This option encodes Joliet Unicode file names and generates DOS-compatible 8.3 file names in the ISO 9660 namespace. 这些文件名可以通过 Joliet 系统或传统 ISO 9660 系统读取。These file names can be read by either Joliet systems or conventional ISO 9660 systems. 但是,Oscdimg 可能会更改 ISO 9660 命名空间中的某些文件名,以符合 DOS 8.3 和 ISO 9660 命名限制。However, Oscdimg may change some of the file names in the ISO 9660 namespace to comply with DOS 8.3 and ISO 9660 naming restrictions.

-j2-j2

对不带标准 ISO 9660 名称的 Joliet Unicode 文件名进行编码。Encodes Joliet Unicode file names without standard ISO 9660 names. 此选项用于生成仅包含 Joliet 文件系统的映像。This option is used to produce an image that contains only the Joliet file system. 无法读取 Joliet 的任何系统只会看到一个默认文本文件,该文件会提醒用户此映像仅在支持 Joliet 的计算机上可用。Any system that cannot read Joliet sees only a default text file that alerts the user that this image is only available on computers that support Joliet.

-js-js

重写用户指定 -j2 选项时使用的默认文本文件。Overrides the default text file that is used when the user specifies the -j2 option. 例如:For example:

-jsC:\readme.txt

UDF 选项UDF Options

UDF 选项不能与 ISO 9660 选项组合。UDF options cannot be combined with ISO 9660 options. -Ue-uf-us 选项仅适用于与 -u2 选项一起使用时的选项。The -ue, -uf, and -us options only apply when they are used together with the -u2 option.

选项Option 描述Description

-u1-u1

生成同时具有 UDF 文件系统和 ISO 9660 文件系统的映像。Produces an image that has both the UDF file system and the ISO 9660 file system. ISO 9660 文件系统是使用与 DOS 兼容的8.3 文件名编写的。The ISO 9660 file system is written by using DOS-compatible 8.3 file names. 使用 Unicode 文件名编写 UDF 文件系统。The UDF file system is written by using Unicode file names.

-u2-u2

生成只包含 UDF 文件系统的映像。Produces an image that contains only the UDF file system. 任何无法读取 UDF 的系统只会看到一个默认文本文件,该文件会提醒用户此映像仅在支持 UDF 的计算机上可用。Any system that cannot read UDF sees only a default text file that alerts the user that this image is only available on computers that support UDF.

-udfver102-udfver102

指定 UDF 文件系统版本1.02。Specifies UDF file system version 1.02.

-ue-ue

创建嵌入文件。Creates embedded files.

-uf-uf

嵌入 UDF 文件标识符条目。Embeds UDF file identifier entries.

-你的-ur

替代与 -u2 选项一起使用的默认文本文件。Overrides the default text file that is used together with the -u2 option. 例如:For example:

-urC:\Readme.txt

-us-us

创建稀疏文件(如果可用)以提高磁盘空间的使用效率。Creates sparse files, when available, to make disk space usage more efficient.

-yl-yl

指定较长的分配描述符,而不是短的分配描述符。Specifies long allocation descriptors instead of short allocation descriptors.

CD 或 DVD 启动选项CD or DVD Boot Options

启动选项可用于创建可启动 CD 或 DVD 映像。Boot options can be used to create bootable CD or DVD images. 以下启动选项可用于生成单启动条目。The following boot options can be used to generate single-boot entries. 有关详细信息,请参阅 使用单个启动项来创建可启动映像For more information, see Use a single boot entry to create a bootable image.

选项Option 描述Description

-b < bootSectorFile > -b<bootSectorFile>

指定将写入到磁盘的启动扇区或扇区中的 El Torito boot 扇区文件。Specifies the El Torito boot sector file that will be written in the boot sector or sectors of the disk. 请不要使用空格。Do not use spaces. 例如:For example:

在 UEFI 上: -bC:\winpe_x86\Efisys.binOn UEFI: -bC:\winpe_x86\Efisys.bin

在 BIOS 上: -bC:\winpe_x86\Etfsboot.comOn BIOS: -bC:\winpe_x86\Etfsboot.com

-e-e

禁用 El Torito 目录中的软盘仿真。Disables floppy disk emulation in the El Torito catalog.

-p-p

指定要用于 El Torito 目录中的平台 ID 的值。Specifies the value to use for the platform ID in the El Torito catalog. 默认 ID 为0xEF,用于表示 (UEFI) 系统的统一可扩展固件接口。The default ID is 0xEF to represent a Unified Extensible Firmware Interface (UEFI) system. 0x00 表示 BIOS 系统。0x00 represents a BIOS system.

<sourceLocation><sourceLocation>

必需。Required. 指定您要创建到 .iso 映像中的文件的位置。Specifies the location of the files that you intend to build into an .iso image.

<targetFile><targetFile>

指定 .iso 映像文件的名称。Specifies the name of the .iso image file.

重要说明Important
不能在同一命令中组合单启动条目和多启动条目。Single-boot entries and multi-boot entries cannot be combined in the same command.

以下启动选项可用于生成多启动项。The following boot options can be used to generate multi-boot entries. 有关详细信息,请参阅 使用多启动条目创建映像文件For more information, see Use multi-boot entries to create an image file.

选项Option 描述Description

b < bootSectorFile > b<bootSectorFile>

指定将写入到磁盘的启动扇区或扇区中的 El Torito boot 扇区文件。Specifies the El Torito boot sector file that will be written in the boot sector or sectors of the disk. 请不要使用空格。Do not use spaces. 例如:For example:

在 UEFI 上: bEfisys.binOn UEFI: bEfisys.bin

在 BIOS 上: bEtfsboot.comOn BIOS: bEtfsboot.com

-bootdata: < number > -bootdata:<number>

指定多启动映像,后跟启动条目数。Specifies a multi-boot image, followed by the number of boot entries. 请不要使用空格。Do not use spaces. 例如:For example:

-bootdata:<3>#<defaultBootEntry>#<bootEntry1>#<bootEntryN>

其中, < 3 > 是后面的启动条目数。where <3> is the number of boot entries that follow.

ee

禁用 El Torito 目录中的软盘仿真。Disables floppy disk emulation in the El Torito catalog.

h-pp

指定要用于 El Torito 目录中的平台 ID 的值。Specifies the value to use for the platform ID in the El Torito catalog. 默认 ID 为0xEF,表示 UEFI 系统。The default ID is 0xEF to represent a UEFI system. 0x00 表示 BIOS 系统。0x00 represents a BIOS system.

tt

指定 El Torito 负载段。Specifies the El Torito load segment. 如果未指定此选项,则此选项默认为0x7C0。If not specified, this option defaults to 0x7C0.

<sourceLocation><sourceLocation>

必需。Required. 指定您要创建到 .iso 映像中的文件的位置。Specifies the location of the files that you intend to build into an .iso image.

<targetFile><targetFile>

指定 .iso 映像文件的名称。Specifies the name of the .iso image file.

优化选项Optimization Options

优化选项可用于通过仅对重复的文件进行一次编码来优化存储。Optimization options can be used to optimize storage by encoding duplicate files only once.

选项Option 描述Description

-o-o

使用 MD5 哈希算法来比较文件。Uses a MD5 hashing algorithm to compare files.

-oc-oc

对每个文件使用二进制比较,并且速度慢于 -o 选项。Uses a binary comparison of each file, and is slower than the -o option.

-oi-oi

比较文件时忽略菱形压缩时间戳。Ignores Diamond compression timestamps when comparing files.

排序选项Order Options

Order 选项指定文件在磁盘上的顺序。Order options specify the file order on disk. 文件顺序不必列出所有文件。The file order does not have to list all files. 此文件中未显示的任何文件都将按通常 (的顺序进行排序(如果排序文件在) 不存在)。Any files that do not appear in this file are ordered as they would be ordinarily (that is, if the ordering file did not exist). 有关详细信息,请参阅 指定启动顺序For more information, see Specify the boot order.

-Yo 选项优先于 -y5 选项。The -yo option takes precedence over the -y5 option.

选项Option 描述Description

-y5-y5

指定磁盘上的文件布局。Specifies file layout on disk. 此选项先以反向排序顺序写入 i386 目录中的所有文件。This option writes all files in an i386 directory first and in reverse sort order.

-yo <bootOrder.txt>-yo<bootOrder.txt>

指定一个文本文件,该文件具有要放入图像中的文件的布局。Specifies a text file that has a layout for the files to be put in the image. 请不要使用空格。Do not use spaces. 例如:For example:

-yoC:\temp\bootOrder.txt

DVD 视频和音频选项DVD Video and Audio Options

DVD 视频和音频磁盘创建选项不能与 ISO 9660、Joliet 或 UDF 选项组合。The DVD video and audio disk creation options cannot be combined with ISO 9660, Joliet, or UDF options.

选项Option 描述Description

-未-ut

在 DVD 视频和音频磁盘创建过程中截断映像的 ISO 9660 部分。Truncates the ISO 9660 section of the image during DVD video and audio disk creation. 使用此选项时,ISO 9660 文件系统仅显示 VIDEO_TS、AUDIO_TS 和 JACKET_P 目录。When this option is used, only the VIDEO_TS, AUDIO_TS, and JACKET_P directories are visible from the ISO 9660 file system.

-uv-uv

指定在 DVD 视频和音频磁盘创建过程中 UDF 视频区域兼容性。Specifies UDF Video Zone compatibility during DVD video and audio disk creation. 在创建过程中,UDF 1.02 和 ISO 9660 会写入磁盘。During creation, UDF 1.02 and ISO 9660 are written to the disk. 首先写入 VIDEO_TS、AUDIO_TS 和 JACKET_P 目录中的所有文件。All files in the VIDEO_TS, AUDIO_TS, and JACKET_P directories are written first. 这些目录优先于此映像使用的所有其他排序规则。These directories take precedence over all other ordering rules that are used for this image.

消息传送选项Messaging Options

消息传送选项用于自定义文件和目录信息的显示方式。Messaging options customize how file and directory information appears.

选项Option 描述Description

-a-a

显示文件和目录的分配摘要。Displays the allocation summary for files and directories.

-os-os

当系统创建映像时显示重复文件。Shows duplicate files when the system creates the image.

-w1-w1

报告所有不符合 ISO 或 Joliet 的文件名或目录。Reports all file names or directories that are not ISO-compliant or Joliet-compliant.

-w2-w2

报告不符合 DOS 标准的所有文件名。Reports all file names that are not DOS-compliant.

-w3-w3

报告所有长度为零的文件。Reports all zero-length files.

-w4-w4

报告复制到映像的每个文件名。Reports each file name that is copied to the image.

-yd-yd

对于具有相同的初始64000字节的非相同文件,禁止显示警告。Suppresses warnings for non-identical files that have the same initial 64,000 bytes.

一般映像创建选项General Image Creation Options

一般映像创建选项可与单一启动条目选项或多启动条目选项一起使用,以创建可启动 CD 或 DVD 映像。General image creation options can be used together with a single-boot entry option or multi-boot entry options to create bootable CD or DVD images. 有关详细信息,请参阅 启动选项示例For more information, see Boot Options and Examples.

-M-maxsize 选项不能一起使用。The -m and -maxsize options cannot be used together.

选项Option 说明Description

-c-c

指定系统必须使用 ANSI 文件名,而不是 OEM 文件名。Specifies that the system must use ANSI file names instead of OEM file names.

-g-g

将时间值编码为所有文件 (UCT) ,而不是本地时间。Encodes time values as Universal Coordinated Time (UCT) for all files, instead of the local time.

-h-h

在映像的源路径中包括隐藏的文件和目录。Includes hidden files and directories in the source path of the image.

-k-k

即使无法打开某些源文件,也会创建一个图像。Creates an image even if some of the source files cannot be opened.

-l < volumeLabel > -l<volumeLabel>

指定卷标。Specifies the volume label. 请不要使用空格。Do not use spaces. 例如:For example:

-l<volumeLabel>

-m-m

忽略图像的最大大小限制。Ignores the maximum size limit of an image.

-maxsize: < limit > -maxsize:<limit>

覆盖图像的默认最大大小。Overrides the default maximum size of an image. 默认值为74分钟 CD。The default value is a 74-minute CD. 但是,如果使用 UDF,则默认值没有最大大小。However, if UDF is used, the default has no maximum size. 请不要使用空格。Do not use spaces. 例如:For example:

-maxsize:<4096>

其中, < 4096 > 将图像限制为 4096 MB。where <4096> limits the image to 4096 MB.

-q-q

仅扫描源文件。Scans the source files only. 此选项不会创建映像。This option does not create an image.

-r-r

Windows 8 的新的。New for Windows 8. 将符号链接解析为其目标位置。Resolves symbolic links to their target location.

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

指定所有文件和目录的时间戳。Specifies the timestamp for all files and directories. 请不要使用空格。Do not use spaces. 可以在项之间使用任何分隔符。You can use any delimiter between the items. 例如:For example:

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

-y6-y6

指定目录记录必须在扇区末尾完全对齐。Specifies that directory records must be exactly aligned at the end of sectors.

-yw-yw

打开具有写入共享的源文件。Opens source files that have write sharing.

示例Examples

这些示例演示了如何执行以下操作:These examples illustrate how to do the following:

  • 使用单一启动条目为基于 UEFI 的计算机创建可启动 CD 或 DVD。Create a bootable CD or DVD for a UEFI-based computer by using a single-boot entry.

  • 使用多启动条目为基于 UEFI 或 BIOS 的计算机创建可启动 CD 或 DVD。Create a bootable CD or DVD for a UEFI-based or BIOS-based computer by using a multi-boot entry.

  • 指定磁盘上的启动文件顺序。Specify the boot file order on a disk.

使用单启动条目创建可启动映像Use a single-boot entry to create a bootable image

可以使用 Oscdimg 工具创建可启动 CD 或 DVD,方法是使用单一启动项。You can use the Oscdimg tool to create a bootable CD or DVD by using a single-boot entry.

使用单启动条目To use a single-boot entry

  • 为基于 UEFI 的计算机创建图像文件。Create an image file for a UEFI-based computer. 例如:For example:

    Oscdimg -bC:\winpe_amd64\Efisys.bin -pEF -u1 -udfver102 C:\winpe_amd64\media C:\winpe_amd64\winpeamd64.iso
    

    其中 C: \ winpe _ amd64 \ media 是源文件的位置,而 c: \ winpe _ amd64 \ winpeamd64 是 .iso 文件的路径。where C:\winpe_amd64\media is the location of the source files, and C:\winpe_amd64\winpeamd64.iso is the path of the .iso file.

使用多启动条目创建可启动映像Use multi-boot entries to create a bootable image

可以使用 Oscdimg 工具,通过多启动项来创建可启动 CD 或 DVD。You can use the Oscdimg tool to create a bootable CD or DVD by using multi-boot entries. 执行此操作时,请注意以下事项:When you do this, note the following:

  • Bootdata 选项必须后跟命令 (-bootdata:< number >) 中的启动条目数。The bootdata option must be followed by the number of boot entries in the command (-bootdata:<number>).

  • 必须使用 () 的哈希符号分隔每个多启动项 # 。Each multi-boot entry must be delimited by using a hash symbol (#).

  • 启动项的每个选项必须用逗号分隔 (,) 。Each option for a boot entry must be delimited by using a comma (,).

  • 每个启动条目都必须指定平台 ID。Each boot entry must specify the platform ID.

使用多启动条目To use multi-boot entries

  • 使用多启动命令为基于 UEFI 或 BIOS 的计算机创建图像文件。Create an image file for either a UEFI-based or BIOS-based computer by using a multi-boot command. 例如:For example:

    Oscdimg -bootdata:2#p0,e,bEtfsboot.com#pEF,e,bEfisys.bin -u1 
    -udfver102 C:\winpe_amd64\media C:\winpe_amd64\winpeamd64.iso
    

    其中,此命令启动 BIOS 映像的 Etfsboot.com boot 文件,然后启动 UEFI 映像的 Efisys boot 文件。where this command starts the Etfsboot.com boot file for a BIOS image, and then starts the Efisys.bin boot file for a UEFI image.

指定启动顺序Specify the boot order

对于大于 4.5 GB 的图像,必须创建一个启动顺序文件,以确保启动文件位于映像的开头。For images larger than 4.5 GB, you must create a boot order file to make sure that boot files are located at the beginning of the image.

文件排序规则如下所示:The rules for file ordering are as follows:

  • 顺序文件必须在 ANSI 中。The order file must be in ANSI.

  • 订单文件必须以新行结束。The order file must end in a new line.

  • 订单文件必须每行有一个文件。The order file must have one file per line.

  • 必须相对于映像的根目录指定每个文件。Each file must be specified relative to the root of the image.

  • 必须将每个文件指定为长文件名。Each file must be specified as a long file name. 不允许使用短名称。No short names are allowed.

  • 每个文件路径的长度不能超过最大 _ 路径。Each file path cannot be longer than MAX_PATH. 这包括卷名。This includes the volume name.

例如,D: \ cdimage.exe 类似于以下 (其中 d 是 DVD 驱动器的驱动器号) :For example, D:\cdimage would resemble the following (where D is the drive letter of the DVD drive):

  • D: \ cdimage.exe \ 1 \1.txtD:\cdimage\1\1.txt

  • D: \ cdimage.exe \ 2 \2.txtD:\cdimage\2\2.txt

  • D: \ cdimage.exe \ 3 \3.txtD:\cdimage\3\3.txt

  • D: \ cdimage.exe \ 3 \ 3 _5.txtD:\cdimage\3\3_5.txt

  • D: \ cdimage.exe \ < longFileName >D:\cdimage\<longFileName>.txt

创建启动顺序文件To create a boot order file

  • 创建启动顺序文件。Create a boot order file. 例如:For example:

    Oscdimg -m -n -yoC:\temp\bootOrder.txt 
    -bC:\winpe_amd64\Efisys.bin C:\winpe_amd64\winpeamd64.iso
    

    其中 BootOrder.txt 包含以下文件列表:where BootOrder.txt contains the following list of files:

    boot\bcd
    boot\boot.sdi
    boot\bootfix.bin
    boot\bootsect.exe
    boot\etfsboot.com
    boot\memtest.efi
    boot\memtest.exe
    boot\en-us\bootsect.exe.mui
    boot\fonts\chs_boot.ttf
    boot\fonts\cht_boot.ttf
    boot\fonts\jpn_boot.ttf
    boot\fonts\kor_boot.ttf
    boot\fonts\wgl4_boot.ttf
    sources\boot.wim
    

相关主题Related topics

WinPE:创建 USB 可启动驱动器WinPE: Create USB Bootable drive

Windows 部署 Command-Line 工具参考Windows Deployment Command-Line Tools Reference