DiskPart 使用文档

最新推荐文章于 2024-11-08 11:14:31 发布

xcntime

最新推荐文章于 2024-11-08 11:14:31 发布

阅读量1.7k

点赞数

分类专栏： Windows SDK开发文章标签：磁盘脚本 microsoft disk 扩展 attributes

Windows SDK开发专栏收录该内容

85 篇文章 1 订阅

订阅专栏

DiskPart

DiskPart.exe 是一种文本模式命令解释程序，它使您能够通过使用脚本或从命令提示符直接输入来管理对象（磁盘、分区或卷）。在使用 DiskPart.exe 命令之前，必须首先列出对象，然后选择对象以为其提供焦点。当某个对象具有焦点时，键入的任何 DiskPart.exe 命令都会作用到该对象上。

通过使用 list disk、list volume 和 list partition 命令可以列出可用的对象，并确定对象编号或驱动器号。list disk 和 list volume 命令将显示计算机上所有的磁盘和卷。而 list partition 命令只显示具有焦点的磁盘上的分区。使用 list 命令时，具有焦点的对象旁边会显示一个星号 (*)。可以按编号或按驱动器号选择对象，例如，磁盘 0、分区 1、卷 3 或卷 C。

选择对象时，焦点一直保留在那个对象上，直到选中其他对象。例如，如果已在磁盘 0 上设置了焦点，而您选择了磁盘 2 上的卷 8，焦点就从磁盘 0 转移到磁盘 2 上的卷 8。有些命令会自动更改焦点。例如，如果创建了新分区，焦点就自动转移到新分区上。

只能在选定磁盘上的分区上设置焦点。某个分区具有焦点时，相关的卷（如果有的话）也具有焦点。某个卷具有焦点时，如果该卷映射到某个特定分区，则相关的磁盘和分区也具有了焦点。如果不是这样，磁盘和分区上的焦点会丢失。

DiskPart 命令

要查看该命令语法，请单击以下命令：

active

在基本磁盘上，将具有焦点的分区标为活动。这将通知基本输入/输出系统 (BIOS) 或可扩展固件接口 (EFI) 该分区或卷是有效的系统分区或系统卷。

只有分区才可以标为活动。

要点

DiskPart 只验证分区是否能够包含操作系统的启动文件。DiskPart 不检查分区的内容。如果误将某个分区标为活动，并且该分区不包含操作系统的启动文件，则计算机可能无法启动。

语法

active

add disk

将具有焦点的简单卷镜像到指定磁盘。

语法

add disk=N [noerr]

参数

指定包含现有简单卷的磁盘之外的磁盘来包含镜像。只可以镜像简单卷。指定磁盘必须至少有与要镜像的简单卷同样大小的未分配空间。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

assign

给具有焦点的卷分配一个驱动器号或装入点。如果不指定驱动器号或装入点，则分配下一个可用驱动器号。如果驱动器号或装入点已经在用，则会产生一个错误。

使用 assign 命令，可以更改与可移动驱动器关联的驱动器号。

不可以向系统卷、启动卷或包含页面文件的卷分配驱动器号。此外，也不可以为原始设备制造商 (OEM) 分区或任何非基本数据分区的 GUID 分区表 (GPT) 分区分配驱动器号。

语法

assign [{letter=D | mount=Path}] [noerr]

参数

letter=D

要分配到该卷的驱动器号。

mount=Path

要分配到该卷的装入点路径。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

attributes

显示、设置或清除选中卷的卷属性。

语法

attributesvolume [{set | clear}] [{hidden | readonly | nodefaultdriveletter | shadowcopy}] [noerr]

参数

attributes volume

显示选定卷的属性。

set

设置选定卷的指定属性（隐藏、只读、没有默认驱动器号，或卷影副本卷）。

clear

从选定卷清除指定属性（隐藏、只读、没有默认驱动器号，或卷影副本卷）。

hidden

指定卷为隐藏的。

readonly

指定卷为只读。

nodefaultdriveletter

指定卷不会在默认情况下接受一个驱动器号。

shadowcopy

指定卷是一个卷影副本卷。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

automount

当启用时（默认值)，Windows 在将新基本卷添加到系统时自动为该新基本卷安装文件系统，然后给卷分配一个驱动器号。在系统区域网配置中，禁用 automount 会阻止 Windows 自动安装添加到系统的任何新基本卷，也阻止为其分配驱动器号。

