Partilhar via

New-WAPackVM

  • Referência
Módulo:
Azure

Cria uma máquina virtual.

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-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-ProductKey <String>]
   [-Windows]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   -Template <VMTemplate>
   -VMCredential <PSCredential>
   [-VNet <VMNetwork>]
   [-Linux]
   [-AdministratorSSHKey <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVM
   -Name <String>
   [-VNet <VMNetwork>]
   -OSDisk <VirtualHardDisk>
   -VMSizeProfile <HardwareProfile>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Esses tópicos foram preteridos e serão removidos no futuro. Este tópico descreve o cmdlet na versão 0.8.1 do módulo PowerShell do Microsoft Azure. Para descobrir a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

O cmdlet New-WAPackVM cria uma máquina virtual.

Exemplos

Exemplo 1: Criar uma máquina virtual para o sistema operacional Windows usando um modelo

PS C:\> $Credentials = Get-Credential PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate04"PS C:\> New-WAPackVM -Name "ContosoV023" -Template $Template -VMCredential $Credentials -Windows

O primeiro comando cria um objeto PSCredential e, em seguida, armazena-o na variável $Credentials. O cmdlet solicita uma conta e uma senha. Para obter mais informações, digite Get-Help Get-Credential.

O segundo comando obtém o modelo de máquina virtual chamado ContosoTemplate04 usando o cmdlet Get-WAPackVMTemplate e o armazena na variável $Template.

O comando final cria uma máquina virtual chamada ContosoV023, com base no modelo armazenado na variável $Template. O comando especifica o parâmetro Windows e, portanto, a máquina virtual deve executar uma versão do sistema operacional Windows.

Exemplo 2: Criar uma máquina virtual para o sistema operacional Linux usando um modelo

PS C:\> $Credentials = Get-Credential
PS C:\> $Template = Get-WAPackVMTemplate -Name "ContosoTemplate19"
PS C:\> New-WAPackVM -Linux -Name "ContosoV028" -Template $Template -VMCredential $Credentials

O primeiro comando cria um objeto PSCredential e, em seguida, armazena-o na variável $Credentials.

O segundo comando obtém o modelo de máquina virtual chamado ContosoTemplate19 usando o cmdlet Get-WAPackVMTemplate e o armazena na variável $Template.

O comando final cria uma máquina virtual chamada ContosoV028, com base no modelo armazenado na variável $Template. O comando especifica o parâmetro Linux e, portanto, a máquina virtual deve executar uma versão do sistema operacional Linux.

Exemplo 3: Criar uma máquina virtual a partir de um disco do sistema operacional e perfil de tamanho

PS C:\> $OSDisk = Get-WAPackVMOSDisk -Name "ContosoDiskOS"
PS C:\> $SizeProfile = Get-WAPackVMSizeProfile -Name "MediumSizeVM"
PS C:\> New-WAPackVM -Name "ContosoV073" -OSDisk $OSDisk -VMSizeProfile $SizeProfile

O primeiro comando obtém um disco do sistema operacional chamado ContosoDiskOS usando o cmdlet Get-WAPackVMOSDisk e o armazena na variável $OSDisk.

O segundo comando obtém o perfil de tamanho chamado MediumSizeVM usando o cmdlet Get-WAPackVMSizeProfile e o armazena na variável $SizeProfile.

O comando final cria uma máquina virtual chamada ContosoV073 a partir do disco do sistema operacional armazenado no $OSDisk e do perfil de tamanho armazenado no $SizeProfile.

Parâmetros

-AdministratorSSHKey

Especifica a chave Secure Shell (SSH) para a conta de Administrador.

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

-Linux

Indica que o cmdlet cria uma máquina virtual para executar o sistema operacional Linux.

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

-Name

Especifica um nome para a máquina virtual.

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

-OSDisk

Especifica um disco do sistema operacional como um objeto VirtualHardDisk . Para obter um disco do sistema operacional, use o cmdlet Get-WAPackVMOSDisk .

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

-ProductKey

Especifica uma chave do produto. A chave do produto é um número de 25 dígitos que identifica a licença do produto. Use uma chave do produto (Product Key) para um sistema operacional que você planeja instalar em uma máquina virtual ou host.

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

-Template

Especifica um modelo. O cmdlet cria uma máquina virtual com base no modelo especificado. Para obter um objeto de modelo, use o cmdlet Get-WAPackVMTemplate.

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

-VMCredential

Especifica a credencial para a conta de Administrador local. Para obter um objeto PSCredential , use o cmdlet Get-Credential . Para obter mais informações, digite Get-Help Get-Credential.

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

-VMSizeProfile

Especifica um perfil de tamanho para uma máquina virtual como um objeto HardwareProfile . Para obter um perfil de tamanho, use o cmdlet Get-WAPackVMSizeProfile .

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

-VNet

Especifica uma rede virtual. O cmdlet conecta a máquina virtual à rede virtual especificada. Para obter uma rede virtual, use o cmdlet Get-WAPackVNet .

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

-Windows

Indica que o cmdlet cria uma máquina virtual para executar o sistema operacional Windows.

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