New-AzureQuickVM

Référence

Module:: Azure

Configure et crée une machine virtuelle Azure.

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-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande New-AzureQuickVM configure et crée une machine virtuelle Azure. Cette applet de commande peut déployer une machine virtuelle dans un service Azure existant. Cette applet de commande peut également créer un service Azure qui héberge la nouvelle machine virtuelle.

Exemples

Exemple 1 : Créer une machine virtuelle

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

Cette commande crée une machine virtuelle qui exécute le système d’exploitation Windows dans un service existant. L’applet de commande base la machine virtuelle sur l’image spécifiée. La commande spécifie le paramètre WaitForBoot . Par conséquent, l’applet de commande attend que la machine virtuelle démarre.

Exemple 2 : Créer une machine virtuelle à l’aide de certificats

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

La première commande obtient des certificats à partir d’un magasin et les stocke dans la variable $certs.

La deuxième commande crée une machine virtuelle qui exécute le système d’exploitation Windows dans un service existant à partir d’une image. Par défaut, l’écouteur Https WinRM est activé sur la machine virtuelle. La commande spécifie le paramètre WaitForBoot . Par conséquent, l’applet de commande attend que la machine virtuelle démarre. La commande charge un certificat WinRM et X509Certificates sur le service hébergé.

Exemple 3 : Créer une machine virtuelle qui exécute le système d’exploitation Linux

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

Cette commande crée une machine virtuelle qui exécute le système d’exploitation Linux à partir d’une image. Cette commande crée un service pour héberger la nouvelle machine virtuelle. La commande spécifie un emplacement pour le service.

Exemple 4 : Créer une machine virtuelle et créer un service pour héberger la nouvelle machine virtuelle

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

La première commande obtient des emplacements à l’aide de l’applet de commande Get-AzureLocation , puis les stocke dans la variable de tableau $Locations.

La deuxième commande obtient des images disponibles à l’aide de l’applet de commande Get-AzureVMImage , puis les stocke dans la variable de tableau $Images.

La commande finale crée une machine virtuelle volumineuse nommée VirtualMachine25. La machine virtuelle exécute le système d’exploitation Windows. Elle est basée sur l’une des images de $Images. La commande crée un service nommé ContosoService03 pour la nouvelle machine virtuelle. Le service se trouve à un emplacement dans $Locations.

Exemple 5 : Créer une machine virtuelle qui a un nom d’adresse IP réservée

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

La première commande obtient des emplacements, puis les stocke dans la variable de tableau $Locations.

La deuxième commande obtient les images disponibles, puis les stocke dans la variable de tableau $Images.

La commande finale crée une machine virtuelle nommée VirtualMachine27 basée sur l’une des images de $Images. La commande crée un service à un emplacement dans $Locations. La machine virtuelle a un nom IP réservé, précédemment stocké dans la variable $ipName.

Paramètres

-AdminUsername

Spécifie le nom d’utilisateur du compte Administrateur créé par cette applet de commande sur la machine virtuelle.

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

-AffinityGroup

Spécifie le groupe d’affinités pour la machine virtuelle. Spécifiez ce paramètre ou le paramètre Location uniquement si cette applet de commande crée un service Azure pour la machine virtuelle.

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

-AvailabilitySetName

Spécifie le nom du groupe à haute disponibilité dans lequel cette applet de commande crée la machine virtuelle.

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

-Certificates

Spécifie une liste de certificats que cette applet de commande utilise pour créer le service.

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

-CustomDataFile

Spécifie un fichier de données pour la machine virtuelle. Cette applet de commande encode le contenu du fichier en base64. Le fichier doit être inférieur à 64 kilo-octets.

Si le système d’exploitation invité est le système d’exploitation Windows, cette applet de commande enregistre ces données sous la forme d’un fichier binaire nommé %SYSTEMDRIVE%\AzureData\CustomData.bin.

Si le système d’exploitation invité est Linux, cette applet de commande transmet les données à l’aide du fichier ovf-env.xml. L’installation copie ce fichier dans le répertoire /var/lib/waagent. L’agent stocke également les données encodées en Base64 dans /var/lib/waagent/CustomData.

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