语法

automount [enable] [disable] [scrub] [noerr]

参数

enable

使 Windows 能够自动安装添加到系统的新基本卷并为它们分配驱动器号。

disable

阻止 Windows 自动安装添加到系统的任何新基本卷。

scrub

删除系统中不再存在的卷的装入点目录和注册表设置。当以前在系统中的卷被添加回系统时，它可以阻止这些卷自动安装，并阻止为它们提供以前的卷装入点。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

break disk

仅适用于动态磁盘。将具有焦点的镜像卷分为两个简单卷。一个简单卷保留镜像卷的驱动器号和任何装入点。另外一个简单卷接收焦点，这样便可以为它分配驱动器号。

默认情况下，保留镜像的两个部分上的内容。每个部分成为一个简单卷。通过使用 nokeep 参数，只能将镜像的一半保留为简单卷，而将另一半删除并转换为可用空间。两卷都不接收焦点。

语法

break disk=N [nokeep] [noerr]

参数

指定包含镜像卷的磁盘。给此磁盘提供焦点，此磁盘不保留驱动器号或任何装入点。如果指定的磁盘为当前系统或启动磁盘，则该命令无效。

nokeep

指定只保留其中一个镜像卷，而删除简单卷 N 并将其转换为可用空间。无论是保留的卷还是可用空间都不接收焦点。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

clean

从具有焦点的磁盘删除任何分区或卷格式。在主启动记录 (MBR) 磁盘中，只覆盖 MBR 分区信息和隐藏的扇区信息。在 GUID 分区表 (GPT) 磁盘上，覆盖 GPT 分区信息，其中包括保护性 MBR。不存在隐藏扇区信息。

语法

clean [all]

参数

all

指定磁盘上所有扇区都设置为零，这样就完全删除了磁盘上的所有数据。

convert basic

将空白动态磁盘转换为基本磁盘。

要点

磁盘必须为空盘才能将其转换为动态磁盘。在转换磁盘之前，请备份数据并删除所有分区或卷。

语法

