VBoxManage storageattach |
Entreposage d'attachement |
|---|---|
| VirtualBox | |
Syntaxe
| VBoxManage storageattach uuid|vmname --storagectl name [--port number] [--device number] [--type dvddrive|hdd|fdd] [--medium none|emptydrive| uuid|filename|host:drive|iscsi] [--mtype normal|writethrough|immutable|shareable| readonly|multiattach] [--comment text] [--setuuid uuid] [--setparentuuid uuid] [--passthrough on|off] [--tempeject on|off] [--nonrotational on|off] [--bandwidthgroup name] [--forceunmount] [--server name|ip] [--target target] [--tport port] [--lun lun] [--encodedlun lun] [--username username] [--password password] [--intnet] |
Paramètres
| Nom | Description | |
|---|---|---|
| uuid | Ce paramètre permet d'indiquer le nom (sensible à la casse) d'une machine virtuelle. Ce paramètre ou vmname est obligatoire. | |
| vmname | Ce paramètre permet d'indiquer l'UUID d'une machine virtuelle. Ce paramètre ou uuid est obligatoire. | |
| --storagectl | Ce paramètre permet d'indiquer le nom du contrôleur d'entreposage. Obligatoire. La liste des contrôleurs d'entreposage actuellement attachés à une machine virtuelle peut être obtenue avec VBoxManage showvminfo. | |
| --port | Ce paramètre permet d'indiquer le numéro de port du contrôleur d'entreposage à modifier. Obligatoire, sauf si le contrôleur d'entreposage n'a qu'un seul port. | |
| --device | Ce paramètre permet d'indiquer le numéro du périphérique du port devant être modifié. Obligatoire, sauf si le contrôleur d'entreposage n'a qu'un seul périphérique par port. | |
| --type | Ce paramètre permet de définir le type d'unité de disque auquel le média est connecté, détaché ou modifié. Ce paramètre ne peut être omis que si le type de média peut être déterminé à partir du média fourni avec le paramètre --medium ou d'une pièce jointe de média précédente. | |
| --medium | Ce paramètre permet d'indiquer les médias pouvant être joint. Les valeurs suivantes sont prises en charge : | |
| Valeur | Description | |
| none | Cette valeur permet d'indiquer que tout périphérique existant doit être supprimé de l'emplacement donné. | |
| emptydrive | Cette valeur permet d'unité vide. Elle indique un DVD virtuel ou un unité de disquette uniquement et elle fait que l'emplacement de périphérique se comporte comme un unité amovible dans lequel aucun support n'a été inséré. | |
| additions | Cette valeur permet d'indiquer un unité de DVD virtuel uniquement, elle attache l'image VirtualBox Guest Additions à l'emplacement de périphérique donné. Si un UUID est spécifié, il doit s'agir de l'UUID d'un média d'entreposage déjà connu de VirtualBox. Par exemple, parce qu'il a été attaché à une autre machine virtuelle. Ce média est ensuite attaché à l'emplacement de périphérique donné. Si un nom de fichier est spécifié, il doit s'agir du chemin complet d'une image disque existante au format ISO, RAW, VDI, VMDK ou autre. L'image disque est ensuite attachée à l'emplacement de périphérique donné. | |
| host:drive | Ce paramètre permet d'indiquer, pour un DVD virtuel ou une unité de disquette uniquement, qu'elle connecte l'emplacement de périphérique donné au unité de DVD ou de disquette spécifié sur l'ordinateur hôte. | |
| iscsi | Ce paramètre permet d'indiquer, pour les disques durs virtuels uniquement, une cible iSCSI. Dans ce cas, des paramètres supplémentaires doivent être fournis. | |
| --mtype | Ce paramètre permet de définir le comportement de ce média en ce qui concerne les instantanés et les opérations d'écriture. | |
| --comment | Ce paramètre permet d'indiquer une description facultative que vous souhaitez entreposer avec ce média. | |
| --setuuid | Ce paramètre permet de modifier l'UUID d'un média avant de l'attacher à une machine virtuelle. C'est une option experte. Une utilisation inappropriée peut rendre le média inutilisable ou entraîner des configurations de la machine virtuelle défectueuses si une autre machine virtuelle fait déjà référence au même média. La variante la plus fréquemment utilisée est --setuuid "", attribuant un nouvel UUID aléatoire à une image. Cette option est utile pour résoudre les erreurs UUID dupliquées si vous avez dupliqué une image à l'aide d'un utilitaire de copie de fichiers. | |
| --setparentuuid | Ce paramètre permet de modifier l'UUID parent d'un média avant de l'attacher à une machine virtuelle. C'est une option experte. Une utilisation inappropriée peut rendre le média inutilisable ou entraîner des configurations de la machine virtuelle défectueuses si une autre machine virtuelle fait déjà référence au même média. La variante la plus fréquemment utilisée est --setuuid "", attribuant un nouvel UUID aléatoire à une image. Cette option est utile pour résoudre les erreurs UUID dupliquées si vous avez dupliqué une image à l'aide d'un utilitaire de copie de fichiers. | |
| --passthrough | Ce paramètre permet, pour un unité de DVD virtuel uniquement, d'activer la prise en charge de l'écriture de DVD. | |
| --tempeject | Ce paramètre permet, pour un unité de DVD virtuel uniquement, de configurer le comportement de l'éjection de média déclenchée par l'invité. Si cette option est activée, l'éjection n'a qu'un effet temporaire. Si la machine virtuelle est mise hors tension et redémarrée, le média configuré à l'origine sera toujours dans l'unité. | |
| --nonrotational | Ce paramètre permet d'activer le drapeau de non-rotation pour les disques durs virtuels. Certains invités, tels que Windows 7 ou version ultérieure, traitent ces disques comme des SSD et n'effectuent pas de fragmentation de disque sur de tels médias. | |
| --discard | Ce paramètre permet d'activer la fonction de suppression automatique pour un disque dur virtuel. Il spécifie qu'une image VDI sera réduite en réponse à la commande trim du système d'exploitation invité. Les conditions suivantes doivent être remplies : le format du disque doit être VDI, la taille de la zone effacée doit être d'au moins 1 Mo, le VirtualBox ne réduira que des blocs entiers de 1 Mo. Les VDI eux-mêmes sont organisés en blocs de 1 Mo, donc cela ne fonctionnera que si l'espace en cours de découpage est au moins un bloc contigu de 1 Mo à une limite de 1 Mo. Sous Windows, une défragmentation occasionnelle avec defrag.exe /D, ou sous Linux exécutant la commande btrfs filesystem defrag en tant que tâche cron en arrière-plan peut être bénéfique. | |
| --bandwidthgroup | Ce paramètre permet de définir le groupe de bande passante à utiliser pour le périphérique donné. | |
| --forceunmount | Ce paramètre permet d'indiquer, pour un DVD virtuel ou un unité de disquette uniquement, de forcer à démonter le DVD/CD/Disquette ou a monter un nouveau DVD/CD/Disquette même si le précédent est verrouillé par l'invité pour la lecture. | |
| --server | Ce paramètre permet d'indiquer le nom d'hôte ou l'adresse IP de la cible iSCSI. Ce paramètre est obligatoire. | |
| --target | Ce paramètre permet d'indiquer la chaîne de caractères du nom de la cible. Il est déterminé par la cible iSCSI et il est utilisé pour identifier la ressource d'entreposage. Ce paramètre est obligatoire. | |
| --tport | Ce paramètre permet d'indiquer le numéro de port TCP/IP du service iSCSI sur la cible. Ce paramètre est obligatoire. | |
| --lun | Ce paramètre permet d'indiquer le numéro d'unité logique de la ressource cible. Ce paramètre est optionnel. Souvent, cette valeur est égale à zéro. | |
| --encodedlun | Ce paramètre permet d'indiquer le numéro d'unité logique codé en hexadécimal de la ressource cible. Ce paramètre est optionnel. Souvent, cette valeur est égale à zéro. | |
| --username | Ce paramètre permet d'indiquer le nom d'utilisateur, appelés secret de l'initiateur, pour l'authentification de la cible, si nécessaire. Ce paramètre est optionnel. | |
| --password | Ce paramètre permet d'indiquer le mot de passe, appelés secret de l'initiateur, pour l'authentification de la cible, si nécessaire. Ce paramètre est optionnel. | |
| --passwordfile | Ce paramètre permet d'indiquer le mot de passe dans un fichier, appelés secret de l'initiateur, pour l'authentification de la cible, si nécessaire. Ce paramètre est optionnel. | |
| --initiator | Ce paramètre permet d'indiquer l'initiateur iSCSI. Ce paramètre est optionnel. | |
| --intnet | Ce paramètre permet d'indiquer qu'il faut se connecter à la cible iSCSI à l'aide du réseau interne. | |
Description
Cette commande permet d'attacher, modifier ou d'enlever un média connecté à un contrôleur d'entreposage précédemment ajouter par la commande storagectl.
Remarques
- Certaines des modifications du paramètre --medium, en particulier pour les supports amovibles tels que les disquettes et les CD/DVD, peuvent être effectuées pendant qu'une machine virtuelle est en cours d'exécution. D'autres, tels que les changements de périphérique ou les changements dans les logements de périphérique de disque dur, nécessitent que la machine virtuelle soit mise hors tension.
- Dans le cas d'un paramètre --discard, le système d'exploitation invité doit être configuré pour émettre la commande trim, ce qui signifie généralement que le système d'exploitation invité est conçu pour voir le disque comme un SSD. L'Ext4 prend en charge le drapeau de montage -o discard. Le Mac OS X nécessite probablement des paramètres supplémentaires. Le système d'exploitation Windows devrait détecter et prendre en charge automatiquement les SSD, au moins dans les versions 7, 8 et 10. Le pilote Linux exFAT de Samsung prend en charge la commande trim.
- Pour le paramètre --discard, on ne sait pas si la mise en oeuvre d'exFAT par Microsoft prend en charge cette fonctionnalité, même si ce système de fichiers a été initialement conçu pour Flash. Alternativement, il existe d'autres méthodes pour émettre un trim. Par exemple, la commande fstrim de Linux, faisant partie du paquet util-linux. Les solutions antérieures exigeaient d'un utilisateur de mettre à zéro les zones inutilisées, en utilisant zéro libre ou similaire, et de compacter le disque. Cela n'est possible que lorsque la machine virtuelle est hors ligne.
- Lorsque iscsi est utilisé avec le paramètre --medium pour la prise en charge d'iSCSI, des paramètres supplémentaires doivent ou peuvent être utilisés.
- Le nom d'utilisateur et le mot de passe sont entreposés sans cryptage, en texte clair, dans le fichier de configuration de la machine XML si aucun mot de passe de paramètres n'est fourni. Lorsqu'un mot de passe de paramètres est spécifié pour la première fois, le mot de passe est entreposé sous forme cryptée. Au lieu de fournir le mot de passe sur la ligne de commande, une référence à un fichier contenant le texte peut être fournie à l'aide du paramètre --passwordfile.
- L'initiateur Microsoft iSCSI est un système, tel qu'un serveur se connectant à un réseau IP et initie des demandes et reçoit des réponses d'une cible iSCSI. Les composantes SAN de Microsoft iSCSI Initiator sont en grande partie analogues aux composantes SAN Fibre Channel et comprennent les éléments suivants : pour transporter des blocs de commandes iSCSI sur le réseau IP, un pilote iSCSI doit être installé sur l'hôte iSCSI. Un pilote iSCSI est inclus avec l'initiateur Microsoft iSCSI. Un adaptateur Gigabit Ethernet transmettant 1000 mégabits par seconde (Mbps) est recommandé pour la connexion à une cible iSCSI. Comme les adaptateurs 10/100 standard, la plupart des adaptateurs Gigabit utilisent un câble préexistant de catégorie 5 ou 6E. Chaque port de l'adaptateur est identifié par une adresse IP unique. Une cible iSCSI est tout périphérique qui reçoit des commandes iSCSI. Le périphérique peut être un noeud d'extrémité, tel qu'un périphérique d'entreposage, ou il peut être un périphérique intermédiaire, tel qu'un pont réseau entre les périphériques IP et Fibre Channel. Chaque port du contrôleur de la matrice d'entreposage ou du pont réseau est identifié par une ou plusieurs adresses IP.
Voir également
Articles - Virtualisation
Article - Les géants de l'informatique - Oracle
Dernière mise à jour : Samedi, le 3 octobre 2015