New-WAPackVM

Cria uma máquina virtual.

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-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 o armazena 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 o armazena 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 SSH (Secure Shell) para a conta de Administrador.

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

-Linux

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

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

-Name

Especifica um nome para a máquina virtual.

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

-OSDisk

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

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

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

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

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

-VMCredential

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

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

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

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

-Windows

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

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