Set-AzureVMSize
Define o tamanho de 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
Set-AzureVMSize
[-InstanceSize] <String>
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Set-AzureVMSize atualiza o tamanho de uma máquina virtual. Ele tem dois parâmetros: InstanceSize, que é o novo tamanho da máquina virtual, e VM, que é um objeto de máquina virtual recuperado usando o cmdlet Get-AzureVM . O resultado de Set-AzureVMSize pode ser canalizado para o cmdlet Update-AzureVM ou armazenado em uma variável para uso posterior. Nenhuma alteração real é feita até que Update-AzureVM seja executado.
Nota: Esse cmdlet exigirá que a máquina virtual seja provisionada novamente e poderá obter um novo endereço IP.
Exemplos
Exemplo 1: Definir o tamanho de uma máquina virtual
PS C:\> Get-AzureVM -ServiceName "MySvc1" -Name "MyVM3" | Set-AzureVMSize "Small" | Update-AzureVM
Este comando atualiza uma máquina virtual para o tamanho "Pequeno".
Parâmetros
-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 |
-InstanceSize
Especifica o tamanho da máquina virtual.
Os valores aceitáveis para esse parâmetro são:
--ExtraSmall --Small --Medium --Large --ExtraLarge --A5 --A6 --A7
Tipo: | String |
Cargo: | 1 |
Valor padrão: | None |
Obrigatório: | True |
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 |
-VM
Especifica o objeto de máquina virtual persistente do qual esse cmdlet define o tamanho.
Tipo: | IPersistentVM |
Aliases: | InputObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |