New-AzureVM
Cria uma máquina virtual do Azure.
Observação
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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
New-AzureVM
-ServiceName <String>
[-DeploymentLabel <String>]
[-DeploymentName <String>]
[-VNetName <String>]
[-DnsSettings <DnsServer[]>]
[-InternalLoadBalancerConfig <InternalLoadBalancerConfig>]
-VMs <PersistentVM[]>
[-WaitForBoot]
[-ReservedIPName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureVM
-ServiceName <String>
[-Location <String>]
[-AffinityGroup <String>]
[-ServiceLabel <String>]
[-ReverseDnsFqdn <String>]
[-ServiceDescription <String>]
[-DeploymentLabel <String>]
[-DeploymentName <String>]
[-VNetName <String>]
[-DnsSettings <DnsServer[]>]
[-InternalLoadBalancerConfig <InternalLoadBalancerConfig>]
-VMs <PersistentVM[]>
[-WaitForBoot]
[-ReservedIPName <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet New-AzureVM adiciona uma nova máquina virtual a um serviço existente do Azure ou cria uma máquina virtual e um serviço na assinatura atual se o Local ou o AffinityGroup for especificado.
Exemplos
Exemplo 1: Criar uma máquina virtual para uma configuração do Windows
PS C:\> New-AzureVMConfig -Name "VirtualMachine07" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[4].ImageName | Add-AzureProvisioningConfig -Windows -Password $adminPassword -AdminUsername PsTestAdmin | New-AzureVM -ServiceName "ContosoService" -AffinityGroup "Contoso" -WaitForBoot
Esse comando cria uma configuração de provisionamento com base em uma configuração de máquina virtual para o sistema operacional Windows e a usa para criar uma máquina virtual em um grupo de afinidade especificado.
Exemplo 2: Criar uma máquina virtual para uma configuração do Linux
PS C:\> New-AzureVMConfig -Name "SUSEVM02" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[7].ImageName | Add-AzureProvisioningConfig -Linux -LinuxUser "RootMain" -Password "password" -AdminUsername PsTestAdmin | New-AzureVM
Esse comando cria uma configuração de provisionamento com base em uma configuração de máquina virtual para Linux e a usa para criar uma máquina virtual em um grupo de afinidade especificado.
Exemplo 3: Criar uma máquina virtual e adicionar um disco de dados
PS C:\> $Images = Get-AzureVMImage
PS C:\> $Image = $Images[4]
PS C:\> $VirtualMachine02 = New-AzureVMConfig -Name "VirtualMachine02" -InstanceSize ExtraSmall -ImageName $myImage.ImageName | Add-AzureProvisioningConfig -Windows -Password "password" | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "DataDisk50" -LUN 0
Os dois primeiros comandos obtêm imagens disponíveis usando o cmdlet Get-AzureVMImage e armazenam um deles na variável $Image.
Esse comando cria uma configuração de provisionamento com base em uma configuração de máquina virtual para o sistema operacional Windows e a usa para criar uma máquina virtual com um disco de dados do Azure.
Exemplo 4: Criar uma máquina virtual com um endereço IP reservado
PS C:\> New-AzureVMConfig -Name "VirtualMachine06" -InstanceSize ExtraSmall -ImageName (Get-AzureVMImage)[4].ImageName | Add-AzureProvisioningConfig -Windows -Password $adminPassword -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService02" -AffinityGroup "Contoso" -ReservedIPName $ipName
Esse comando cria uma configuração de provisionamento com base em uma configuração de máquina virtual para o sistema operacional Windows e a usa para criar uma máquina virtual com um endereço IP reservado.
Parâmetros
-AffinityGroup
Especifica o grupo de afinidade do Azure no qual o serviço de nuvem reside. Esse parâmetro é necessário somente quando esse cmdlet cria um serviço de nuvem.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DeploymentLabel
Especifica um rótulo para a implantação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DeploymentName
Especifica um nome de implantação. Se não for especificado, esse cmdlet usará o nome do serviço como o nome da implantação.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DnsSettings
Especifica um objeto de servidor DNS que define as configurações de DNS para a nova implantação.
Tipo: | DnsServer[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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
- Parar
- Suspend
Tipo: | ActionPreference |
Aliases: | infa |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InformationVariable
Especifica uma variável de informação.
Tipo: | String |
Aliases: | iv |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InternalLoadBalancerConfig
Especifica um balanceador de carga interno. Este parâmetro não é usado.
Tipo: | InternalLoadBalancerConfig |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Location
Especifica o local que hospeda o novo serviço. Se o serviço já existir, não especifique esse parâmetro.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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.
Tipo: | AzureSMProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ReservedIPName
Especifica o nome do endereço IP reservado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ReverseDnsFqdn
Especifica o nome de domínio totalmente qualificado para DNS reverso.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ServiceDescription
Especifica uma descrição para o novo serviço.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ServiceLabel
Especifica um rótulo para o novo serviço.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-ServiceName
Especifica o nome do serviço novo ou existente.
Se o serviço não existir, esse cmdlet o criará para você. Use o parâmetro Location ou AffinityGroup para especificar onde criar o serviço.
Se o serviço existir, o parâmetro Location ou AffinityGroup não será necessário.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-VMs
Especifica uma lista de objetos de máquina virtual a serem criados.
Tipo: | PersistentVM[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-VNetName
Especifica o nome da rede virtual onde esse cmdlet implanta a máquina virtual.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WaitForBoot
Especifica que esse cmdlet aguarda que a máquina virtual atinja o estado ReadyRole . Esse cmdlet falhará se a máquina virtual cair em um dos seguintes estados durante a espera: FailedStartingVM, ProvisioningFailed, ProvisioningTimeout.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |