New-AzStackHCIVMVirtualMachine

Referencia

Módulo:: Az.StackHCIVM

Operación para crear o actualizar una máquina virtual. Tenga en cuenta que algunas propiedades solo se pueden establecer durante la creación de máquinas virtuales.

Sintaxis

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   -ImageId <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -ImageName <String>
   [-ImageResourceGroup <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -OSDiskId <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   [-DynamicMemoryMaximumMemoryInMb <Int64>]
   [-DynamicMemoryMinimumMemoryInMb <Int64>]
   [-DynamicMemoryTargetBuffer <Int32>]
   [-VmMemoryInMB <Int64>]
   [-VmProcessor <Int32>]
   [-VmSize <String>]
   [-IdentityType <String>]
   [-DisablePasswordAuthentication]
   [-ProvisionVMAgent]
   [-ProvisionVMConfigAgent]
   [-NicId <String[]>]
   [-NicName <String[]>]
   [-NicResourceGroup <String>]
   [-DataDiskId <String[]>]
   [-DataDiskName <String[]>]
   [-DataDiskResourceGroup <String>]
   [-AdminPassword <String>]
   [-AdminUsername <String>]
   [-ComputerName <String>]
   [-EnableTpm]
   [-SshPublicKey <String[]>]
   [-StoragePathId <String>]
   [-StoragePathName <String>]
   [-StoragePathResourceGroup <String>]
   [-SecureBootEnabled]
   [-EnableAutomaticUpdate]
   [-TimeZone <String>]
   -OSDiskName <String>
   [-OSDiskResourceGroup <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Operación para crear o actualizar una máquina virtual. Tenga en cuenta que algunas propiedades solo se pueden establecer durante la creación de máquinas virtuales.

Ejemplos

Ejemplo 1: Crear una máquina virtual con una imagen.

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux"  -ImageName "testImage" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm"  -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus"

Name            ResourceGroupName
----            -----------------
testVm          test-rg

Este comando crea una máquina virtual a partir de una imagen de la galería.

Ejemplo 2: Crear una máquina virtual con un disco.

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux" -OsDiskName "testOsDisk10" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -Location "eastus"

Name            ResourceGroupName
----            -----------------
testVm          test-rg

Este comando crea una máquina virtual a partir de un disco.

Parámetros

-AdminPassword

AdminPassword: contraseña de administrador

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

-AdminUsername

AdminUsername: nombre de usuario de administrador

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
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

-ComputerName

NombreDeEquipo: nombre del equipo

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

-Confirm

Le pide 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

-CustomLocationId

Nombre de la ubicación extendida.

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

-DataDiskId

Discos de datos: lista de discos de datos que se van a conectar a la máquina virtual en formato id.

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

-DataDiskName

Discos de datos: lista de discos de datos que se van a conectar a la máquina virtual en formato de nombre .

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

-DataDiskResourceGroup

Discos de datos: grupo de recursos de discos de datos.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

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

-DisablePasswordAuthentication

DisablePasswordAuthentication: si se debe deshabilitar la autenticación de contraseña

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

-DynamicMemoryMaximumMemoryInMb

Memoria dinámica máxima

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

-DynamicMemoryMinimumMemoryInMb

Memoria dinámica mínima

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

-DynamicMemoryTargetBuffer

Define la cantidad de memoria adicional que se debe reservar para una máquina virtual en tiempo de ejecución, como porcentaje de la memoria total que se cree que necesita la máquina virtual. Esto solo se aplica a los sistemas virtuales con la memoria dinámica habilitada. Esta propiedad puede estar en el intervalo de 5 a 2000.

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

-EnableAutomaticUpdate

Especifica si se debe habilitarAutomaticUpdates en el equipo.

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

-EnableTpm

Se usa para indicar si se va a habilitar TPM o no

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

-IdentityType

Tipo de identidad.

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

-ImageId

Identificador de recurso de la imagen con el que se va a crear la máquina virtual.

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

-ImageName

Nombre de la imagen con la que se va a crear la máquina virtual.

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

-ImageResourceGroup

Grupo de recursos de la imagen a partir de la que se va a crear 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

-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

-Name

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

-NicId

NetworkInterfaces: lista de interfaces de red que se van a conectar a la máquina virtual en formato id. de ARM.

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

-NicName

NetworkInterfaces: lista de interfaces de red que se van a asociar a la máquina virtual en formato de nombre.

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

-NicResourceGroup

NetworkInterfaces: grupo de recursos de interfaces de red.

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

-OSDiskId

Identificador de recurso del disco del sistema operativo

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

-OSDiskName

Nombre del disco del sistema operativo

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

-OSDiskResourceGroup

Grupo de recursos del disco del sistema operativo

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

-OsType

OsType: cadena que especifica si el sistema operativo es Linux o Windows

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

-ProvisionVMAgent

Se usa para indicar si se debe desencadenar la incorporación de agentes de Arc for Servers durante el proceso de creación de la máquina virtual. El agente de máquina virtual se provsiona de forma predeterminada. Pase -ProvisionVMAgent:$false para deshabilitar.

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

-ProvisionVMConfigAgent

Indica si el agente de configuración de máquina virtual debe aprovisionarse en la máquina virtual. Cuando no se especifica esta propiedad, el comportamiento predeterminado es establecerla en true. El agente de configuración de máquina virtual se aprovisiona de forma predeterminada. Pase -ProvisionVMConfigAgent:$false para deshabilitarlo.

Tipo:	SwitchParameter
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 no 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

-SecureBootEnabled

Especifica si se debe habilitar el arranque seguro en la máquina virtual.

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

-SshPublicKey

PublicKeys: la lista de claves públicas SSH usadas para autenticarse con máquinas virtuales

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

-StoragePathId

Identificador del contenedor de almacenamiento que hospeda el archivo de configuración de 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

-StoragePathName

Nombre del contenedor de almacenamiento que hospeda el archivo de configuración de 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

-StoragePathResourceGroup

Grupo de recursos de contenedor de almacenamiento. El grupo de recursos de la máquina virtual se usará si no se proporciona este valor.

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.

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

-TimeZone

Zona horaria de 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

-VmMemoryInMB

RAM en MB para la máquina virtual

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

-VmProcessor

Número de procesadores de la máquina virtual

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

-VmSize

Tamaño de la máquina virtual. Puede ser un tamaño predefinido o personalizado. Entre los tamaños predefinidos posibles se incluyen: Personalizado,Standard_A2_v2,Standard_A4_v2,Standard_D16s_v3,Standard_D2s_v3,Standard_D32s_v3,Standard_D4s_v3,Standard_D8s_v3,Standard_DS13_v2,Standard_DS2_v2,Standard_DS3_v2,Standard_DS4_v2,Standard_DS5_v2,Standard_K8S2_v1,Standard_K8S3_v1,Standard_K8S4_v1,Standard_K8S5_v1,Standard_K8S_v1, Standard_NK12,Standard_NK6,Standard_NV12, StandardNv6

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 el cmdlet se ejecuta. 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

IVirtualMachineInstance

Compartir a través de