New-AzureQuickVM

Référence

Module:: Azure

Configure et crée une machine virtuelle Azure.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Certificates

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

Type:	CertificateSettingList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableGuestAgent

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableWinRMHttp

Indique que cette applet de commande active WinRM sur HTTP.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostCaching

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

Lecture seule
Lecture/écriture

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Renseignez-vous
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceSize

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

Très petite
Petite
Moyenne
Grande
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
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Linux

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoExportPrivateKey

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWinRMEndpoint

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReservedIPName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ReverseDnsFqdn

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHKeyPairs

Spécifie les paires de clés SSH.

Type:	SSHKeyPairList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHPublicKeys

Spécifie des clés publiques SSH.

Type:	SSHPublicKeyList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetNames

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VNetName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Windows

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinRMCertificate

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

Type:	X509Certificate2
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Certificates

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

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False