Les commandes vmrun sont divisées en catégories de fonction.

Les tableaux suivants répertorient les commandes et paramètres vmrun pour Fusion selon leur fonction. Les paramètres sont répertoriés un par ligne. Les paramètres entre crochets sont facultatifs. La barre verticale indique un choix de mot clé.

Commandes et paramètres d'alimentation vmrun

Option Paramètres Description
start

chemin d'accès au fichier .vmx

[ gui | nogui ]

Démarre une machine virtuelle. L'option gui par défaut démarre la machine de manière interactive, ce qui est requis pour afficher l'interface de Fusion. L'option.nogui supprime l'interface de Fusion, notamment la boîte de dialogue démarrage, pour autoriser les scripts non interactifs.
Note : Pour démarrer les machines virtuelles chiffrées, utilisez l'indicateur nogui. L'utilitaire vmrun ne prend pas en charge le mode interface utilisateur graphique avec des machines virtuelles chiffrées.
stop

chemin d'accès au fichier .vmx

[ hard | soft ]

Arrête une machine virtuelle. Utilisez l'option soft pour mettre hors tension l'invité après l'exécution de scripts d'arrêt. Utilisez l'option hard pour mettre hors tension l'invité sans exécuter de scripts, comme si vous aviez appuyé sur le bouton d'alimentation. La valeur par défaut est d'utiliser la valeur powerType spécifiée dans le fichier .vmx, s'il est- présent.

reset

chemin d'accès au fichier .vmx

[ hard | soft ]

Réinitialise une machine virtuelle. Utilisez l'option soft pour exécuter des scripts d'arrêt avant de redémarrer l'invité. Utilisez l'option hard pour redémarrer l'invité sans exécuter de scripts, comme si vous aviez appuyé sur le bouton Réinitialiser. La valeur par défaut est d'utiliser la valeur powerType spécifiée dans le fichier .vmx, s'il est- présent.

suspend

chemin d'accès au fichier .vmx

[ hard | soft ]

Suspend une machine virtuelle sans l'arrêter, afin qu'un travail local puisse reprendre plus tard. L'option soft interrompt l'invité après l'exécution de scripts système. Sur des invités Windows, ces scripts diffusent l'adresse IP. Sur des invités Linux, les scripts interrompent la mise en réseau. L'option hard interrompt l'invité sans exécuter les scripts. La valeur par défaut est d'utiliser la valeur powerType spécifiée dans le fichier .vmx, s'il est- présent.

Pour reprendre les opérations de machine virtuelle après la fin de la commande suspend, utilisez la commande start. Sous Windows, l'adresse IP est récupérée. Sous Linux, la mise en réseau est redémarrée.

pause

chemin d'accès au fichier .vmx

Interrompt une machine virtuelle.

unpause

chemin d'accès au fichier .vmx

Reprend les opérations d'une machine virtuelle là où vous aviez interrompu les opérations normales.

Commandes et paramètres de snapshot vmrun

Option Paramètres Description
listSnapshots

chemin d'accès au fichier .vmx

[ showtree ]

Répertorie tous les snapshots d'une machine virtuelle. L'option showtree affiche les snapshots dans un format d'arborescence, avec enfants en retrait sous leur parent.

snapshot

chemin d'accès au fichier .vmx

nom du snapshot

Crée un snapshot d'une machine virtuelle. Comme Fusion prend en charge plusieurs snapshots, vous devez fournir le nom du snapshot.

Comme la barre oblique définit les noms de chemin d'accès, n'utilisez pas le caractère barre oblique dans un nom de snapshot. Sinon, la spécification ultérieure du chemin du snapshot devient difficile.

deleteSnapshot

chemin d'accès au fichier .vmx

nom du snapshot

[ andDeleteChildren ]

Supprime un snapshot d'une machine virtuelle. Comme Fusion prend en charge plusieurs snapshots, vous devez fournir le nom du snapshot. La machine virtuelle doit être mise hors tension ou interrompue. Si le snapshot possède des enfants, ils deviennent enfants du parent du snapshot supprimé, et les snapshots ultérieurs continuent comme précédemment à partir de la fin de la chaîne.

L'option andDeleteChildren supprime le snapshot spécifié et ses enfants récursivement.

