New-AzNetworkCloudVirtualMachine

Référence

Module:: Az.NetworkCloud

Créez une machine virtuelle ou mettez à jour les propriétés de la machine virtuelle existante.

Syntaxe

New-AzNetworkCloudVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -AdminUsername <String>
   -CloudServiceNetworkAttachmentAttachedNetworkId <String>
   -CloudServiceNetworkAttachmentIPAllocationMethod <VirtualMachineIPAllocationMethod>
   -CpuCore <Int64>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -Location <String>
   -MemorySizeGb <Int64>
   -OSDiskSizeGb <Int64>
   -VMImage <String>
   [-BootMethod <VirtualMachineBootMethod>]
   [-CloudServiceNetworkAttachmentDefaultGateway <DefaultGateway>]
   [-CloudServiceNetworkAttachmentIpv4Address <String>]
   [-CloudServiceNetworkAttachmentIpv6Address <String>]
   [-CloudServiceNetworkAttachmentName <String>]
   [-IsolateEmulatorThread <VirtualMachineIsolateEmulatorThread>]
   [-NetworkAttachment <INetworkAttachment[]>]
   [-NetworkData <String>]
   [-OSDiskCreateOption <OSDiskCreateOption>]
   [-OSDiskDeleteOption <OSDiskDeleteOption>]
   [-PlacementHint <IVirtualMachinePlacementHint[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-StorageProfileVolumeAttachment <String[]>]
   [-Tag <Hashtable>]
   [-UserData <String>]
   [-VMDeviceModel <VirtualMachineDeviceModelType>]
   [-VMImageRepositoryCredentialsPassword <SecureString>]
   [-VMImageRepositoryCredentialsRegistryUrl <String>]
   [-VMImageRepositoryCredentialsUsername <String>]
   [-VirtioInterface <VirtualMachineVirtioInterfaceType>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Créez une machine virtuelle ou mettez à jour les propriétés de la machine virtuelle existante.

Exemples

Exemple 1 : Créer une machine virtuelle

$networkAttachment = @{
    AttachedNetworkId = "attachedNetworkID"
    IpAllocationMethod = "Dynamic"
}
$hint = @{
    HintType = "Affinity"
    SchedulingExecution = "schedulingExecution"
    Scope = "scope"
    ResourceId = "resourceId"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}

$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudVirtualMachine -Name vmName  -ResourceGroupName resourceGroup -AdminUsername adminUsername -CloudServiceNetworkAttachmentAttachedNetworkId csnAttachedNetworkId -CloudServiceNetworkAttachmentIPAllocationMethod ipAllocationMethod -CpuCore cpuCore -ExtendedLocationName extendedLocationName -ExtendedLocationType "Custom" -Location location -SubscriptionId subscriptionId -MemorySizeGb memorySizeGb -OSDiskSizeGb osDiskSizeGb -VMImage vmImage -BootMethod bootMethod -CloudServiceNetworkAttachmentDefaultGateway defaultGateway -CloudServiceNetworkAttachmentName csnAttachmentName -IsolateEmulatorThread isolateEmulatorThread -NetworkAttachment $networkAttachment -NetworkData networkData -OSDiskCreateOption osDiskCreationOption -OSDiskDeleteOption osDiskDeleteOption -PlacementHint $hint -SshPublicKey $sshPublicKey -Tag @{tags = "tags"} -UserData userData -VirtioInterface virtioInterface -VMDeviceModel vmDeviceModel -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $securePassword -VMImageRepositoryCredentialsRegistryUrl registryUrl

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataL
                                                                                                                                                  astModified
                                                                                                                                                  ByType
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             -----------
eastus   default 7/07/2023 21:32:03 <user>                 User                    07/07/2023 21:32:41      <identity>                           Application

Cette commande crée une machine virtuelle.

Paramètres

-AdminUsername

Nom de l’administrateur auquel les clés publiques ssh seront ajoutées aux clés autorisées.

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

-AsJob

Exécuter la commande en tant que travail

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

-BootMethod

Sélectionne la méthode de démarrage de la machine virtuelle.

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

-CloudServiceNetworkAttachmentAttachedNetworkId

ID de ressource du réseau associé attaché à la machine virtuelle. Il peut s’agir de l’une des ressources cloudServicesNetwork, l3Network, l2Network ou trunkedNetwork.

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

-CloudServiceNetworkAttachmentDefaultGateway

Indicateur indiquant s’il s’agit de la passerelle par défaut. Un seul des réseaux attachés (y compris la pièce jointe CloudServicesNetwork) pour un seul ordinateur peut être spécifié comme True.

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

-CloudServiceNetworkAttachmentIPAllocationMethod

Mécanisme d’allocation IP pour la machine virtuelle. Dynamique et statique sont valides uniquement pour l3Network qui peut également spécifier Disabled.Sinon, Disabled est la seule valeur autorisée.

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

-CloudServiceNetworkAttachmentIpv4Address

Adresse IPv4 de la machine virtuelle. Ce champ est utilisé uniquement si le réseau attaché a IPAllocationType d’IPV4 ou DualStack.If IPAllocationMethod est :Static . Ce champ doit contenir une adresse IPv4 spécifiée par l’utilisateur à partir du sous-réseau spécifié dans le réseau attaché. Dynamique : ce champ est en lecture seule, mais sera rempli avec une adresse à partir du sous-réseau spécifié dans le réseau attaché. Désactivé : ce champ est vide.

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

-CloudServiceNetworkAttachmentIpv6Address

Adresse IPv6 de la machine virtuelle. Ce champ est utilisé uniquement si le réseau attaché a IPAllocationType d’IPV6 ou DualStack.If IPAllocationMethod est :Static . Ce champ doit contenir une plage d’adresses IPv6 à partir de la plage spécifiée dans le réseau attaché. Dynamique : ce champ est en lecture seule, mais est rempli avec une plage à partir du sous-réseau spécifié dans le réseau attaché. Désactivé : ce champ est vide.

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

-CloudServiceNetworkAttachmentName

Nom de l’interface du réseau associé. Si spécifié, le nom de la pièce jointe réseau a une longueur maximale de 15 caractères et doit être unique à cette machine virtuelle. Si l’utilisateur ne spécifie pas cette valeur, le nom d’interface par défaut de la ressource réseau est utilisé. Pour une ressource CloudServicesNetwork, ce nom est ignoré.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-CpuCore

Nombre de cœurs d’UC dans la machine virtuelle.

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

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

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

-ExtendedLocationName

ID de ressource de l’emplacement étendu sur lequel la ressource sera créée.

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

-ExtendedLocationType

Type d’emplacement étendu, par exemple CustomLocation.

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

-IsolateEmulatorThread

Champ déconseillé, la valeur est ignorée si elle est fournie. Indicateur indiquant si l’un des cœurs de processeur spécifiés est isolé pour exécuter le thread de l’émulateur pour cette machine virtuelle.

Type:	VirtualMachineIsolateEmulatorThread
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

Emplacement géographique où réside la ressource

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

-MemorySizeGb

Taille de mémoire de la machine virtuelle. Les allocations sont mesurées en gibibytes.

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

-Name

Nom de la machine virtuelle.

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

-NetworkAttachment

Liste des pièces jointes réseau à la machine virtuelle. Pour construire, consultez la section NOTES pour les propriétés NETWORKATTACHMENT et créez une table de hachage.

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

-NetworkData

Données réseau cloud-init encodées en Base64.

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

-NoWait

Exécuter la commande de manière asynchrone

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

-OSDiskCreateOption

Stratégie de création du disque du système d’exploitation.

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

-OSDiskDeleteOption

Stratégie de suppression du disque du système d’exploitation.

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

-OSDiskSizeGb

Taille du disque. Obligatoire si createOption est éphémère. Les allocations sont mesurées en gibibytes.

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

-PlacementHint

Indicateurs de planification pour la machine virtuelle. Pour construire, consultez la section NOTES pour les propriétés PLACEMENTHINT et créez une table de hachage.

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

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

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

-SshPublicKey

Liste des clés publiques ssh. Chaque clé est ajoutée à la machine virtuelle à l’aide du mécanisme de ssh_authorized_keys cloud-init pour adminUsername. Pour construire, consultez la section NOTES pour les propriétés SSHPUBLICKEY et créez une table de hachage.

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

-StorageProfileVolumeAttachment

ID de ressources des volumes qui sont demandés à être attachés à 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

-SubscriptionId

ID de l’abonnement cible. La valeur doit être un UUID.

Type:	String
Position:	Named
Valeur par défaut:	(Get-AzContext).Subscription.Id
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Tag

Balises de ressource.

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

-UserData

Données utilisateur cloud-init encodées en Base64.

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

-VirtioInterface

Champ déconseillé, utilisez virtualizationModel à la place. Type de l’interface virtio.

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

-VMDeviceModel

Type du modèle d’appareil à utiliser.

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

-VMImage

Image de machine virtuelle actuellement approvisionnée sur le disque du système d’exploitation, à l’aide de l’URL complète et de la notation de balise utilisée pour extraire l’image.

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

-VMImageRepositoryCredentialsPassword

Mot de passe ou jeton utilisé pour accéder à une image dans le référentiel cible.

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

-VMImageRepositoryCredentialsRegistryUrl

URL du serveur d’authentification utilisé pour valider les informations d’identification du référentiel.

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

-VMImageRepositoryCredentialsUsername

Nom d’utilisateur utilisé pour accéder à une image dans le référentiel cible.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

Sorties

IVirtualMachine

Partager via