Compartilhar via

New-AzureQuickVM

  • Referência
Módulo:
Azure

Configura e cria uma máquina virtual do Azure.

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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

O cmdlet New-AzureQuickVM configura e cria uma máquina virtual do Azure. Esse cmdlet pode implantar uma máquina virtual em um serviço existente do Azure. Esse cmdlet pode, alternativamente, criar um serviço do Azure que hospeda a nova máquina virtual.

Exemplos

Exemplo 1: Criar uma máquina virtual

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

Esse comando cria uma máquina virtual que executa o sistema operacional Windows em um serviço existente. O cmdlet baseia a máquina virtual na imagem especificada. O comando especifica o parâmetro WaitForBoot . Portanto, o cmdlet aguarda a inicialização da máquina virtual.

Exemplo 2: Criar uma máquina virtual usando 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

O primeiro comando obtém certificados de um armazenamento e os armazena na variável $certs.

O segundo comando cria uma máquina virtual que executa o sistema operacional Windows em um serviço existente a partir de uma imagem. Por padrão, o ouvinte WinRM Https está habilitado na máquina virtual. O comando especifica o parâmetro WaitForBoot . Portanto, o cmdlet aguarda a inicialização da máquina virtual. O comando carrega um certificado WinRM e X509Certificates para o serviço hospedado.

Exemplo 3: Criar uma máquina virtual que executa o sistema operacional Linux

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

Esse comando cria uma máquina virtual que executa o sistema operacional Linux a partir de uma imagem. Esse comando cria um serviço para hospedar a nova máquina virtual. O comando especifica um local para o serviço.

Exemplo 4: Criar uma máquina virtual e criar um serviço para hospedar a nova 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

O primeiro comando obtém locais usando o cmdlet Get-AzureLocation e os armazena na variável de matriz $Locations.

O segundo comando obtém imagens disponíveis usando o cmdlet Get-AzureVMImage e as armazena na variável de matriz $Images.

O comando final cria uma grande máquina virtual chamada VirtualMachine25. A máquina virtual executa o sistema operacional Windows. Ele é baseado em uma das imagens em $Images. O comando cria um serviço chamado ContosoService03 para a nova máquina virtual. O serviço está em um local em $Locations.

Exemplo 5: Criar uma máquina virtual que tenha um nome 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

O primeiro comando obtém locais e, em seguida, os armazena na variável de matriz $Locations.

O segundo comando obtém imagens disponíveis e, em seguida, armazena-as na variável de matriz $Images.

O comando final cria uma máquina virtual chamada VirtualMachine27 com base em uma das imagens em $Images. O comando cria um serviço em um local no $Locations. A máquina virtual tem um nome IP reservado, armazenado anteriormente na variável $ipName.

Parâmetros

-AdminUsername

Especifica o nome de usuário da conta de administrador que esse cmdlet cria na máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AffinityGroup

Especifica o grupo de afinidade para a máquina virtual. Especifique esse parâmetro ou o parâmetro Location somente se esse cmdlet criar um serviço do Azure para a máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AvailabilitySetName

Especifica o nome do conjunto de disponibilidade no qual esse cmdlet cria a máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Certificates

Especifica uma lista de certificados que esse cmdlet usa para criar o serviço.

Tipo:CertificateSettingList
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomDataFile

Especifica um arquivo de dados para a máquina virtual. Esse cmdlet codifica o conteúdo do arquivo como Base64. O arquivo deve ter menos de 64 kilobytes.

Se o sistema operacional convidado for o sistema operacional Windows, esse cmdlet salvará esses dados como um arquivo binário chamado %SYSTEMDRIVE%\AzureData\CustomData.bin.

Se o sistema operacional convidado for Linux, esse cmdlet passará os dados usando o arquivo ovf-env.xml. A instalação copia esse arquivo para o diretório /var/lib/waagent. O agente também armazena os dados codificados em Base64 em /var/lib/waagent/CustomData.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableGuestAgent

Indica que esse cmdlet desabilita o agente convidado de provisionamento de infraestrutura como serviço (IaaS).

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWinRMHttps

Indica que esse cmdlet desabilita o WinRM (Gerenciamento Remoto do Windows) em HTTPS. Por padrão, o WinRM é habilitado por HTTPS.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DnsSettings

Especifica uma matriz de objetos de servidor DNS que define as configurações de DNS para a nova implantação. Para criar um objeto DnsServer , use o cmdlet New-AzureDns .

Tipo:DnsServer[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableWinRMHttp

Indica que esse cmdlet habilita o WinRM sobre HTTP.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostCaching

Especifica o modo de cache do host para o disco do sistema operacional. Os valores válidos são:

  • ReadOnly
  • ReadWrite
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImageName

Especifica o nome da imagem de disco que esse cmdlet usa para criar o disco do sistema operacional.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Parar
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

Tipo:String
Aliases:iv
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceSize

Especifica o tamanho da instância. Os valores válidos são:

  • ExtraSmall
  • Small
  • Médio
  • 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Linux

Indica que esse cmdlet cria uma máquina virtual baseada em Linux.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LinuxUser

Especifica o nome de usuário da conta administrativa do Linux que esse cmdlet cria na máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica o datacenter do Azure que hospeda a máquina virtual. Se você especificar esse parâmetro, o cmdlet criará um serviço do Azure no local especificado. Especifique esse parâmetro ou o parâmetro AffinityGroup somente se esse cmdlet criar um serviço do Azure para a máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MediaLocation

Especifica o local de Armazenamento do Azure onde esse cmdlet cria os discos de máquinas virtuais.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome da máquina virtual que esse cmdlet cria.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoExportPrivateKey

Indica que essa configuração não carrega a chave privada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWinRMEndpoint

Indica que esse cmdlet não adiciona um ponto de extremidade WinRM para a máquina virtual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Password

Especifica a senha da conta administrativa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReservedIPName

Especifica o nome IP reservado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ReverseDnsFqdn

Especifica o nome de domínio totalmente qualificado para pesquisa de DNS reverso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServiceName

Especifica o nome de um serviço do Azure novo ou existente ao qual esse cmdlet adiciona a nova máquina virtual.

Se você especificar um novo serviço, esse cmdlet o criará. Para criar um novo serviço, você deve especificar o parâmetro Location ou AffinityGroup .

Se você especificar um serviço existente, não especifique Local ou AffinityGroup.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SSHKeyPairs

Especifica pares de chaves SSH.

Tipo:SSHKeyPairList
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SSHPublicKeys

Especifica chaves públicas SSH.

Tipo:SSHPublicKeyList
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetNames

Especifica uma matriz de nomes de sub-rede para a máquina virtual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VNetName

Especifica o nome de uma rede virtual para a máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WaitForBoot

Indica que esse cmdlet aguarda que a máquina virtual atinja o estado ReadyRole. Se a máquina virtual atingir um dos seguintes estados, o cmdlet falhará: FailedStartingVM, ProvisioningFailed ou ProvisioningTimeout.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Windows

Indica que esse cmdlet cria uma máquina virtual do Windows.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WinRMCertificate

Especifica um certificado que esse cmdlet associa a um ponto de extremidade WinRM.

Tipo:X509Certificate2
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-X509Certificates

Especifica uma matriz de certificados X509 que são implantados em um serviço hospedado.

Tipo:X509Certificate2[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False