Voir revertToSnapshot pour résoudre les conflits de nom.
revertToSnapshot

chemin d'accès au fichier .vmx

nom du snapshot

ou

chemin d'accès au fichier .vmx

Snapshot/"Snapshot 2"/"Snapshot N »

Définit la machine virtuelle sur son état au moment du snapshot. Cependant, si la machine virtuelle a été mise sous tension au moment du snapshot, vmrun revient à un état interrompu, mais ne relance pas l'exécution de la machine virtuelle.

Si un snapshot a un nom unique au sein d'une machine virtuelle, revenez à ce snapshot en spécifiant le chemin d'accès au fichier de configuration de la machine virtuelle et le nom unique du snapshot.

Si plusieurs snapshots ont le même nom, spécifiez le snapshot en y incluant son chemin d'accès complet. Un chemin d'accès est une série de noms de snapshot, séparés par des caractères de barre oblique (/). Chaque nom spécifie un nouveau snapshot dans l'arborescence. Par exemple, le nom du chemin Snap1/Snap2 identifie un snapshot nommé Snap2 qui a été pris à partir de l'état d'un snapshot nommé Snap1.

Commandes et paramètres d'un adaptateur réseau vmrun

Seul Fusion Pro prend en charge les commandes d'adaptateur réseau

Option Paramètres Description
listNetworkAdapters

chemin d'accès au fichier .vmx

Répertorie les adaptateurs réseau dans une machine virtuelle.

addNetworkAdapter

chemin d'accès au fichier .vmx

Type d'adaptateur réseau

[ Host nework ]

Ajoute un adaptateur réseau à une machine virtuelle.

Note : Le type d'adaptateur réseau peut être nat, hostOnly, bridged ou custom Lorsque l'adaptateur réseau est nat, hostOnly ou bridged, le paramètre Host nework n'est pas requis. Vous devez spécifier une valeur pour le paramètre custom uniquement lorsque le type d'adaptateur réseau est Host nework. Par exemple, vmrun addNetworkAdapter fichier .vmx custom vmnet3.

Vous devez nommer un réseau virtuel personnalisé avec l'un des noms répertoriés dans la section Personnalisé du panneau Paramètres réseau de la machine virtuelle ou du panneau Préférences réseau Fusion .

.
setNetworkAdapter

chemin d'accès au fichier .vmx

Index d'adaptateur réseau

Type d'adaptateur réseau

[ Host nework ]

Met à jour un adaptateur réseau dans une machine virtuelle.

Note : Le type d'adaptateur réseau peut être nat, hostOnly, bridged ou custom Lorsque l'adaptateur réseau est nat, hostOnly ou bridged, le paramètre Host nework n'est pas requis. Vous devez spécifier une valeur pour le paramètre custom uniquement lorsque le type d'adaptateur réseau est Host nework. Par exemple, vmrun addNetworkAdapter fichier .vmx custom vmnet3.

Vous devez nommer un réseau virtuel personnalisé avec l'un des noms répertoriés dans la section Personnalisé du panneau Paramètres réseau de la machine virtuelle ou du panneau Préférences réseau Fusion .

deleteNetworkAdapter

chemin d'accès au fichier .vmx

Index d'adaptateur réseau

Supprime un adaptateur réseau d'une machine virtuelle.

Commandes et paramètres de réseau hôte vmrun

Seul Fusion Pro prend en charge les commandes de réseau hôte.

Option Paramètres Description
listHostNetworks

Répertorie tous les réseaux sur l'hôte.

listPortForwardings

nom du réseau hôte

Répertorie tous les transferts de port disponibles sur un réseau hôte.

setPortForwarding

nom du réseau hôte

protocole

port de l'hôte

ip de l'invité

port de l'invité

[Description]

Définit un transfert de port sur un réseau hôte.

Note : Pour éviter que la commande ne renvoie une erreur, utilisez l'utilitaire sudo avec cette option. Par exemple, sudo vmrun setPortForwarding.
deletePortForwarding

nom du réseau hôte

protocole

port de l'hôte

Supprime un transfert de port sur un réseau hôte.

Note : Pour éviter que la commande ne renvoie une erreur, utilisez l'utilitaire sudo avec cette option. Par exemple, sudo vmrun deletePortForwarding.

