New-AzNetworkCloudVirtualMachine

Referencia

Módulo:: Az.NetworkCloud

Cree una nueva máquina virtual o actualice las propiedades de la máquina virtual existente.

Sintaxis

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

Cree una nueva máquina virtual o actualice las propiedades de la máquina virtual existente.

Ejemplos

Ejemplo 1: Creación de una máquina virtual

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

$securePassword = ConvertTo-SecureString -String "****" -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

Este comando crea una máquina virtual.

Parámetros

-AdminUsername

Nombre del administrador al que se agregarán las claves públicas ssh a las claves autorizadas.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AsJob

Ejecución del comando como trabajo

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BootMethod

Selecciona el método de arranque de la máquina virtual.

Tipo:	VirtualMachineBootMethod
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentAttachedNetworkId

Identificador de recurso de la red asociada conectada a la máquina virtual. Puede ser uno de los recursos cloudServicesNetwork, l3Network, l2Network o trunkedNetwork.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentDefaultGateway

Indicador de si se trata de la puerta de enlace predeterminada. Solo se puede especificar una de las redes conectadas (incluidos los datos adjuntos de CloudServicesNetwork) para una sola máquina como True.

Tipo:	DefaultGateway
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentIPAllocationMethod

Mecanismo de asignación de IP para la máquina virtual. Dynamic y Static solo son válidos para l3Network que también pueden especificar Disabled.Otherwise, Disabled es el único valor permitido.

Tipo:	VirtualMachineIPAllocationMethod
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentIpv4Address

Dirección IPv4 de la máquina virtual. Este campo solo se usa si la red conectada tiene IPAllocationType de IPV4 o DualStack.If IPAllocationMethod es:Static: este campo debe contener una dirección IPv4 especificada por el usuario desde la subred especificada en la red conectada. Dinámico: este campo es de solo lectura, pero se rellenará con una dirección desde dentro de la subred especificada en la red conectada. Deshabilitado: este campo estará vacío.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentIpv6Address

Dirección IPv6 de la máquina virtual. Este campo solo se usa si la red conectada tiene IPAllocationType de IPV6 o DualStack.If IPAllocationMethod es:Static: este campo debe contener un intervalo de direcciones IPv6 desde el intervalo especificado en la red conectada. Dinámico: este campo es de solo lectura, pero se rellenará con un intervalo desde dentro de la subred especificada en la red conectada. Deshabilitado: este campo estará vacío.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CloudServiceNetworkAttachmentName

Nombre de la interfaz de la red asociada. Si se especifica, el nombre de los datos adjuntos de red tiene una longitud máxima de 15 caracteres y debe ser único para esta máquina virtual. Si el usuario no especifica este valor, se usará el nombre de interfaz predeterminado del recurso de red. En el caso de un recurso CloudServicesNetwork, este nombre se omitirá.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CpuCore

Número de núcleos de CPU en la máquina virtual.

Tipo:	Int64
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ExtendedLocationName

Identificador de recurso de la ubicación extendida en la que se creará el recurso.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ExtendedLocationType

El tipo de ubicación extendida, por ejemplo, CustomLocation.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IsolateEmulatorThread

Campo en desuso, el valor se omitirá si se proporciona. Indicador de si uno de los núcleos de CPU especificados está aislado para ejecutar el subproceso del emulador para esta máquina virtual.

Tipo:	VirtualMachineIsolateEmulatorThread
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Location

Ubicación geográfica donde reside el recurso

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MemorySizeGb

Tamaño de memoria de la máquina virtual en GB.

Tipo:	Int64
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

El nombre de la máquina virtual.

Tipo:	String
Alias:	VirtualMachineName
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NetworkAttachment

Lista de datos adjuntos de red a la máquina virtual. Para construir, consulte la sección NOTES de las propiedades NETWORKATTACHMENT y cree una tabla hash.

Tipo:	INetworkAttachment[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NetworkData

Datos de red cloud-init codificados en Base64.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoWait

Ejecutar el comando de forma asincrónica

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OSDiskCreateOption

Estrategia para crear el disco del sistema operativo.

Tipo:	OSDiskCreateOption
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OSDiskDeleteOption

Estrategia para eliminar el disco del sistema operativo.

Tipo:	OSDiskDeleteOption
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-OSDiskSizeGb

Tamaño del disco en gigabytes. Obligatorio si createOption es Efímero.

Tipo:	Int64
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PlacementHint

Sugerencias de programación para la máquina virtual. Para construir, vea la sección NOTES para las propiedades PLACEMENTHINT y crear una tabla hash.

Tipo:	IVirtualMachinePlacementHint[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SshPublicKey

Lista de claves públicas ssh. Cada clave se agregará a la máquina virtual mediante el mecanismo cloud-init ssh_authorized_keys para adminUsername. Para construir, consulte la sección NOTES de las propiedades SSHPUBLICKEY y cree una tabla hash.

Tipo:	ISshPublicKey[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageProfileVolumeAttachment

Identificadores de recursos de volúmenes que se solicitan que se conecten a la máquina virtual.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Tipo:	String
Posición:	Named
Valor predeterminado:	(Get-AzContext).Subscription.Id
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Tag

Etiquetas del recurso.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserData

Datos de usuario de cloud-init codificados en Base64.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VirtioInterface

Campo en desuso, use virtualizationModel en su lugar. Tipo de la interfaz virtio.

Tipo:	VirtualMachineVirtioInterfaceType
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMDeviceModel

Tipo del modelo de dispositivo que se va a usar.

Tipo:	VirtualMachineDeviceModelType
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMImage

Imagen de máquina virtual que se aprovisiona actualmente en el disco del sistema operativo, mediante la dirección URL completa y la notación de etiquetas usadas para extraer la imagen.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMImageRepositoryCredentialsPassword

Contraseña o token usado para acceder a una imagen en el repositorio de destino.

Tipo:	SecureString
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMImageRepositoryCredentialsRegistryUrl

Dirección URL del servidor de autenticación que se usa para validar las credenciales del repositorio.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMImageRepositoryCredentialsUsername

Nombre de usuario usado para acceder a una imagen en el repositorio de destino.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Salidas

IVirtualMachine

Compartir a través de