-DisableGuestAgent

Indique que cette applet de commande désactive l’agent invité d’approvisionnement IaaS (infrastructure as a service).

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

-DisableWinRMHttps

Indique que cette applet de commande désactive Windows Remote Management (WinRM) sur HTTPS. Par défaut, WinRM est activé sur HTTPS.

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

-DnsSettings

Spécifie un tableau d’objets serveur DNS qui définit les paramètres DNS pour le nouveau déploiement. Pour créer un objet DnsServer , utilisez l’applet de commande New-AzureDns .

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

-EnableWinRMHttp

Indique que cette applet de commande active WinRM sur HTTP.

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

-HostCaching

Spécifie le mode de mise en cache de l’hôte pour le disque du système d’exploitation. Les valeurs valides sont :

ReadOnly
Lecture/écriture

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

-ImageName

Spécifie le nom de l’image de disque utilisée par cette applet de commande pour créer le disque du système d’exploitation.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

Continuer
Ignorer
Demander
SilentlyContinue
Stop
Suspendre

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

-InformationVariable

Spécifie une variable d’informations.

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

-InstanceSize

Spécifie la taille de l’instance. Les valeurs valides sont :

Très petite
Petite
Moyenne
grand
Très grande
A5
A6
A7
A8
A9
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
D1 standard
D2 standard
D3 standard
D4 standard
D11 standard
D12 standard
D13 standard
D14 standard

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 cette applet de commande crée une machine virtuelle Linux.

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

-LinuxUser

Spécifie le nom d’utilisateur du compte d’administration Linux créé par cette applet de commande sur la machine virtuelle.

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

-Location

Spécifie le centre de données Azure qui héberge la machine virtuelle. Si vous spécifiez ce paramètre, l’applet de commande crée un service Azure à l’emplacement spécifié. Spécifiez ce paramètre ou le paramètre AffinityGroup uniquement si cette applet de commande crée un service Azure pour la machine virtuelle.

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

-MediaLocation

Spécifie l’emplacement Stockage Azure où cette applet de commande crée les disques de machines virtuelles.

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

-Name

Spécifie le nom de la machine virtuelle créée par cette applet de commande.

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

-NoExportPrivateKey

Indique que cette configuration ne charge pas la clé privée.

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

-NoWinRMEndpoint

Indique que cette applet de commande n’ajoute pas de point de terminaison WinRM pour la machine virtuelle.

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

-Password

Spécifie le mot de passe du compte d’administration.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
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

-ReservedIPName

Spécifie le nom d’adresse IP réservée.

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

-ReverseDnsFqdn

Spécifie le nom de domaine complet pour la recherche DNS inversée.

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

-ServiceName

Spécifie le nom d’un service Azure nouveau ou existant auquel cette applet de commande ajoute la nouvelle machine virtuelle.

Si vous spécifiez un nouveau service, ces applets de commande la créent. Pour créer un service, vous devez spécifier le paramètre Location ou AffinityGroup .

Si vous spécifiez un service existant, ne spécifiez pas l’emplacement ou AffinityGroup.

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

-SSHKeyPairs

Spécifie les paires de clés SSH.

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

-SSHPublicKeys

Spécifie des clés publiques SSH.

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

-SubnetNames

Spécifie un tableau de noms de sous-réseau pour la machine virtuelle.

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

-VNetName

Spécifie le nom d’un réseau virtuel pour la machine virtuelle.

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

-WaitForBoot

Indique que cette applet de commande attend que la machine virtuelle atteigne l’état ReadyRole. Si la machine virtuelle atteint l’un des états suivants, l’applet de commande échoue : FailedStartingVM, ProvisioningFailed ou ProvisioningTimeout.

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

-Windows

Indique que cette applet de commande crée une machine virtuelle Windows.

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

-WinRMCertificate

Spécifie un certificat associé à cette applet de commande à un point de terminaison WinRM.

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

-X509Certificates

Spécifie un tableau de certificats X509 déployés sur un service hébergé.

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

Partager via