New-AzureQuickVM
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 |