DiskPart

DiskPart.exe est un interpréteur de commandes en mode texte qui vous permet de gérer les objets (disques, partitions ou volumes) à l'aide de scripts ou de commandes directes à partir d'une invite de commande. Avant de pouvoir utiliser les commandes DiskPart.exe sur un disque, une partition ou un volume, vous devez d'abord répertorier et sélectionner l'objet voulu pour lui donner le focus. Lorsqu'un objet a le focus, toutes les commandes DiskPart.exe que vous tapez s'appliquent à cet objet.

Vous pouvez répertorier les objets disponibles et déterminer le numéro ou la lettre de lecteur d'un objet à l'aide des commandes list disk, list volume et list partition. Les commandes list disk et list volume affichent tous les disques et les volumes présents dans l'ordinateur. Toutefois, la commande list partition n'affiche que les partitions du disque qui a le focus. Lorsque vous utilisez les commandes list, un astérisque (*) apparaît près de l'objet qui a le focus. Vous sélectionnez un objet à l'aide de son numéro ou de sa lettre de lecteur, comme disque 0, partition 1, volume 3 ou volume C.

Lorsque vous sélectionnez un objet, le focus reste sur cet objet jusqu'à ce que vous en sélectionniez un autre. Par exemple, si le disque 0 a le focus et que vous sélectionnez le volume 8 sur le disque 2, le focus passe du disque 0 au volume 8 du disque 2. Certaines commandes changent automatiquement le focus. Par exemple, lorsque vous créez une nouvelle partition, le focus passe automatiquement à la nouvelle partition.

Vous pouvez uniquement donner le focus à une partition du disque sélectionné. Lorsqu'une partition a le focus, le volume associé a également le focus. Lorsqu'un volume a le focus, le disque et la partition associés ont également le focus si le volume mappe vers une partition spécifique unique. Si tel n'est pas le cas, le disque et la partition perdent le focus.

Commandes DiskPart

Sur les disques de base, marque la partition dotée du focus comme active. Cela informe le système d'entrée/sortie de base (BIOS) ou l'interface EFI (Extensible Firmware Interface) que la partition ou le volume est une partition système ou un volume système valide.

Seules les partitions peuvent être marquées comme actives.

Important

DiskPart vérifie uniquement que la partition est capable de contenir les fichiers de démarrage d'un système d'exploitation. DiskPart ne contrôle pas le contenu de la partition. Si vous marquez une partition comme active par erreur, et qu'elle ne contient pas les fichiers de démarrage du système d'exploitation, votre ordinateur peut ne pas démarrer.

Syntaxe

active

Met en miroir le volume simple qui a le focus, sur le disque spécifié.

Syntaxe

add disk=n [noerr]

Paramètres

n: Spécifie le disque qui contiendra le miroir. Vous pouvez mettre en miroir des volumes simples uniquement. Le disque spécifié doit disposer d'un espace non alloué au moins égal à la taille du volume simple que vous voulez mettre en miroir.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Affecte une lettre de lecteur ou un point de montage au volume qui a le focus. Si aucune lettre de lecteur ou aucun point de montage n'est spécifié, la première lettre de lecteur disponible est affectée. Si la lettre de lecteur ou le point de montage est déjà utilisé, une erreur est générée.

À l'aide de la commande assign, vous pouvez changer la lettre de lecteur associée à un lecteur amovible.

Vous ne pouvez pas affecter de lettres de lecteur aux volumes système, aux volumes d'amorçage ou aux volumes qui contiennent le fichier d'échange. De plus, vous ne pouvez pas affecter de lettre de lecteur à une partition OEM (Original Equipment Manufacturer) ou à une partition GPT (GUID Partition Table) autre qu'une partition MSDATA de base.

Syntaxe

assign [{letter=d|mount=chemin}] [noerr]

Paramètres

letter=d: Lettre de lecteur que vous voulez affecter au volume.
mount=chemin: Chemin de points de montage que vous voulez affecter au volume.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

S'applique aux disques dynamiques uniquement. Scinde le volume en miroir qui a le focus en deux volumes simples. Un des volumes simples conserve la lettre de lecteur et les points de montage du volume en miroir ; l'autre volume simple reçoit le focus pour que vous puissiez lui affecter une lettre de lecteur.

Le contenu des deux moitiés du miroir sont conservées par défaut. Chaque moitié devient un volume simple. Avec le paramètre nokeep, vous ne conservez qu'une moitié du miroir en tant que volume simple, tandis que l'autre moitié est supprimée et convertie en espace disque disponible. Aucun volume ne reçoit le focus.