convert basic [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

convert dynamic

将基本磁盘转换为动态磁盘。磁盘上的任何现有分区都变为简单卷。

语法

convert dynamic [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

convert gpt

将具有主启动记录 (MBR) 分区形式的空白基本磁盘转换为具有 GUID 分区表 (GPT) 分区形式的基本磁盘。

要点

磁盘必须为空盘才能将其转换为 GPT 磁盘。在转换磁盘之前，请备份数据并删除所有分区或卷。

语法

convert gpt [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

convert mbr

将具有 GUID 分区表 (GPT) 分区形式的空白基本磁盘转换为具有主启动记录 (MBR) 分区形式的基本磁盘。

要点

磁盘必须为空盘才能将其转换为 MBR 磁盘。在转换磁盘之前，请备份数据并删除所有分区或卷。

语法

convert mbr [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create partition efi

在基于 Itanium 的计算机上，在 GUID 分区表 (GPT) 磁盘上创建可扩展固件接口 (EFI) 系统分区。创建分区之后，焦点就转移到新建分区上。

语法

create partition efi [size=N] [offset=N] [noerr]

参数

size=N

分区的大小以兆字节 (MB) 为单位。如果未给出分区大小，那么分区将会持续到当前区域中没有闲置空间为止。

offset= N

创建分区时的字节偏移量。如果未给出偏移量，则分区将被放置在能容下它的第一个磁盘区域中。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create partition extended

在当前驱动器上创建扩展分区。创建分区之后，焦点就自动转移到新分区上。每个磁盘上只能创建一个扩展分区。如果试图在其他扩展分区内创建扩展分区，此命令将失败。必须在创建逻辑驱动器之前创建扩展分区。

语法

create partition extended [size=N] [offset=N] [noerr]

参数

size=N

扩展分区的大小以兆字节 (MB) 为单位。如果未给出分区大小，那么分区将会持续到区域中没有闲置空间为止。分区大小是按柱面分界的。分区大小会近似为最接近的柱面边界。例如，如果指定一个大小为 500 MB 的分区，则分区将会近似为 504 MB。

offset=N

仅适用于主启动记录 (MBR) 磁盘。创建扩展分区时的字节偏移量。如果未给出偏移量，则分区将会在磁盘第一个可用空间开始。偏移量是按柱面对齐的。偏移量会近似为最接近的柱面边界。例如，如果指定偏移量为 27 MB，柱面为 8 MB，则偏移量被近似为 24 MB。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create partition logical

在扩展分区中创建逻辑驱动器。创建分区之后，焦点就自动转移到新建逻辑驱动器上。

语法

create partition logical [size=N] [offset=N] [noerr]

参数

size=N

逻辑驱动器的大小以兆字节 (MB) 为单位。如果未给出分区大小，那么分区将会持续到当前区域中没有闲置空间为止。分区大小是按柱面分界的。分区大小会近似为最接近的柱面边界。例如，如果指定一个大小为 500 MB 的分区，则分区将会近似为 504 MB。

offset=N

仅适用于主启动记录 (MBR) 磁盘。创建逻辑驱动器时的字节偏移量。偏移量是按柱面对齐的（也就是说，会自动近似偏移量，以完全填充正在使用的柱面大小）。如果未给出偏移量，则该分区将被放置在有足够大的空间容纳该分区的第一个磁盘区域中。分区大小至少要和 size= N 指定的字节数相同。如果要指定逻辑驱动器的大小，它必须小于扩展分区。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create partition msr

在 GUID 分区表 (GPT) 磁盘上创建 Microsoft 保留 (MSR) 分区。

警告

使用 create partition msr 命令时要注意。因为 GPT 磁盘要求特定分区布局，所以创建 Microsoft 保留分区可能导致磁盘不可读取。在用来启动 Windows XP 64-bit Edition (Itanium) 的 GPT 磁盘上，EFI 系统分区是磁盘上的第一个分区，其后是 Microsoft 保留分区。只用于存储数据的 GPT 磁盘不包含 EFI 系统分区；Microsoft 保留分区是第一个分区。

Windows XP 64-bit Edition (Itanium) 不会装入 Microsoft 保留分区。不能在其中存储数据，也不能将其删除。

语法

create partition msr [size=N] [offset=N] [noerr]

参数

size=N

分区的大小以兆字节 (MB) 为单位。分区大小至少要和 size= N 指定的字节数相同。如果未给出分区大小，那么分区将会持续到当前区域中没有闲置空间为止。

offset=N

创建分区的字节偏移量。分区从 offset= N 指定的字节偏移量开始。分区是按扇区对齐的，也就是说，会自动近似偏移量，以完全填充正在使用的扇区大小。如果未给出偏移量，则分区将被放置在能容下它的第一个磁盘区域中。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create partition primary

在当前基本磁盘上创建主分区。创建分区之后，焦点就自动转移到新分区上。该分区不接收驱动器号。必须使用 assign 命令为该分区分配一个驱动器号。

语法

create partition primary [size=N] [offset=N] [ID={Byte | GUID}] [align=N] [noerr]

参数

size=N

分区的大小以兆字节 (MB) 为单位。如果未给出分区大小，那么分区将会持续到当前区域中没有未分配空间为止。分区大小是按柱面分界的。分区大小会近似为最接近的柱面边界。例如，如果指定一个大小为 500 MB 的分区，则分区将会近似为 504 MB。

offset=N

创建分区的字节偏移量。如果未给出偏移量，则分区将会在磁盘第一个可用空间开始。对于主启动记录 (MBR) 磁盘，偏移量是按柱面对齐的。偏移量会近似为最接近的柱面边界。例如，如果指定偏移量为 27 MB，柱面为 8 MB，则偏移量被近似为 24 MB。

ID={ Byte| GUID}

只适用于原始设备制造商 (OEM)。警告

采用此参数创建分区可能会导致计算机崩溃或无法启动。如果您不是 OEM 或对 GPT 磁盘具有丰富经验的 IT 专业人员，请不要使用 ID={Byte | GUID} 参数在 GPT 磁盘上创建分区。而应总是使用 create partition efi 命令、create partition msr 命令、create partition primary 命令（不带 ID={Byte | GUID} 参数）分别在 GPT 磁盘上创建 EFI 系统分区、Microsoft 保留分区、主分区。

对于 MBR 磁盘，您可以用十六进制形式为分区指定一个分区类型字节。如果未在 MBR 磁盘上指定分区类型字节， create partition primary 命令就创建一个类型为 0x6 的分区。任何分区类型字节都可以通过 ID={ Byte | GUID} 参数进行指定。DiskPart 不检查分区类型字节的有效性，也不对 ID 参数进行任何其他检查。对于 GPT 磁盘，您可以为要创建的分区指定分区类型 GUID：

EFI 系统分区：c12a7328-f81f-11d2-ba4b-00a0c93ec93b
Microsoft 保留分区：e3c9e316-0b5c-4db8-817d-f92df00215ae
基本数据分区：ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
动态磁盘上的 LDM 元数据分区：5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
动态磁盘上的 LDM 数据分区：af9b60a0-1431-4f62-bc68-3311714a69ad

如果未指定分区类型 GUID，则 create partition primary 命令将创建一个基本数据分区。任何分区类型都可以通过 ID={ Byte | GUID} 参数进行指定。DiskPart 不检查分区 GUID 的有效性，也不对 ID 参数进行任何其他检查。

align=N

通常与硬件 RAID 逻辑单元号 (LUN) 阵列一起使用，以便在逻辑单元 (LU) 无法与柱面对齐的情况下改善性能。对齐磁盘开始处未实现柱面对齐的一个主分区，将偏移量置为最接近的对齐边界，其中 N 是从磁盘开始处到最接近的对齐边界的千字节 (KB) 数。如果主分区不在磁盘开始处，则 align= N 命令无效。如果结合 offset= N 使用，则偏移量在磁盘上第一个可用的柱面内。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create volume raid

使用三个或更多个指定的动态磁盘来创建 RAID-5 卷。创建新卷后，焦点自动转移到新卷上。

语法

create volume raid [size=N] disk=N,N,N[,N,...][noerr]

参数

size=N

每个磁盘可以获得的磁盘空间大小以兆字节 (MB) 为单位。如果未给出空间大小，将创建可能的最大 RAID-5 卷。具有最小可用相邻闲置空间的磁盘确定 RAID-5 卷的大小，并从每个磁盘分配到同样大小的空间。RAID-5 卷中实际可用磁盘空间小于磁盘空间的合并大小，因为进行奇偶校验需要一部分磁盘空间。

disk=N,N,N[ ,N,...]

用于创建 RAID-5 卷的动态磁盘。至少需要三个动态磁盘才能创建 RAID-5 卷。将为每一个磁盘分配 size= N 的磁盘空间。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create volume simple

创建简单卷。创建新卷后，焦点自动转移到新卷上。

语法

create volume simple [size=N] [disk=N] [noerr]

参数

size=N

卷大小以兆字节 (MB) 为单位。如果未指定卷大小，新建卷就占用磁盘上剩余的闲置空间。

disk=N

用于创建卷的动态磁盘。如果未指定磁盘，则使用当前磁盘。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

create volume stripe

使用两个或更多个指定的动态磁盘来创建带区卷。创建新卷后，焦点自动转移到新卷上。

语法

create volume stripe [size=N] disk=N,N[,N,...][noerr]

参数

size=N

每个磁盘可以获得的磁盘空间大小以兆字节 (MB) 为单位。如果没有指定大小，新建卷将占据最小磁盘上的剩余闲置空间以及其他磁盘上相同大小的空间。

disk=N,N[ ,N,...]

用于创建带区卷的动态磁盘。至少需要两个动态磁盘才能创建带区卷。将为每一个磁盘分配 size= N 的磁盘空间。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

delete disk

从磁盘列表删除丢失的动态磁盘。

语法

delete disk [noerr] [override]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

override

使 DiskPart 能够删除磁盘上的所有简单卷。如果磁盘上包含半个镜像卷，那么这半个镜像将被删除。如果磁盘是 RAID-5 卷的一个成员，那么 delete disk override 命令会失败。

delete partition

在每个基本磁盘上，删除具有焦点的分区。不能删除系统分区、启动分区或任何包含活动页面文件或故障转储（内存转储）的分区。

警告

删除一个动态磁盘上的分区会删除磁盘上的所有动态卷，因而会破坏所有数据并会使磁盘处于损坏状态。要删除动态卷，请总是使用 delete volume 命令。

可以从动态磁盘删除分区，但不可以创建分区。例如，可以删除动态 GPT 磁盘上的未识别的 GUID 分区表 (GPT) 分区。删除这样的分区不会导致由此产生的闲置空间变为可用。此命令用于在无法使用 clean 命令的紧急情况下回收已损坏的脱机动态磁盘上的空间。

语法

delete partition [noerr] [override]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

override

使 DiskPart 能够删除任何分区，而不论其类型是什么。通常情况下，DiskPart 只允许删除已知数据分区。

delete volume

删除所选卷。不能删除系统卷、启动卷或任何包含活动页面文件或故障转储（内存转储）的卷。

语法

delete volume [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

detail disk

显示所选磁盘及其上面的卷的属性。

语法

detail disk

detail partition

显示所选分区的属性。

语法

detail partition

detail volume

显示存放当前卷的磁盘。

语法

detail volume

exit

退出 DiskPart 命令解释程序。

语法

exit

extend

将具有焦点的卷扩展为最邻近的未分配空间。对于基本卷，未分配的空间必须与具有焦点的分区在同一磁盘上。它还必须在具有焦点的分区之后（扇区偏移量高于具有焦点的分区）。动态简单卷或跨区卷可以在任何动态磁盘上扩展为空的空间。使用此命令，可以将现有卷扩展为新建空间。

如果以前用 NTFS 文件系统格式化分区，则文件系统将自动扩展以占用更大的分区。不会丢失任何数据。如果分区以前通过非 NTFS 的文件系统格式进行格式化，此命令就会失败，并不对分区做任何更改。

不能扩展当前系统分区或启动分区。

语法

extend [size=N] [disk=N] [noerr]

extendfilesystem [noerr]

参数

size=N

添加到当前分区的空间大小以兆字节 (MB) 为单位。如果未给出大小，则磁盘扩展为占用所有最邻近的未分配空间。

disk=N

在其上扩展卷的动态磁盘。将在磁盘上分配 size= N 的磁盘空间。如果未指定磁盘，则在当前磁盘上扩展卷。

filesystem

只用于文件系统未随卷扩展的磁盘。扩展具有焦点的卷的文件系统，使文件系统占用整个卷。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

gpt attributes

在基本 GPT 磁盘上，给具有焦点的分区分配 GPT 属性。GPT 分区属性提供有关分区用途的其他信息。某些属性是分区类型 GUID 所特有的。

要点

更改 GPT 属性可能会导致基本数据卷无法安装或无法为其分配驱动器号。如果您不是原始设备制造商 (OEM) 或对 GPT 磁盘具有丰富经验的 IT 专业人员，请不要更改 GPT 属性。

语法

gpt attributes=N

参数

属于要应用于具有焦点的分区的属性的十六进制数。GPT 属性字段是包含两个子字段的 64 位字段。较高的字段只能在分区 ID 的上下文中解释，而较低的字段对于所有分区 ID 通用。所有分区都具有下列属性： 0x0000000000000001 将按需要标记分区。这样就可以向所有磁盘管理实用程序指出：不应该删除该分区。EFI 系统分区只包含那些启动操作系统所需要的二进制数据。这样，OEM 或操作系统特定的二进制数据放在其他分区会变得更加容易。对于基本数据分区，定义了下面的属性： 0x8000000000000000 阻止自动给分区分配驱动器号。默认情况下，每一个分区都被分配一个新驱动器号。设置此属性可以确保：当磁盘被移到一台新计算机时，将不会自动生成一个新驱动器号。用户可以手动分配驱动器号。注意

可以随时添加其他属性。

help

显示可用命令的列表。

语法

help

import

将外部磁盘组导入本地计算机的磁盘组。import 命令导入与具有焦点的磁盘在同一个组的每个磁盘。

语法

import [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

inactive

在基本主启动记录 (MBR) 磁盘上，将具有焦点的系统分区或启动分区标为非活动。重新启动计算机时，计算机从 BIOS 中指定的下一个选项启动，例如，CD-ROM 驱动器或基于预启动执行环境 (PXE) 的启动环境（例如远程安装服务 (RIS)）。

警告

若没有活动分区，计算机可能不会启动。除非您是一个对 Windows Server 2003 操作系统有深入了解的有经验的用户，否则，请不要将系统或启动分区标识为非活动。

如果在将系统分区或启动分区标为非活动之后无法启动计算机，则请将安装 CD 插入 CD-ROM 驱动器，重新启动计算机，然后在“恢复控制台”中使用 Fixmbr 和 Fixboot 命令来修复分区。有关“恢复控制台”的详细信息，请参阅故障恢复控制台概述和故障恢复控制台命令。

语法

inactive

list disk

显示磁盘以及磁盘相关信息的列表，如大小、可用空间量、磁盘是基本磁盘还是动态磁盘，以及该磁盘是使用主引导记录 (MBR) 还是 GUID 分区表 (GPT) 分区形式。标有星号 (*) 的磁盘具有焦点。

语法

list disk

list partition

显示当前磁盘的分区表中列出的分区。在动态磁盘上，这些分区可能与磁盘上的动态卷不对应。出现这种不一致的原因是动态磁盘在分区表中包含用于系统卷或启动卷的项（如果磁盘上有的话）。它们还包含一个分区，该分区占据磁盘的其余部分以便预留空间给动态卷使用。

语法

list partition

list volume

显示所有磁盘上基本卷和动态卷的列表。

语法

list volume

online

使脱机磁盘或具有焦点的卷处于联机状态。重新同步具有焦点的镜像卷或 RAID-5 卷。

语法

online [noerr]

参数

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

rem

提供一种向脚本中添加注释的方法。

语法

rem

示例

在此脚本示例中，使用了 rem 提供有关脚本作用的注释。

rem These commands set up 3 drives.

create partition primary size=2048

assign d:

create partition extend

create partition logical size=2048

assign e:

create partition logical

assign f:

remove

从具有焦点的卷中删除驱动器号或装入点。如果未指定驱动器号或装入点，则 DiskPart 将删除它遇到的第一个驱动器号或装入点。如果使用 all 参数，将删除所有当前的驱动器号和装入点。如果使用 dismount 参数，则 DiskPart 就会关闭所有对卷打开的句柄，然后将卷卸除。

remove 命令可用来更改与可移动驱动器关联的驱动器号。不能删除系统卷、启动卷或页面卷上的驱动器号。另外，不能删除如下分区的驱动器号：OEM 分区、任何具有未识别的 GUID 的 GPT 分区或任何特殊的、非数据的 GPT 分区（例如，EFI 系统分区）。

语法

remove [{letter=D | mount=Path | all}] [dismount] [noerr]

参数

letter=D

要删除的驱动器号。

mount=Path

要删除的装入点路径。

all

删除所有当前的驱动器号和装入点。

dismount

当所有驱动器号和装入点都已经从卷中删除之后卸除基本卷，并让基本卷脱机，使它无法安装。如果其他进程正在使用该卷，那么 DiskPart 将在卸除卷之前关闭任何打开的句柄。可以通过给卷分配一个驱动号或通过创建到卷的装入点路径，使该卷可以安装。如果在还有驱动器号或装入点的卷上使用 Dismount，将会失败。对于脚本，建议使用 remove all dismount。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

repair disk

通过用指定的动态磁盘替换发生故障的 RAID-5 成员来修复具有焦点的 RAID-5 卷。指定的动态磁盘上的可用空间必须大于或等于发生故障的 RAID-5 成员的总大小。

语法

repair disk=N [noerr]

参数

指定将替换发生故障的 RAID-5 成员的动态磁盘。指定的磁盘上的可用空间必须大于或等于发生故障的 RAID-5 成员的总大小。

noerr

仅用于脚本。出现错误时，DiskPart 继续处理命令，如同错误没有发生一样。没有 noerr 参数，发生某个错误将导致 DiskPart 退出，并显示一个错误代码。

rescan

查找已添加到计算机的新磁盘。

语法

rescan

retain

准备现有动态简单卷，以便用作启动卷或系统卷。

在具有焦点的动态简单卷上的主启动记录 (MBR) 中创建一个分区项。要创建 MBR 分区，动态简单卷必须从按柱面对齐的偏移量开始，并且其大小是柱面的整数倍。

在具有焦点的动态简单卷上的 GUID 分区表 (GPT) 中创建一个分区项。

语法

retain

select disk

选择指定磁盘，并将焦点转移到此磁盘上。

语法

select disk=[N]

参数

要接收焦点的磁盘的磁盘编号。如果未指定磁盘编号， select 命令将列出当前具有焦点的磁盘。通过使用 list disk 命令可以查看计算机上所有磁盘的磁盘编号。

select partition

选择指定分区，并给予其焦点。如果未指定分区，select 命令将列出具有焦点的当前分区。可以按分区的编号来指定分区。通过使用 list partition 命令可以查看当前磁盘上的所有分区号。在选择分区之前必须首先使用 DiskPart select disk 命令来选择磁盘。

语法

select partition=[N]

参数

要接收焦点的分区的编号。

select volume

选择指定卷，并给予其焦点。如果未指定卷，则 select 命令将列出当前具有焦点的卷。可以按编号、驱动器号或装入点路径来指定卷。在基本磁盘上，选择卷同时会给予相应分区焦点。通过使用 list volume 命令可以查看计算机上所有卷的编号。

语法

select volume=[{N | D}]

参数

要接收焦点的卷的编号。

要接收焦点的卷的驱动器号或装入点路径。

DiskPart 脚本

使用 DiskPart，可创建脚本以自动执行与磁盘相关的任务，如创建卷或将基本磁盘转换为动态磁盘。如果是使用无人参与安装或 Sysprep（它们不支持创建除启动卷以外的卷）部署 Windows，则创建执行这些任务的脚本非常有用。另外，还可以将输出从脚本定向到文本文件。脚本输出包括一些说明由 DiskPart 执行的任务是否成功的消息，在尝试调试脚本时非常有用。

要点

当将 DiskPart 命令用作脚本的一部分时，建议您将所有 DiskPart 操作一起作为单个 DiskPart 脚本的一部分来完成。您可以运行连续的 DiskPart 脚本，但是您必须在每个脚本之间允许至少 15 秒的时间，以便在后续的脚本中再次运行 DiskPart 命令前，完成前一个执行的关闭。否则，后续的脚本可能失败。可以在连续的 DiskPart 脚本之间添加一个暂停，方法是将 timeout /t 15 命令与 DiskPart 脚本一起添加到您的批处理文件中。

创建和运行脚本

使用记事本输入 DiskPart 命令（一个命令一行），创建 DiskPart 脚本文件。DiskPart 脚本文件是一个以 .txt 为扩展名的文本文件。例如，可以创建一个名叫 simple_volume.txt 的两行脚本的简单文件，该文件在一个动态磁盘上创建一个简单卷并为该卷分配一个驱动器号：

使用此脚本，DiskPart 将在磁盘 2（一个现有的动态磁盘）上创建一个 3 GB 的简单卷，并为该卷分配驱动器号 G。

要运行 DiskPart 脚本，可在命令提示符下转到该脚本文件所在的目录下，然后键入：

diskpart /sScriptName.txt

其中，ScriptName.txt 是包含您的脚本（如 simple_volume.txt）的文本文件的名称。

要将 DiskPart 的脚本输出重定向到一个文本文件，请键入：

diskpart /sScriptName.txt > LogFile.txt

其中，LogFile.txt 是 DiskPart 向其中写入输出的文本文件的名称。

当 DiskPart 启动时，DiskPart 版本和计算机名称将显示在命令提示符下。默认情况下，如果在尝试执行脚本化任务时 DiskPart 遇到错误，DiskPart 将停止处理该脚本并显示错误消息（除非指定了 noerr 参数）。但是，DiskPart 在遇到语法错误时总是返回错误，而无论是否使用了 noerr 参数。noerr 参数可用来执行有用的任务。例如，可使用单个脚本删除所有磁盘上的所有分区，而不管有多少磁盘。

下表列出了 DiskPart 错误代码。

错误	描述
0	没有出现错误。成功运行整个脚本。
1	出现致命异常。可能出现了严重问题。
2	为 DiskPart 命令指定的参数不正确。
3	DiskPart 无法打开指定的脚本或输出文件。
4	DiskPart 使用的服务之一返回失败。
5	出现命令语法错误。脚本失败，这是因为对象选择不正确，或与此命令一起使用时无效。

格式图例

格式	意义
斜体	用户必须提供的信息
粗体	用户必须严格按照其显示键入的元素
省略号 (...)	可在命令行中重复多次的参数
在括号 ([]) 之间	可选项目
在大括号 ({}) 之间；将选项用管线 (\|) 隔开。例如：{even\|odd}	用户必须从中只选择一个选项的选项组
`Courier font`	代码或程序输出