New-AzureQuickVM

Referencia

Módulo:: Azure

Configura y crea una máquina virtual de Azure.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet New-AzureQuickVM configura y crea una máquina virtual de Azure. Este cmdlet puede implementar una máquina virtual en un servicio de Azure existente. Este cmdlet también puede crear un servicio de Azure que hospede la nueva máquina virtual.

Ejemplos

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

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

Este comando crea una máquina virtual que ejecuta el sistema operativo Windows en un servicio existente. El cmdlet basa la máquina virtual en la imagen especificada. El comando especifica el parámetro WaitForBoot . Por lo tanto, el cmdlet espera a que se inicie la máquina virtual.

Ejemplo 2: Creación de una máquina virtual mediante certificados

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

El primer comando obtiene certificados de un almacén y los almacena en la variable $certs.

El segundo comando crea una máquina virtual que ejecuta el sistema operativo Windows en un servicio existente a partir de una imagen. De forma predeterminada, el agente de escucha Https de WinRM está habilitado en la máquina virtual. El comando especifica el parámetro WaitForBoot . Por lo tanto, el cmdlet espera a que se inicie la máquina virtual. El comando carga un certificado WinRM y X509Certificates en el servicio hospedado.

Ejemplo 3: Creación de una máquina virtual que ejecuta el sistema operativo Linux

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

Este comando crea una máquina virtual que ejecuta el sistema operativo Linux a partir de una imagen. Este comando crea un servicio para hospedar la nueva máquina virtual. El comando especifica una ubicación para el servicio.

Ejemplo 4: Creación de una máquina virtual y creación de un servicio para hospedar la nueva máquina virtual

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

El primer comando obtiene ubicaciones mediante el cmdlet Get-AzureLocation y, a continuación, los almacena en la variable de matriz $Locations.

El segundo comando obtiene imágenes disponibles mediante el cmdlet Get-AzureVMImage y, a continuación, los almacena en la variable de matriz $Images.

El comando final crea una máquina virtual grande denominada VirtualMachine25. La máquina virtual ejecuta el sistema operativo Windows. Se basa en una de las imágenes de $Images. El comando crea un servicio denominado ContosoService03 para la nueva máquina virtual. El servicio está en una ubicación en $Locations.

Ejemplo 5: Creación de una máquina virtual con un nombre DE IP reservado

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

El primer comando obtiene ubicaciones y, a continuación, las almacena en la variable de matriz $Locations.

El segundo comando obtiene imágenes disponibles y, a continuación, las almacena en la variable de matriz $Images.

El comando final crea una máquina virtual denominada VirtualMachine27 basada en una de las imágenes de $Images. El comando crea un servicio en una ubicación en $Locations. La máquina virtual tiene un nombre IP reservado, almacenado anteriormente en la variable $ipName.

Parámetros

-AdminUsername

Especifica el nombre de usuario de la cuenta de administrador que este cmdlet crea en 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

-AffinityGroup

Especifica el grupo de afinidad de la máquina virtual. Especifique este parámetro o el parámetro Location solo si este cmdlet crea un servicio de Azure para 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

-AvailabilitySetName

Especifica el nombre del conjunto de disponibilidad en el que este cmdlet crea 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

-Certificates

Especifica una lista de certificados que usa este cmdlet para crear el servicio.

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

-CustomDataFile

Especifica un archivo de datos para la máquina virtual. Este cmdlet codifica el contenido del archivo como Base64. El archivo debe tener menos de 64 kilobytes de longitud.

Si el sistema operativo invitado es el sistema operativo Windows, este cmdlet guarda estos datos como un archivo binario denominado %SYSTEMDRIVE%\AzureData\CustomData.bin.

Si el sistema operativo invitado es Linux, este cmdlet pasa los datos mediante el archivo ovf-env.xml. La instalación copia ese archivo en el directorio /var/lib/waagent. El agente también almacena los datos codificados en Base64 en /var/lib/waagent/CustomData.

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

-DisableGuestAgent

Indica que este cmdlet deshabilita la infraestructura como servicio (IaaS) aprovisiona el agente invitado.

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

-DisableWinRMHttps

Indica que este cmdlet deshabilita la administración remota de Windows (WinRM) en HTTPS. De forma predeterminada, WinRM está habilitado a través de HTTPS.

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

-DnsSettings

Especifica una matriz de objetos de servidor DNS que define la configuración de DNS para la nueva implementación. Para crear un objeto DnsServer , use el cmdlet New-AzureDns .

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

-EnableWinRMHttp

Indica que este cmdlet habilita WinRM a través de HTTP.

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

-HostCaching

Especifica el modo de almacenamiento en caché del host para el disco del sistema operativo. Los valores válidos son:

ReadOnly
ReadWrite

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

-ImageName

Especifica el nombre de la imagen de disco que usa este cmdlet para crear el 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

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

Continuar
Ignore
Inquire
SilentlyContinue
Detención
Suspender

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

-InformationVariable

Especifica una variable de información.

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

-InstanceSize

Especifica el tamaño de la instancia. Los valores válidos son:

ExtraSmall
Pequeña
Media
grande
ExtraLarge
A5
A6
A7
A8
A9
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
Standard_D1
Standard_D2
Standard_D3
Standard_D4
Standard_D11
Standard_D12
Standard_D13
Standard_D14

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

-Linux

Indica que este cmdlet crea una máquina virtual basada en Linux.

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

-LinuxUser

Especifica el nombre de usuario de la cuenta administrativa de Linux que este cmdlet crea en 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

Especifica el centro de datos de Azure que hospeda la máquina virtual. Si especifica este parámetro, el cmdlet crea un servicio de Azure en la ubicación especificada. Especifique este parámetro o el parámetro AffinityGroup solo si este cmdlet crea un servicio de Azure para 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

-MediaLocation

Especifica la ubicación de Azure Storage donde este cmdlet crea los discos de las máquinas virtuales.

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

-Name

Especifica el nombre de la máquina virtual que crea este cmdlet.

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

-NoExportPrivateKey

Indica que esta configuración no carga la clave privada.

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

-NoWinRMEndpoint

Indica que este cmdlet no agrega un punto de conexión winRM para 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

-Password

Especifica la contraseña de la cuenta administrativa.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-ReservedIPName

Especifica el nombre DE IP reservado.

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

-ReverseDnsFqdn

Especifica el nombre de dominio completo para la búsqueda inversa de DNS.

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

-ServiceName

Especifica el nombre de un servicio de Azure nuevo o existente al que este cmdlet agrega la nueva máquina virtual.

Si especifica un nuevo servicio, estos cmdlets lo crean. Para crear un nuevo servicio, debe especificar el parámetro Location o AffinityGroup .

Si especifica un servicio existente, no especifique Location ni AffinityGroup.

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

-SSHKeyPairs

Especifica pares de claves SSH.

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

-SSHPublicKeys

Especifica claves públicas SSH.

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

-SubnetNames

Especifica una matriz de nombres de subred para 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

-VNetName

Especifica el nombre de una red virtual para 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

-WaitForBoot

Indica que este cmdlet espera a que la máquina virtual llegue al estado ReadyRole. Si la máquina virtual alcanza uno de los siguientes estados, se produce un error en el cmdlet: FailedStartingVM, ProvisioningFailed o ProvisioningTimeout.

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

-Windows

Indica que este cmdlet crea una máquina virtual Windows.

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

-WinRMCertificate

Especifica un certificado que este cmdlet asocia a un punto de conexión de WinRM.

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

-X509Certificates

Especifica una matriz de certificados X509 que se implementan en un servicio hospedado.

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

Compartir a través de