Partilhar via

Set-WAPackVM

  • Referência
Módulo:
Azure

Altera as propriedades de tamanho de 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

Set-WAPackVM
   -VM <VirtualMachine>
   -VMSizeProfile <HardwareProfile>
   [-PassThru]
   [-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 Set-WAPackVM altera as propriedades de tamanho de uma máquina virtual.

Exemplos

Exemplo 1: Especificar o tamanho de uma máquina virtual

PS C:\> $VirtualMachine = Get-WAPackVM -Name "ContosoV126"
PS C:\> $SizeProfile = Get-WAPackVMSizeProfile -Name "MediumSizeVM"
PS C:\> Set-WAPackVM -VM $VirtualMachine -VMSizeProfile $SizeProfile

O primeiro comando obtém a máquina virtual chamada ContosoV126 usando o cmdlet Get-WAPackVM e, em seguida, armazena esse objeto na variável $VirtualMachine.

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

O comando final atribui o perfil de tamanho armazenado no $SizeProfile à máquina virtual armazenada no $VirtualMachine.

Parâmetros

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

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

-VM

Especifica uma máquina virtual. Para obter uma máquina virtual, use o cmdlet Get-WAPackVM .

Tipo:VirtualMachine
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:False
Aceitar carateres universais:False