New-AzureRmVMConfig

Módulo:

AzureRM.Compute

Crea un objeto de máquina virtual configurable.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-IdentityType] <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureRmVMConfig
   [-VMName] <String>
   [-VMSize] <String>
   [[-AvailabilitySetId] <String>]
   [[-LicenseType] <String>]
   [-AssignIdentity]
   [-Zone <String[]>]
   [-Tags <Hashtable>]
   [-EnableUltraSSD]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmVMConfig crea un objeto de máquina virtual local configurable para Azure. Otros cmdlets se pueden usar para configurar un objeto de máquina virtual, como Set-AzureRmVMOperatingSystem, Set-AzureRmVMSourceImage, Add-AzureRmVMNetworkInterface y Set-AzureRmVMOSDisk.

Ejemplos

Ejemplo 1: Creación de un objeto de máquina virtual

PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id

El primer comando obtiene el conjunto de disponibilidad denominado AvailablitySet03 en el grupo de recursos denominado ResourceGroup11 y, a continuación, almacena ese objeto en la variable $AvailabilitySet. El segundo comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. La máquina virtual pertenece al conjunto de disponibilidad almacenado en $AvailabilitySet.

Parámetros

-AssignIdentity

Especifique la identidad asignada por el sistema para la máquina virtual.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailabilitySetId

Especifica el identificador de un conjunto de disponibilidad. Para obtener un objeto de conjunto de disponibilidad, use el cmdlet Get-AzureRmAvailabilitySet. El objeto del conjunto de disponibilidad contiene una propiedad ID.

Tipo:	String
Position:	2
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableUltraSSD

Habilita una capacidad para tener uno o varios discos de datos administrados con UltraSSD_LRS tipo de cuenta de almacenamiento en la máquina virtual. Los discos administrados con el tipo de cuenta de almacenamiento UltraSSD_LRS se pueden agregar a una máquina virtual solo si esta propiedad está habilitada.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityId

Especifica la lista de identidades de usuario asociadas al conjunto de escalado de máquinas virtuales. Las referencias de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IdentityType

Identidad de la máquina virtual, si está configurada.

Tipo:	Nullable<T>[ResourceIdentityType]
valores aceptados:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	4
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseType

El tipo de licencia, que es para traer su propio escenario de licencia.

Tipo:	String
Position:	3
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tags

Etiquetas asociadas al recurso.

Tipo:	Hashtable
Aliases:	Tag
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Especifica un nombre para la máquina virtual.

Tipo:	String
Aliases:	ResourceName, Name
Position:	0
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMSize

Especifica el tamaño de la máquina virtual.

Tipo:	String
Position:	1
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Zone

Especifica la lista de zonas de la máquina virtual.

Tipo:	String[]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

String[]

Hashtable

Salidas

PSVirtualMachine

Vínculos relacionados

• Update-AzureRmVM
• Set-AzureRmVMOperatingSystem
• Set-AzureRmVMSourceImage
• Get-AzureRmAvailabilitySet