New-AzureQuickVM

  • Referência
Módulo:
Azure

Configura e cria uma máquina virtual do Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilitySetName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Certificates

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

Type:CertificateSettingList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableGuestAgent

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWinRMHttps

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:DnsServer[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableWinRMHttp

Indica que esse cmdlet habilita o WinRM sobre HTTP.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostCaching

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

  • ReadOnly
  • ReadWrite
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImageName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
  • Stop
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InstanceSize

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

  • ExtraSmall
  • Pequeno
  • 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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LinuxUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MediaLocation

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoExportPrivateKey

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWinRMEndpoint

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Especifica a senha da conta administrativa.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReservedIPName

Especifica o nome IP reservado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ReverseDnsFqdn

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SSHKeyPairs

Especifica pares de chaves SSH.

Type:SSHKeyPairList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SSHPublicKeys

Especifica chaves públicas SSH.

Type:SSHPublicKeyList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetNames

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VNetName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Windows

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WinRMCertificate

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

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-X509Certificates

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

Type:X509Certificate2[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False