Commandes et paramètres du système d'exploitation invité vmrun

Le délai d'expiration, attente de VMware Tools, est de cinq minutes pour toutes les commandes associées à l'invité.

Option Paramètres Description
runProgramInGuest

chemin d'accès au fichier .vmx

[ -noWait | -activeWindow | -interactive ]

nom du programme

[ arguments du programme ]

Exécute un programme spécifié dans le système d'exploitation invité. L'option -noWait renvoie une invite immédiatement après le démarrage du programme dans l'invité, plutôt que d'attendre qu'il se termine. Cette option est utile pour les programmes interactifs. Cette -activeWindow option garantit que l’interface utilisateur graphique de Windows est visible, pas réduite. Elle n'a aucun effet sous Linux. L'option -interactive force la connexion interactive de l'invité. L'option est utile pour Windows Vista et Windows 7 ou invités de version ultérieure pour rendre le programme visible dans la fenêtre de console. Vous devez fournir le chemin d'accès complet d'un programme accessible par l'invité. Fournissez également des noms de chemin entièrement accessibles pour tous les fichiers spécifiés dans les arguments du programme, conformément aux exigences de ce dernier. VMware Tools et une connexion d'invité valide sont requis.

fileExistsInGuest

chemin d'accès au fichier .vmx

Vérifie si le fichier spécifié existe dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis.

directoryExistsInGuest

chemin d'accès au fichier .vmx

chemin d'accès du répertoire sur l'invité

Vérifie si le répertoire spécifié existe dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis.

setSharedFolderState

chemin d'accès au fichier .vmx

nom du partage

chemin d'accès au dossier sur l'hôte

writable | readonly

Modifie l'état d'accessibilité en écriture d'un dossier spécifié partagé entre l'hôte et une machine virtuelle invitée. La valeur du paramètre nom de partage est un point de montage dans le système de fichiers invité. La valeur du paramètre chemin d'accès au dossier sur l'hôte est le répertoire exporté sur l'hôte. Pour rendre un dossier partagé accessible en écriture ou en lecture seule, incluez le paramètre writable ou readonly.
addSharedFolder

chemin d'accès au fichier .vmx

nom du partage

chemin d'accès au dossier sur l'hôte

Ajoute un dossier à partager entre l'hôte et l'invité. La machine virtuelle doit être en cours d'exécution pour que l'option addSharedFolder soit effective. La valeur du paramètre nom de partage est un point de montage dans le système de fichiers invité. La valeur du paramètre chemin d'accès au dossier sur l'hôte est le répertoire exporté sur l'hôte. Sur des invités Windows, un retard peut se produire avant que les dossiers partagés ne soient visibles par les options runProgramInGuest, fileExistsInGuest et directoryExistsInGuest.

removeSharedFolder

chemin d'accès au fichier .vmx

nom du partage

Supprime l’accès à un dossier partagé sur l’hôte de la machine virtuelle invité. La machine virtuelle doit être en cours d'exécution pour que l'option removeSharedFolder soit effective. La valeur du paramètre nom de partage est un point de montage dans le système de fichiers invité.

enableSharedFolders

chemin d'accès au fichier .vmx

[runtime]

Permet à la machine virtuelle invitée, spécifiée par le fichier .vmx, de partager des dossiers avec son hôte. Après activation, exécutez l'option addSharedFolder pour spécifier chaque dossier d'hôte à partager. L'argument facultatif [runtime] limite le partage de dossiers jusqu'à ce que la machine virtuelle soit hors tension. Sinon, le paramètre persiste lors la prochaine mise sous tension.
Note : L'option enableSharedFolders prend effet après l'arrêt et le redémarrage de l'invité. Aucun message d'erreur ne s'affiche.
disableSharedFolders

chemin d'accès au fichier .vmx

[runtime]

Empêche la machine virtuelle invitée, spécifiée par le fichier .vmx de partager des dossiers avec son hôte. L'argument facultatif [runtime] limite l'arrêt appliqué au partage de dossiers jusqu'à ce que la machine virtuelle soit hors tension. Dans le cas contraire, le paramètre persiste lors de la mise sous tension suivante.
Note : L'option disableSharedFolders prend effet après l'arrêt et le redémarrage de l'invité. Aucun message d'erreur ne s'affiche.
listProcessesInGuest

