Partager via

New-WAPackVM

  • Référence
Module:
Azure

Crée une machine virtuelle.

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

New-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-ProductKey <String>]
   [-Windows]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-Linux]
   [-AdministratorSSHKey <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   [-VNet <VMNetwork>]
   -OSDisk <VirtualHardDisk>
   -VMSizeProfile <HardwareProfile>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Ces rubriques sont déconseillées et seront supprimées à l’avenir. Cette rubrique décrit l’applet de commande dans la version 0.8.1 du module Microsoft Azure PowerShell. Pour connaître la version du module que vous utilisez, à partir de la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

L’applet de commande New-WAPackVM crée une machine virtuelle.

Exemples

Exemple 1 : Créer une machine virtuelle pour le système d’exploitation Windows à l’aide d’un modèle

PS C:\> $Credentials = Get-Credential PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate04"PS C:\> New-WAPackVM -Name "ContosoV023" -Template $Template -VMCredential $Credentials -Windows

La première commande crée un objet PSCredential , puis le stocke dans la variable $Credentials. L’applet de commande vous invite à entrer un compte et un mot de passe. Pour plus d'informations, voir Get-Help Get-Credential.

La deuxième commande obtient le modèle de machine virtuelle nommé ContosoTemplate04 à l’aide de l’applet de commande Get-WAPackVMTemplate , puis le stocke dans la variable $Template.

La commande finale crée une machine virtuelle nommée ContosoV023, en fonction du modèle stocké dans la variable $Template. La commande spécifie le paramètre Windows et, par conséquent, la machine virtuelle doit exécuter une version du système d’exploitation Windows.

Exemple 2 : Créer une machine virtuelle pour le système d’exploitation Linux à l’aide d’un modèle

PS C:\> $Credentials = Get-Credential
PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate19"
PS C:\> New-WAPackVM -Linux -Name "ContosoV028" -Template $Template -VMCredential $Credentials

La première commande crée un objet PSCredential , puis le stocke dans la variable $Credentials.

La deuxième commande obtient le modèle de machine virtuelle nommé ContosoTemplate19 à l’aide de l’applet de commande Get-WAPackVMTemplate , puis le stocke dans la variable $Template.

La commande finale crée une machine virtuelle nommée ContosoV028, en fonction du modèle stocké dans la variable $Template. La commande spécifie le paramètre Linux et, par conséquent, la machine virtuelle doit exécuter une version du système d’exploitation Linux.

Exemple 3 : Créer une machine virtuelle à partir d’un disque de système d’exploitation et d’un profil de taille

PS C:\> $OSDisk = Get-WAPackVMOSDisk -Name "ContosoDiskOS"
PS C:\> $SizeProfile = Get-WAPackVMSizeProfile -Name "MediumSizeVM"
PS C:\> New-WAPackVM -Name "ContosoV073" -OSDisk $OSDisk -VMSizeProfile $SizeProfile

La première commande obtient un disque de système d’exploitation nommé ContosoDiskOS à l’aide de l’applet de commande Get-WAPackVMOSDisk , puis le stocke dans la variable $OSDisk.

La deuxième commande obtient le profil de taille nommé MediumSizeVM à l’aide de l’applet de commande Get-WAPackVMSizeProfile , puis la stocke dans la variable $SizeProfile.

La commande finale crée une machine virtuelle nommée ContosoV073 à partir du disque du système d’exploitation stocké dans $OSDisk et le profil de taille stocké dans $SizeProfile.

Paramètres

-AdministratorSSHKey

Spécifie la clé SECURE Shell (SSH) pour le compte d’administrateur.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Linux

Indique que l’applet de commande crée une machine virtuelle pour exécuter le système d’exploitation Linux.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie un nom pour la machine virtuelle.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-OSDisk

Spécifie un disque de système d’exploitation en tant qu’objet VirtualHardDisk . Pour obtenir un disque de système d’exploitation, utilisez l’applet de commande Get-WAPackVMOSDisk .

Type:VirtualHardDisk
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProductKey

Spécifie une clé de produit. La clé de produit est un numéro à 25 chiffres qui identifie la licence de produit. Utilisez une clé de produit pour un système d’exploitation que vous envisagez d’installer sur une machine virtuelle ou un hôte.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

Type:AzureSMProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Template

Spécifie un modèle. L’applet de commande crée une machine virtuelle basée sur le modèle que vous spécifiez. Pour obtenir un objet de modèle, utilisez l’applet de commande Get-WAPackVMTemplate.

Type:VMTemplate
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMCredential

Spécifie les informations d’identification du compte Administrateur local. Pour obtenir un objet PSCredential , utilisez l’applet de commande Get-Credential . Pour plus d'informations, voir Get-Help Get-Credential.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMSizeProfile

Spécifie un profil de taille pour une machine virtuelle en tant qu’objet HardwareProfile . Pour obtenir un profil de taille, utilisez l’applet de commande Get-WAPackVMSizeProfile .

Type:HardwareProfile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VNet

Spécifie un réseau virtuel. L’applet de commande connecte la machine virtuelle au réseau virtuel que vous spécifiez. Pour obtenir un réseau virtuel, utilisez l’applet de commande Get-WAPackVNet .

Type:VMNetwork
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Windows

Indique que l’applet de commande crée une machine virtuelle pour exécuter le système d’exploitation Windows.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False