New-VM |
Nouvelle machine virtuelle |
---|---|
PowerShell |
Syntaxe
New-VM [[-Name] String] [[-MemoryStartupBytes] Int64] [-BootDevice BootDevice] [-NoVHD] [-SwitchName String] [-Path String] [-Version Version] [-Prerelease] [-Experimental] [[-Generation] Int16] [-Force] [-AsJob] [-CimSession CimSession[]] [-ComputerName String[]] [-Credential PSCredential[]] [-WhatIf] [-Confirm] [CommonParameters] |
New-VM [[-Name] String] [[-MemoryStartupBytes] Int64] [-BootDevice BootDevice] [-SwitchName String] -NewVHDPath String -NewVHDSizeBytes UInt64 [-Path String] [-Version Version] [-Prerelease] [-Experimental] [[-Generation] Int16] [-Force] [-AsJob] [-CimSession CimSession[]] [-ComputerName String[]] [-Credential PSCredential[]] [-WhatIf] [-Confirm] [CommonParameters] |
New-VM [[-Name] String] [[-MemoryStartupBytes] Int64] [-BootDevice BootDevice] [-SwitchName String] -VHDPath String [-Path String] [-Version Version] [-Prerelease] [-Experimental] [[-Generation] Int16] [-Force] [-AsJob] [-CimSession CimSession[]] [-ComputerName String[]] [-Credential PSCredential[]] [-WhatIf] [-Confirm] [CommonParameters] |
Paramètres
Nom | Description |
---|---|
-AsJob | Ce paramètre permet d'exécuter la commandlette en tant que tâche d'arrière-plan. |
-BootDevice | Ce paramètre permet d'indiquer le périphérique à utiliser comme périphérique de démarrage pour la nouvelle machine virtuelle. Les valeurs autorisées sont CD, Floppy, LegacyNetworkAdapter, IDE, NetworkAdapter et VHD. |
-CimSession | Ce paramètre permet d'exécuter la commandlette dans une session à distance ou sur un ordinateur à distance. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'une commandlette de New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local. |
-ComputerName | Ce paramètre permet d'indiquer un ou plusieurs hôtes Hyper-V sur lesquels la machine virtuelle doit être créée. Les noms NetBIOS, les adresses IP et les noms de domaine complets sont autorisés. La valeur par défaut est l'ordinateur local. Utilisez localhost ou un point (.) Pour spécifier explicitement l'ordinateur local. |
-Confirm | Ce paramètre permet d'indiquer un prompt de confirmation avant d'exécuter la commandlette. |
-Credential | Ce paramètre permet d'indiquer un ou plusieurs comptes d'utilisateurs autorisés à effectuer cette action. La valeur par défaut est l'utilisateur actuel. |
-Experimental | Ce paramètre permet d'indiquer qu'il faut utiliser les fonctionnalités expérimentales. |
-Force | Ce paramètre permet de forcer l'utilisation d'un autre paramètre. |
-Generation | Ce paramètre permet d'indiquer la génération, sous forme d'entier, pour la machine virtuelle. Les valeurs valides sont 1 et 2. |
-MemoryStartupBytes | Ce paramètre permet d'indiquer la quantité de mémoire, en octets, à affecter à la machine virtuelle. La valeur par défaut est de 512 Mo. |
-Name | Ce paramètre permet d'indiquer le nom de la nouvelle machine virtuelle. Le nom par défaut est New virtual machine. |
-NewVHDPath | Ce paramètre permet de créer un nouveau disque dur virtuel avec le chemin spécifié et le connecte à la nouvelle machine virtuelle. Les chemins absolus sont autorisés. Si seul un nom de fichier est spécifié, le disque dur virtuel est créé dans le chemin par défaut configuré pour l'hôte. |
-NewVHDSizeBytes | Ce paramètre permet d'indiquer la taille du disque dur virtuel dynamique étant créé et attaché à la nouvelle machine virtuelle. |
-NoVHD | Ce paramètre permet de créer une machine virtuelle sans attacher de disques durs virtuels. |
-Path | Ce paramètre permet d'indiquer le répertoire dans lequel entreposer les fichiers de la nouvelle machine virtuelle. |
-Prerelease | Ce paramètre permet d'indiquer qu'il s'agit d'une pré-réalisation. |
-SwitchName | Ce paramètre permet d'indiquer le nom convivial du commutateur virtuel si vous souhaitez connecter la nouvelle machine virtuelle à un commutateur virtuel existant pour fournir la connectivité à un réseau. Le Hyper-V crée automatiquement une machine virtuelle avec une carte réseau virtuelle, mais sa connexion à un commutateur virtuel est facultative. |
-Version | Ce paramètre permet de demander la version. |
-VHDPath | Ce paramètre permet d'indiquer le chemin d'accès à un fichier de disque dur virtuel. |
-WhatIf | Ce paramètre permet de montrer ce qui se passerait si la commandlette s'exécute. Toutefois, la commandlette n'est pas exécutée. |
Description
Cette commande permet de créer une nouvelle machine virtuelle.
Remarques
- Les machines virtuelles de génération 2 ne prennent pas en charge Floppy, LegacyNetworkAdapter ou IDE. L'utilisation de ces valeurs avec une machine virtuelle de génération 2 provoquera une erreur.
- Le VHD et NetworkAdapter sont des nouveautés des machines virtuelles de génération 2. Si vous les spécifiez sur une machine virtuelle de génération 1, ils sont interprétés respectivement comme IDE et LegacyNetworkAdapter.
Exemples
L'exemple suivant permet de créer une nouvelle machine virtuelle nommée gladir 1 disposant de 512 Mo de mémoire vive :
New-VM -Name "gladir 1" -MemoryStartupBytes 512MB |
L'exemple suivant permet de créer une machine virtuelle nommée gladir 2 disposant de 2 Go de mémoire et étant connectée à un nouveau disque dur virtuel de 80 Go utilisant le format VHDX :
New-VM -Name "gladir 2" -MemoryStartupBytes 2GB -NewVHDPath c:\vhd\base.vhdx -NewVHDSizeBytes 80GB |
L'exemple suivant permet de créer une machine virtuelle nommée gladir 3 disposant de 1 Go de mémoire et la connecte à un disque dur virtuel existant utilisant le format VHDX :
New-VM -Name "gladir 3" -MemoryStartupBytes 1GB -VHDPath d:\vhd\BaseImage.vhdx |
L'exemple suivant permet de demander des informations d'identification, puis de créer une machine virtuelle nommée gladir 4, disposant de 2 Go de mémoire, sur le serveur nommé GladirServer01 :
New-VM -Name "gladir 4" -MemoryStartupBytes 2GB -Credential (Get-Credential) -ComputerName GladirServer01 |
L'exemple suivant permet de créer une machine virtuelle nommée gladir 5. La machine n'a pas de disque VHD et est configurée pour démarrer à partir du CD :
New-VM -Name "gladir 5" -Generation 1 -BootDevice CD -NoVHD |
L'exemple suivant permet de créer une machine virtuelle nommée gladir 6. La machine a la même génération et la même quantité de mémoire affectée que la machine existante nommée ancien 1 et se connecte au même commutateur réseau :
$ancienVM = Get-VM "ancien 1" $memory = (Get-VMMemory -VMName $oldVM.name).Startup $switch = (Get-VMNetworkAdapter -VMName $ancienVM.name).SwitchName New-VM -Name "gladir 6" -Generation $ancienVM.Generation -MemoryStartupBytes $memory -SwitchName $switch |