New-AzureVMConfig
Cria um objeto de configuração de máquina virtual do Azure.
Observação
Os cmdlets referenciados 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, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
New-AzureVMConfig
[-Name] <String>
[-InstanceSize] <String>
[[-HostCaching] <String>]
[[-AvailabilitySetName] <String>]
[[-Label] <String>]
[-ImageName] <String>
[[-MediaLocation] <String>]
[[-DiskLabel] <String>]
[-DisableBootDiagnostics]
[-LicenseType <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
New-AzureVMConfig
[-Name] <String>
[-InstanceSize] <String>
[[-HostCaching] <String>]
[[-AvailabilitySetName] <String>]
[[-Label] <String>]
[-DiskName] <String>
[-DisableBootDiagnostics]
[-LicenseType <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet New-AzureVMConfig cria um objeto de configuração de máquina virtual do Azure. Você pode usar esse objeto para executar uma nova implantação e adicionar uma nova máquina virtual a uma implantação existente.
Exemplos
Exemplo 1: Criar uma configuração de máquina virtual do Windows
PS C:\> $Image = (Get-AzureVMImage)[4].ImageName
C:\PS> New-AzureVMConfig -Name "MyVM1" -InstanceSize ExtraSmall -ImageName $Image | Add-AzureProvisioningConfig -Windows -Password $AdminPassword | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "Datadisk1" -LUN 0 | New-AzureVM -ServiceName "MySvc1"
Esse comando cria uma configuração de máquina virtual do Windows com disco do sistema operacional, disco de dados e configuração de provisionamento. Essa configuração é usada para criar uma nova máquina virtual.
Exemplo 2: Criar uma configuração de máquina virtual Linux
PS C:\> $Image = (Get-AzureVMImage)[7].ImageName
C:\PS> New-AzureVMConfig -Name "MyVM1" -InstanceSize ExtraSmall -ImageName $Image | Add-AzureProvisioningConfig -Linux -LinuxUser $LinuxUser -Password $AdminPassword | Add-AzureDataDisk -CreateNew -DiskSizeInGB 50 -DiskLabel "Datadisk1" -LUN 0 | New-AzureVM -ServiceName "MySvc1"
Esse comando cria uma nova configuração de máquina virtual Linux com disco do sistema operacional, disco de dados e configuração de provisionamento. Essa configuração é usada para criar uma nova máquina virtual.
Parâmetros
-AvailabilitySetName
Especifica o nome do conjunto de disponibilidade.
Tipo: | String |
Cargo: | 3 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableBootDiagnostics
Indica que a configuração desabilita o diagnóstico de inicialização. Por padrão, o diagnóstico de inicialização é habilitado na máquina virtual.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DiskLabel
Especifica um rótulo para o disco do sistema operacional.
Tipo: | String |
Cargo: | 7 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DiskName
Especifica um nome para o disco do sistema operacional.
Tipo: | String |
Cargo: | 5 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-HostCaching
Especifica o modo de cache do host para o disco do sistema operacional.
Os valores válidos são:
- ReadOnly
- ReadWrite
Tipo: | String |
Cargo: | 2 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ImageName
Especifica o nome da imagem da máquina virtual a ser usada para o disco do sistema operacional.
Tipo: | String |
Cargo: | 5 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- 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 |
-InstanceSize
Especifica o tamanho da instância.
Os valores aceitáveis para esse parâmetro são:
- ExtraSmall
- Small
- 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
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Label
Especifica um rótulo a ser atribuído à máquina virtual.
Tipo: | String |
Cargo: | 4 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-LicenseType
Especifica o tipo de licença para uma imagem ou disco licenciado localmente. Os valores aceitáveis para esse parâmetro são:
- Windows_Client
- Windows_Server
Especifique esse parâmetro somente para imagens que contêm o sistema operacional Windows Server.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MediaLocation
Especifica o local de armazenamento do Azure para o novo disco da máquina virtual.
Tipo: | String |
Cargo: | 6 |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome da máquina virtual.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o 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 |