Syntaxe

break disk=n [nokeep] [noerr]

Paramètres

n: Spécifie le disque qui contient le volume en miroir.
nokeep: Spécifie qu'un seul des volumes en miroir est conservé tandis que l'autre est supprimé et converti en espace disque disponible. Ni le volume ni l'espace disque ne reçoit le focus.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Supprime tout formatage de partition ou de volume sur le disque qui a le focus. Sur les disques MBR (Master Boot Record), seules les informations de partitionnement MBR et les informations de secteurs cachés sont effacées. Sur les disques GPT (GUID Partition Table), les informations de partitionnement GPT, MBR protectif compris, sont effacées. Il n'y a pas d'informations de secteurs cachés.

Syntaxe

clean [all]

Paramètre

all: Spécifie que chacun des secteurs du disque est effacé, ce qui signifie que toutes les données du disques sont définitivement et entièrement supprimées.

Convertit un disque dynamique vide en disque de base.

Syntaxe

convert basic [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Convertit un disque de base en disque dynamique.

Syntaxe

convert dynamic [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Sur les ordinateurs Itanium, convertit un disque de base vide avec un style de partition MBR (Master Boot Record) en disque de base avec le style de partition GPT (GUID partition table).

Important

Le disque doit être vide pour être converti en disque GPT. Sauvegardez vos données, puis supprimez l'ensemble des partitions ou des volumes avant de convertir le disque.

Syntaxe

convert gpt [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Sur les ordinateurs Itanium, convertit un disque de base vide avec un style de partition GPT (GUID partition table) en disque de base avec le style de partition MBR (Master Boot Record).

Important

Le disque doit être vide pour être converti en disque MBR. Sauvegardez vos données, puis supprimez l'ensemble des partitions ou des volumes avant de convertir le disque.

Syntaxe

convert mbr [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Sur les ordinateurs Itanium, crée une partition système EFI (Extensible Firmware Interface) sur un disque GPT (GUID Partition Table). Après avoir créé la partition, le focus est donné à la nouvelle partition.

Syntaxe

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

Paramètres

size=n: Taille de la partition en méga-octets (Mo). Si aucune taille n'est donnée, la partition se poursuit jusqu'à ce que l'espace libre de la région en cours soit épuisé.
offset=n: Le décalage d'octet par rapport auquel créer la partition. Si aucun décalage n'est fourni, la partition se situe sur la première extension de disque suffisamment volumineuse pour l'accueillir.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée une partition étendue sur le lecteur actuel. Après avoir créé la partition, le focus se déplace automatiquement sur la nouvelle partition. Une seule partition étendue peut être créée par disque. Cette commande échoue si vous essayez de créer une partition étendue au sein d'une autre partition étendue. Vous devez créer une partition étendue avant de pouvoir créer des lecteurs logiques.

Syntaxe

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

Paramètres

size=n: Taille de la partition étendue en méga-octets (Mo). Si aucune taille n'est donnée, la partition se poursuit jusqu'à ce que l'espace libre de la région soit épuisé. La taille est ajustée aux cylindres. La taille est arrondie à la limite de cylindre la plus proche. Si, par exemple, vous spécifiez une taille de 500 Mo, la partition est arrondie à 504 Mo.
offset=n: S'applique uniquement aux disques MBR (Master Boot Record). Le décalage d'octet par rapport auquel créer la partition étendue. Si aucun décalage n'est fourni, la partition démarre au début du premier espace libre sur le disque. Le décalage est ajusté aux cylindres. Le décalage est arrondi à la limite de cylindre la plus proche. Par exemple, si vous spécifiez un décalage de 27 Mo alors que la taille du cylindre équivaut à 8 Mo, le décalage est arrondi à la limite de 24 Mo.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée un lecteur logique dans la partition étendue. Après avoir créé la partition, le focus se déplace automatiquement sur le nouveau lecteur logique.

Syntaxe

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

Paramètres

size=n: Taille du lecteur logique en méga-octets (Mo). Si aucune taille n'est donnée, la partition se poursuit jusqu'à ce que l'espace libre de la région en cours soit épuisé.
offset=n: S'applique uniquement aux disques MBR (Master Boot Record). Le décalage d'octet par rapport auquel créer le lecteur logique. Le décalage est ajusté aux cylindres (c'est-à-dire que le décalage est arrondi de manière à remplir entièrement la taille de cylindre utilisée). Si aucun décalage n'est fourni, la partition se situe sur la première extension de disque suffisamment volumineuse pour l'accueillir. La partition est au moins aussi vaste en octets que la valeur spécifiée par size=n. Si vous spécifiez une taille pour le lecteur logique, elle doit être plus petite que la partition étendue.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Sur les ordinateurs Itanium, crée une partition MSR (Microsoft Reserved) sur un disque GPT (GUID Partition Table).

Attention

Utilisez la commande create partition msr avec précaution. Étant donné que les disques GPT nécessitent un format de partition spécifique, la création de partitions MSR (Microsoft Reserved) peut rendre le disque illisible. Sur les disques GPT qui sont utilisés pour démarrer Windows XP 64-Bit Edition, la partition Système EFI est la première partition du disque, suivie de la partition MSR (Microsoft Reserved). Les disques GPT utilisés uniquement à des fins de stockage des données ne possèdent pas de partition Système EFI, et la partition MSR est la première partition.
Windows XP 64-Bit Edition ne monte pas les partitions MSR (Microsoft Reserved). Vous ne pouvez pas stocker de données sur les partitions MSR et vous ne pouvez pas les supprimer.

Syntaxe

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

Paramètres

size=n: Taille de la partition en méga-octets (Mo). La partition est au moins aussi vaste en octets que la valeur spécifiée par size=n. Si aucune taille n'est donnée, la partition se poursuit jusqu'à ce que l'espace libre de la région en cours soit épuisé.
offset=n: Le décalage d'octet par rapport auquel créer la partition. La partition démarre au décalage d'octet spécifié par offset=n. Elle est ajustée aux secteurs, c'est-à-dire que le décalage est arrondi de manière à remplir entièrement la taille de secteur utilisée). Si aucun décalage n'est fourni, la partition se situe sur la première extension de disque suffisamment volumineuse pour l'accueillir.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée une partition principale sur le disque de base actuel. Après avoir créé la partition, le focus se déplace automatiquement sur la nouvelle partition. La partition ne reçoit pas de lettre de lecteur. Vous devez utiliser la commande assign pour affecter une lettre de lecteur à la partition.

Syntaxe

create partition primary [size=n] [offset=n] [ID={octet|GUID}] [noerr]

Paramètres

size=n

Taille de la partition en méga-octets (Mo). Si aucune taille n'est donnée, la partition se poursuit jusqu'à ce que l'espace non alloué de la région en cours soit épuisé. La taille est ajustée aux cylindres. La taille est arrondie à la limite de cylindre la plus proche. Par exemple, si vous spécifiez une taille de 500 Mo, la partition est arrondie à 504 Mo.

offset=n

Le décalage d'octet par rapport auquel créer la partition. Si aucun décalage n'est fourni, la partition démarre au début du premier espace libre sur le disque. Pour les disques MBR (Master Boot Record), le décalage est ajusté aux cylindres. Le décalage est arrondi à la limite de cylindre la plus proche. Par exemple, si vous spécifiez un décalage de 27 Mo alors que la taille du cylindre équivaut à 8 Mo, le décalage est arrondi à la limite de 24 Mo.

ID={octet|GUID}

Réservé aux fabricants OEM (Original Equipment Manufacturer).

Attention

La création de partitions avec ce paramètre peut entraîner une panne de votre ordinateur ou l'empêcher de démarrer. À moins d'être vous-même un fabricant OEM ou un informaticien professionnel expérimenté en disques GPT, ne créez pas de partitions sur des disques GPT à l'aide du paramètre ID=octet | GUID. À la place, utilisez toujours la commande create partition efi pour créer des partitions système EFI, la commande create partition msr pour créer des partitions réservées Microsoft, et la commande create partition primary (sans le paramètre ID=octet | GUID) pour créer des partitions principales sur des disques GPT.

Pour les disques MBR, vous pouvez spécifier un octet de type de partition, sous forme hexadécimale, pour la partition. Si aucun octet de type de partition n'est spécifié sur un disque MBR, la commande create partition primary crée une partition de type 0x6. N'importe quel octet de type de partition peut être spécifié avec le paramètre ID=octet | GUID. DiskPart ne vérifie pas la validité de l'octet de type de partition, pas plus qu'il n'effectue de contrôle du paramètre ID.

Pour les disques GPT, vous pouvez spécifier un GUID de type de partition pour la partition que vous voulez créer :

Partition système EFI : c12a7328-f81f-11d2-ba4b-00a0c93ec93b
Partition réservée Microsoft : e3c9e316-0b5c-4db8-817d-f92df00215ae
Partition MSDATA : ebd0a0a2-b9e5-4433-87c0-68b6b72699c7
Partition LDM Metadata sur un disque dynamique : 5808c8aa-7e8f-42e0-85d2-e1e90434cfb3
Partition LDM Data sur un disque dynamique : af9b60a0-1431-4f62-bc68-3311714a69ad

Si aucun GUID de type de partition n'est spécifié, la commande create partition primary crée une partition MSDATA. N'importe quel type de partition peut être spécifié avec le paramètre ID={octet | GUID}. DiskPart ne vérifie pas la validité du GUID de partition, pas plus qu'il n'effectue de contrôle du paramètre ID.

noerr

Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée un volume RAID-5 sur les disques dynamiques spécifiés. Après avoir créé le volume, le focus se déplace automatiquement sur le nouveau volume.

Syntaxe

create volume raid [size=n] [disk=n[,[n,…]] [noerr]

Paramètres

size=n: Espace disque, spécifié en méga-octets (Mo), que le volume occupera sur chaque disque. Si vous ne spécifiez aucune taille, la commande crée le volume RAID-5 le plus vaste possible. Le disque contenant la plus petite quantité d'espace disque disponible contigu détermine la taille du volume RAID-5 et la même quantité d'espace disque est allouée à partir de chaque disque. La quantité effective d'espace disque utilisable dans le volume RAID-5 est inférieure à la quantité combinée d'espace disque car une partie de cet espace est utilisée pour la parité.
disk=n: Disques dynamiques sur lesquels vous créez le volume. Une quantité d'espace égale à size=n est allouée sur chaque disque.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée un volume simple. Après avoir créé le volume, le focus se déplace automatiquement sur le nouveau volume.

Syntaxe

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

Paramètres

size=n: Taille du volume en méga-octets (Mo). Si aucune taille n'est spécifiée, le nouveau volume occupe la totalité de l'espace disque disponible sur le disque.
disk=n: Disque dynamique sur lequel vous créez le volume. Si aucun disque n'est spécifié, le disque courant est utilisé.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Crée un volume agrégé par bande sur les disques spécifiés. Après avoir créé le volume, le focus se déplace automatiquement sur le nouveau volume.

Syntaxe

create volume stripe [size=n] [disk=n[,[n,…]] [noerr]

Paramètres

size=n: Espace disque, spécifié en méga-octets (Mo), que le volume occupera sur chaque disque. Si aucune taille n'est spécifiée, le nouveau volume occupe le reste de l'espace disque disponible sur le plus petit disque et une quantité d'espace égale sur les disques suivants.
disk=n: Disques dynamiques sur lesquels vous créez le volume. Une quantité d'espace égale à size=n est allouée sur chaque disque.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Supprime un disque dynamique manquant dans la liste des disques.

Syntaxe

delete disk [noerr] [override]

Paramètres

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.
override: Permet à DiskPart de supprimer tous les volumes simples sur le disque. Si le disque contient la moitié d'un volume en miroir, celle-ci est supprimée. La commande delete disk override échoue si le disque appartient à un volume RAID-5.

Sur un disque de base, supprime la partition qui a le focus. Vous ne pouvez pas supprimer la partition système, la partition d'amorçage ou n'importe quelle partition qui contient le fichier d'échange ou fichier de vidage sur incident (vidage de la mémoire) actif.

Attention

Supprimer une partition sur un disque dynamique peut entraîner la suppression de tous les volumes dynamiques hors connexion du disque, supprimant ainsi toutes les données et convertissant le disque en disque de base. Pour supprimer un volume dynamique, utilisez toujours la commande delete volume à la place.

Les partitions peuvent être supprimées sur les disques dynamiques, mais elles ne doivent pas être créées. Par exemple, il est possible de supprimer une partition GPT (GUID Partition Table) non reconnue sur un disque GPT dynamique. La suppression d'une partition de ce type ne transforme pas l'espace disque libre qui en résulte en espace disponible. Cette commande vise notamment à permettre de récupérer l'espace occupé par un disque dynamique hors connexion et corrompu dans une situation d'urgence où la commande clean ne peut pas être utilisée.

Syntaxe

delete partition [noerr] [override]

Paramètres

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.
override: Permet à DiskPart de supprimer n'importe quelle partition, quel qu'en soit le type. En règle générale, DiskPart vous permet uniquement de supprimer des partitions de données connues.

Supprime le volume sélectionné. Vous ne pouvez pas supprimer le volume système, le volume d'amorçage ou n'importe quel volume contenant le fichier d'échange actif ou fichier de vidage sur incident (vidage de la mémoire).

Syntaxe

delete volume [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Affiche les propriétés du disque sélectionné et les volumes présents sur ce disque.

Syntaxe

detail disk

Affiche les disques sur lesquels le volume courant réside.

Syntaxe

detail volume

Permet de quitter l'interpréteur de commande DiskPart.

Syntaxe

exit

Étend le volume qui a le focus à l'espace non alloué et contigu du même disque. Pour les volumes de base, l'espace non alloué doit se trouver sur le même disque, et doit suivre la partition qui a le focus (être d'un décalage de secteur supérieur). Un volume dynamique simple ou fractionné peut être étendu à n'importe quel espace vide sur n'importe quel disque dynamique. Cette commande vous permet d'étendre un volume existant à un espace nouvellement créé.

Si la partition était précédemment formatée à l'aide du système de fichiers NTFS, le système de fichier est automatiquement étendu à la totalité de la nouvelle partition, plus vaste. Il ne se produit aucune perte de données. Si la partition était précédemment formatée avec un système de fichiers différent de NTFS, la commande échoue et aucune modification n'est apportée à la partition.

Vous ne pouvez pas étendre les partitions système ou d'amorçage actuelles.

Syntaxe

extend [size=n] [disk=n] [noerr]

Paramètres

size=n: Quantité d'espace, en méga-octets (Mo), à ajouter à la partition actuelle. Si vous ne spécifiez pas de taille, le disque est étendu à l'ensemble de l'espace non alloué contigu.
disk=n: Disque dynamique sur lequel vous étendez le volume. Une quantité d'espace égale à size=n est allouée sur le disque. Si vous ne spécifiez aucun disque, le volume est étendu sur le disque courant.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Affiche la liste des commandes disponibles.

Syntaxe

help

Importe un groupe de disques étrangers dans le groupe de disques de l'ordinateur local. La commande import importe chaque disque qui est dans le même groupe que le disque qui a le focus.

Syntaxe

import [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Affiche la liste des disques et des informations sur ces disques, telles que leur taille, leur quantité d'espace disque disponible, leur type (de base ou dynamique) et si le disque utilise le style de partition MBR (Master Boot Record) ou GPT (GUID partition table). Le disque marqué d'un astérisque (*) a le focus.

Syntaxe

list disk

Affiche les partitions répertoriées dans la table de partition du disque courant. Sur les disques dynamiques, ces partitions peuvent ne pas correspondre aux volumes dynamiques du disque. Cette incohérence s'explique par le fait que les disques dynamiques contiennent des entrées dans la table de partition pour le volume système ou le volume d'amorçage (le cas échéant) ainsi qu'une partition qui occupe le reste du disque pour réserver l'espace à l'usage des volumes dynamiques.

Syntaxe

list partition

Affiche la liste des volumes de base et dynamiques de tous les disques.

Syntaxe

list volume

Met en ligne un disque ou un volume hors connexion qui a le focus.

Syntaxe

online [noerr]

Paramètre

noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Permet à l'utilisateur d'insérer un commentaire dans un script.

Syntaxe

rem

Exemples

rem Ces commandes configurent 3 lecteurs.

create partition primary size=2048

assign d:

create partition extended

create partition primary size=2048

assign e:

create partition logical

assign f:

Supprime une lettre de lecteur ou un point de montage dans le volume qui a le focus. Si le paramètre all est utilisé, toutes les lettres de lecteur et tous les points de montage courants sont supprimés. Si aucune lettre de lecteur ou point de montage n'est spécifié, DiskPart supprime la première lettre de lecteur ou le premier point de montage qu'il rencontre.

La commande remove peut être utilisée pour changer la lettre de lecteur associée à un lecteur amovible. Vous ne pouvez pas supprimer les lettres de lecteur sur les volumes système, d'amorçage ou d'échange. De plus, vous ne pouvez pas supprimer la lettre de lecteur d'une partition OEM, d'une partition GPT dont le GUID n'est pas reconnu, de toute partition GPT non données spéciale telle que la partition système EFI.

Syntaxe

remove [{letter=d|mount=chemin [all]}] [noerr]

Paramètres

letter=d: La lettre de lecteur à supprimer.
mount=chemin: Le point de montage à supprimer.
all: Supprime toutes les lettres de lecteur et tous les points de montage courants.
noerr: Pour script uniquement. En cas d'erreur, spécifie que DiskPart continue à traiter les commandes comme si l'erreur ne s'était pas produite. Sans le paramètre noerr, la détection d'une erreur entraîne la fermeture de DiskPart et l'affichage d'un code d'erreur.

Repère les nouveaux disques qui peuvent avoir été ajoutés dans l'ordinateur.

Syntaxe

rescan

Prépare un volume simple dynamique existant à être utilisé en tant que volume système ou d'amorçage.

Sur un ordinateur x86, crée une entrée de partition dans le MBR (Master Boot Record) du volume simple dynamique qui a le focus. Pour créer une partition MBR, le volume simple dynamique doit démarrer à un décalage ajusté aux cylindres et avoir une taille égale à un nombre entier de cylindres.

Sur un ordinateur Itanium, crée une entrée de partition dans le GPT (GUID Partition Table) du volume simple dynamique qui a le focus.

Remarque

La commande retain est destinée à être utilisée uniquement au cours d'installations sans assistance ou par les OEM (Original Equipment Manufacturers).

Syntaxe

retain

Sélectionne le disque spécifié en lui donnant le focus.

Syntaxe

select disk=[n]

Paramètres

n: Numéro du disque qui recevra le focus. Si aucun numéro de disque n'est spécifié, la commande select répertorie le disque qui possède actuellement le focus. Vous pouvez afficher les numéros de tous les disques de l'ordinateur à l'aide de la commande list disk.

Sélectionne la partition spécifiée et lui donne le focus. Si aucune partition n'est spécifiée, la commande select répertorie la partition qui possède actuellement le focus. Vous pouvez afficher les numéros de toutes les partitions du disque courant à l'aide de la commande list partition.

Syntaxe

select partition=[{n|d}]

Paramètres

n: Numéro de la partition qui recevra le focus.
d: La lettre de lecteur ou le chemin de points de montage de la partition qui recevra le focus.

Sélectionne le volume spécifié en lui donnant le focus. Si aucun volume n'est spécifié, la commande select répertorie le volume qui possède actuellement le focus. Vous pouvez spécifier le volume par numéro, par lettre de lecteur ou par chemin de points de montage. Sur un disque de base, sélectionner un volume donne également le focus à la partition correspondante. Vous pouvez afficher les numéros de tous les volumes de l'ordinateur à l'aide de la commande list volume.

Syntaxe

select volume=[{n|d}]

Paramètres

n: Numéro du volume qui recevra le focus.
d: La lettre de lecteur ou le chemin de points de montage du volume qui recevra le focus.

Scripts DiskPart

DiskPart vous permet de créer des scripts pour automatiser les tâches, comme créer des volumes ou convertir les disques en disques dynamiques. La mise en script de ces tâches est utile si vous déployez Windows à l'aide du programme d'installation sans assistance ou de Sysprep, qui ne prennent pas en charge la création de volumes autres que le volume d'amorçage.

Où nomjournal.txt est le nom du fichier de texte de destination de la sortie du script de DiskPart.

Lorsque DiskPart démarre, la version de DiskPart et le nom de l'ordinateur figurent dans l'invite de commande. Par défaut, si DiskPart rencontre une erreur en essayant d'effectuer une tâche du script, DiskPart arrête le traitement du script et affiche un code d'erreur (sauf si vous spécifiez le paramètre noerr). Sachez toutefois que DiskPart renvoie toujours les erreurs de syntaxe qu'il rencontre, que vous spécifiiez le paramètre noerr ou non. Le paramètre noerr vous permet d'effectuer des tâches utiles comme utiliser un seul script pour supprimer toutes les partitions de tous les disques, quel qu'en soit le nombre.

Erreur	Description
0	Aucune erreur ne s'est produite. La totalité du script s'est exécutée sans erreur.
1	Une exception fatale s'est produite. Il peut y avoir un problème sérieux.
2	Les paramètres spécifiés pour une commande DiskPart étaient incorrects.
3	DiskPart n'a pas réussi à ouvrir le script ou le fichier de sortie spécifié.
4	Un des services utilisés par DiskPart a renvoyé une erreur.
5	Une erreur de syntaxe de commande s'est produite. Le script a échoué car un objet a été sélectionné par erreur ou ne pouvait pas être utilisé avec cette commande.