New-AzureQuickVM

Referência

Módulo:: Azure

Configura e cria uma máquina virtual do Azure.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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. Este cmdlet pode implantar uma máquina virtual em um serviço existente do Azure. Como alternativa, esse cmdlet pode 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

Este 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 Https do WinRM 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 execute o sistema operacional Linux

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

Este comando cria uma máquina virtual que executa o sistema operacional Linux a partir de uma imagem. Este 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, em seguida, armazena-os 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. Baseia-se numa 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 localizações e, em seguida, armazena-as 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, previamente armazenado 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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-AvailabilitySetName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Certificates

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

Tipo:	CertificateSettingList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CustomDataFile

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

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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableGuestAgent

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableWinRMHttps

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EnableWinRMHttp

Indica que esse cmdlet habilita o WinRM sobre HTTP.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ImageName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

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

Continuar
Ignorar
Informe-se
SilenciosamenteContinue
Parar
Suspender

Tipo:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InformationVariable

Especifica uma variável de informação.

Tipo:	String
Aliases:	iv
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InstanceSize

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

ExtraPequeno
Pequena
Médio
Grande
ExtraGrande
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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Linux

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LinuxUser

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MediaLocation

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Name

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoExportPrivateKey

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoWinRMEndpoint

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Password

Especifica a senha para a conta administrativa.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Profile

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

Tipo:	AzureSMProfile
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ReservedIPName

Especifica o nome IP reservado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-ReverseDnsFqdn

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	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 Location ou AffinityGroup.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SSHKeyPairs

Especifica pares de chaves SSH.

Tipo:	SSHKeyPairList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SSHPublicKeys

Especifica chaves públicas SSH.

Tipo:	SSHPublicKeyList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SubnetNames

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

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-VNetName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Windows

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WinRMCertificate

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

Tipo:	X509Certificate2
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-X509Certificates

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

Tipo:	X509Certificate2[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Partilhar via