chemin d'accès au fichier .vmx

Répertorie tous les processus s'exécutant dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

killProcessInGuest

chemin d'accès au fichier .vmx

ID de processus

Arrête un processus spécifié dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. L'ID de processus peut être n'importe quel nombre indiqué après pid = dans la sortie de l'option listProcessesInGuest.

runScriptInGuest

chemin d'accès au fichier .vmx

[ -noWait | -activeWindow | -interactive ]

chemin d'accès de l'interprète

texte du script

Exécute le script de commande spécifié dans le système d'exploitation invité. Reportez-vous à l'entrée runProgramInGuest pour une explication des options. L'option chemin d'accès de l'interprète exécute le script. Fournissez le texte complet du script, pas un nom de fichier. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.
deleteFileInGuest

chemin d'accès au fichier .vmx

chemin d'accès au fichier sur l'invité

Supprime le fichier donné à partir du système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

createDirectoryInGuest

chemin d'accès au fichier .vmx

chemin d'accès du répertoire sur l'invité

Crée le répertoire spécifié dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

deleteDirectoryInGuest

chemin d'accès au fichier .vmx

chemin d'accès du répertoire sur l'invité

Supprime le répertoire spécifié dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité

createTempfileInGuest

chemin d'accès au fichier .vmx

Crée un fichier temporaire dans le système d'exploitation invité et renvoie le nom du chemin d'accès du fichier temporaire créé. Le nom du chemin d'accès varie en fonction du système d'exploitation. Vous pouvez exécuter l'option deleteFileInGuest pour supprimer le fichier. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

listDirectoryInGuest

chemin d'accès au fichier .vmx

chemin d'accès du répertoire sur l'invité

Répertorie le contenu du répertoire spécifié dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

CopyFileFromHostToGuest

chemin d'accès au fichier .vmx

chemin d'accès sur l'hôte

chemin d'accès dans l'invité

Copie un fichier de l'hôte vers le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. Spécifiez le nom de fichier source ou le nom de fichier d'hôte, avant le nom du fichier de destination ou le nom de fichier d'invité.

CopyFileFromGuestToHost

chemin d'accès au fichier .vmx

chemin d'accès dans l'invité

chemin d'accès sur l'hôte

Copie un fichier du système d'exploitation invité vers l'hôte. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. Spécifiez le nom du fichier source, ou nom de fichier d'invité, avant le nom du fichier de destination, ou nom de fichier d'hôte.

renameFileInGuest

chemin d'accès au fichier .vmx

nom de fichier d'origine

nouveau nom de fichier

Renomme ou déplace un fichier dans le système d'exploitation invité. VMware Tools et une connexion d'invité valide sont requis. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. Spécifiez le nom de fichier source, ou nom de fichier d'origine, avant le nom du fichier de destination.

connectNamedDevice

chemin d'accès au fichier .vmx

nom du périphérique

Connecte le périphérique nommé dans la commande au système d'exploitation invité. Vous pouvez uniquement exécuter cette commande lorsque la machine virtuelle est sous tension. Vous pouvez utiliser des noms de périphériques, tels que sound, serial0, Ethernet0, sata0:1, etc.

Note : Après l'utilisation de la commande vmrun connectNamedDevice pour connecter un périphérique audio déconnecté à une machine virtuelle en cours d'exécution, la mise hors tension de la machine virtuelle peut déconnecter le périphérique audio de la machine virtuelle, même si les paramètres de la machine virtuelle indiquent que le périphérique audio est connecté.
disconnectNamedDevice

chemin d'accès au fichier .vmx

nom du périphérique

Déconnecte le périphérique nommé dans la commande du système d'exploitation invité. Vous pouvez uniquement exécuter cette commande lorsque la machine virtuelle est sous tension. Vous pouvez utiliser des noms de périphériques, tels que sound, serial0, Ethernet0, sata0:1, etc.

