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 de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para 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. 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 do $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, armazena-os 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.

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. 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.

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 Gerenciamento Remoto do Windows (WinRM) 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:

Só de Leitura
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 este 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ção.

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

Continuar
Ignorar
Informe-se
SilenciosamenteContinue
Parar
Suspender

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:

ExtraPequeno
Pequeno
Meio
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

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 das 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 para a 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 é lido. 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 reversa de DNS.

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 Location 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 do 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

Partilhar via