Note : Après l'utilisation de la commande vmrun disconnectNamedDevice pour déconnecter un périphérique audio connecté d'une machine virtuelle en cours d'exécution, la mise hors tension de la machine virtuelle peut reconnecter le périphérique audio à la machine virtuelle, même si les paramètres de la machine virtuelle indiquent que le périphérique audio est déconnecté.
captureScreen

chemin d'accès au fichier .vmx

chemin de sortie sur l'hôte

Capture l'écran de la machine virtuelle dans un fichier local. Le fichier de sortie spécifié sur l'hôte est au format PNG. Une connexion d'invité valide est requise. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité.

writeVariable

chemin d'accès au fichier .vmx

[ guestVar | runtimeConfig | guestEnv ]

nom de la variable

valeur de la variable

Écrit une variable dans l'état de la machine virtuelle ou un invité. Vous pouvez définir une variable d'invité non persistante, guestVar, une variable de configuration d'exécution, runtimeConfig, comme stockée dans le fichier .vmx ou dans une variable d'environnement, guestEnv, dans le système d'exploitation invité. Une variable d'invité est une valeur uniquement d'exécution qui offre un moyen simple pour passer des valeurs d'exécution à l'invité ou depuis celui-ci. Les variables d'environnement nécessitent VMware Tools et une connexion d'invité valide. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. Avec Linux, la configuration de l'environnement invité nécessite également une connexion racine.
readVariable

chemin d'accès au fichier .vmx

[ guestVar | runtimeConfig | guestEnv ]

nom de la variable

Lit une variable à partir de l'état de la machine virtuelle ou d'un invité. Vous pouvez obtenir une variable d'invité, une configuration d'exécution stockée dans le fichier .vmx, ou des variables d'environnement dans le système d'exploitation invité. La lecture de la variable guestEnv nécessite une connexion d'invité valide. Par exemple, vous pouvez utiliser les options -gu et -gp pour vous connecter à l'invité. Consultez l'entrée writeVariable pour une description des types de variable.
getGuestIPAddress

chemin d'accès au fichier .vmx

[ -wait ]

Permet de récupérer l'adresse IP de l'invité.

Lorsque vous utilisez l'option [ -wait ], la commande attend la disponibilité de l'adresse IP. Par exemple, l'adresse IP n'est pas disponible tant que la machine virtuelle n'est pas sous tension. Si le réseau n'est pas prêt, la commande revient immédiatement à l'invite de la ligne de commande.

Commandes générales et paramètres vmrun

Option Paramètres Description
list

Répertorie toutes les machines virtuelles en cours d'exécution.

upgradevm

chemin d'accès au fichier .vmx

Met à niveau une machine virtuelle vers la version actuelle du matériel virtuel. N'a aucun effet si la version de matériel virtuel est la plus récente prise en charge.

Mettez hors tension la machine virtuelle, comme avec la commande vmrun stop. Attendez quelques instants la fin de la commande. Exécutez ensuite la commande vmrun upgradevm.

installTools

chemin d'accès au fichier .vmx

Prépare l'installation de VMware Tools dans le système d'exploitation invité. Dans les invités Windows sur lesquels l'exécution automatique est activée, le programme d'installation de VMware Tools démarre automatiquement. Sur les invités Linux sans exécution automatique, la commande connecte le lecteur de CD‐ROM virtuel à l'image ISO de VMware Tools adaptée à l'invité, mais le programme d'installation ne démarre pas.

Vous devez terminer l'installation avec des étapes supplémentaires, comme décrit dans la documentation du produit.

checkToolsState

chemin d'accès au fichier .vmx

Vérifie l'état de VMware Tools dans l'invité. Les états possibles sont inconnu, installé et en cours d'exécution.
deleteVM

chemin d'accès au fichier .vmx

Supprime une machine virtuelle.
clone

chemin d'accès au fichier .vmx

chemin d'accès au fichier .vmx de destination

full|linked

[-snapshot=Snapshot Name]

[-cloneName=Name]

Seul Fusion Pro prend en charge l'option clone.

Crée une copie de la machine virtuelle.

Commandes et paramètres de machine virtuelle modèle vmrun

Option Paramètres Description
downloadPhotonVM

chemin d'accès pour enregistrer la machine virtuelle téléchargée

Télécharge une machine virtuelle du système d'exploitation VMware Project Photon.