O cmdlet Update-AzVM atualiza o estado de uma máquina virtual Azure para o estado de um objeto de máquina virtual.
Use o PreferredVMSize em qualquer conjunto de parâmetros para definir a pré-visualização FlexProfile.PreferredVMSize.
O Azure pode implementar o tamanho preferido ou uma alternativa compatível com base na capacidade e posicionamento.
Este parâmetro sobrepõe-se HardwareProfile.VmSize no pedido de saída sem alterar o objeto HardwareProfile de entrada ou FlexProfile.
Quando omitidos, o FlexProfile HardwareProfile.VmSize e o FlexProfile do objeto de entrada são preservados no pedido.
Para mudar para o FlexProfile editando diretamente o objeto, defina FlexProfile.PreferredVMSize e limpe HardwareProfile.VmSize antes de chamar o Update-AzVM.
Para optar por sair, defina FlexProfile e $null especifique um fixo HardwareProfile.VmSize; omita PreferredVMSize.
Para uma viagem de ida e volta GET-to-update de uma VM FlexProfile existente, o cmdlet preserva tanto o FlexProfile como o service-reportado HardwareProfile.VmSize no pedido sem alterar o objeto de entrada.
O FlexProfile é uma funcionalidade de pré-visualização que requer o registo da Microsoft.Compute/FlexProfileEnabled funcionalidade de subscrição e a disponibilidade na região-alvo.
As famílias de VMs suportadas variam consoante a região. O Azure valida posicionamentos não suportados e cadeias vazias de tamanho preferencial.
Este comando atualiza a máquina virtual, $VirtualMachine, em ResourceGroup11.
O comando o atualiza usando o objeto de máquina virtual armazenado na variável $VirtualMachine.
Para obter um objeto de máquina virtual, use o cmdlet Get-AzVM .
Exemplo 2: Atualizar uma máquina virtual para desativar o hyperthreading.
$resourceGroupName = 'Resource Group Name>'
$vmname = 'Virtual Machine Name';
$domainNameLabel = "d1" + $rgname;
$vCPUsCoreInitial = 2;
$vCPUsAvailableInitial = 4;
$vCPUsCore1 = 1;
$vCPUsAvailable1 = 1;
$vmSize = 'Standard_D4s_v4';
$securePassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$user = "user";
$cred = New-Object System.Management.Automation.PSCredential ($user, $securePassword);
$vm = New-AzVM -ResourceGroupName $rgname -Name $vmname -Credential $cred -DomainNameLabel $domainNameLabel -Size $vmSize -vCPUCountPerCore $vCPUsCoreInitial -vCPUCountAvailable $vCPUsAvailableInitial;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 2, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 4.
Update-AzVM -ResourceGroupName $rgname -VM $vm -vCPUCountAvailable $vCPUsAvailable1 -vCPUCountPerCore $vCPUsCore1;
# The $vm.HardwareProfile.VmSizeProperties.VCPUsPerCore property is 1, and the $vm.HardwareProfile.VmSizeProperties.VCPUsAvailable property is 1.
# Hyperthreading is now disabled for this VM.
Exemplo 3: Atualizar o modo de processador de uma VM
Este exemplo atualiza uma máquina virtual para que seja explicitamente excluida de qualquer atribuição de reserva de capacidade e consuma capacidade disponível publicamente em vez disso.
Exemplo 5: Atualizar uma VM para usar um tamanho preferido
Este exemplo sobrepõe o tamanho fixo do pedido com o FlexProfile sem alterar $vm.
A subscrição deve estar registada para a pré-visualização e a região da VM deve suportá-la.
Recupere novamente a VM para inspecionar o modelo atualizado.
Exemplo 6: Mudar para FlexProfile editando o objeto VM
Ao alternar uma VM de tamanho fixo editando diretamente o seu modelo, limpe o VmSize para que o pedido não contenha tanto um tamanho fixo como o FlexProfile.
Usar o PreferredVMSize como no exemplo anterior trata o pedido de saída sem estas edições de objetos.
Exemplo 7: Preservar o FlexProfile numa viagem de ida e volta GET-to-update
Para uma VM FlexProfile existente, isto preserva o seu FlexProfile e o serviço reportado HardwareProfile.VmSize ao atualizar as etiquetas.
Nenhuma das propriedades é alterada em $vm.
Usa a vista de modelos do Get-AzVM sem o Status.
Exemplo 8: Optar por não usar o FlexProfile e usar um tamanho fixo
Este exemplo elimina o FlexProfile e pede um tamanho fixo. Não forneça PreferredVMSize ao optar por não participar. O Azure valida se o tamanho e a colocação solicitados são suportados.
Parâmetros
-AlignRegionalDisksToVMZone
Especifica se os discos regionais devem ser alinhados/movidos para a zona VM. Isso é aplicável apenas para VMs com propriedades de posicionamento definidas. Tenha em atenção que esta alteração é irreversível.
Especifica que a máquina virtual está explicitamente excluída de qualquer atribuição de reserva de capacidade.
Quando definida, a máquina virtual não estará implícita ou explicitamente associada a qualquer reserva de capacidade e consumirá em vez disso capacidade disponível publicamente.
A propriedade EncryptionAtHost pode ser usada pelo usuário na solicitação para habilitar ou desabilitar a Criptografia de Host para a máquina virtual ou o conjunto de dimensionamento da máquina virtual.
Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host.
Especifica a lista de identidades de usuário associadas à máquina virtual.
As referências de identidade do utilizador serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. IdentidadeGerenciada/identidades/{NomeIdentidade}'
utilizado para condicionar um pedido para o PUT e outros métodos não seguros. O servidor só retornará os recursos solicitados se o recurso corresponder a um dos valores ETag listados. Omita esse valor para sempre substituir o recurso atual. Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.
Usado para condicionar uma solicitação para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores ETag listados corresponder à entidade atual. Usado para condicionar uma solicitação para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores ETag listados corresponder à entidade atual. Defina como '*' para permitir que um novo conjunto de registros seja criado, mas para impedir a atualização de um conjunto de registros existente. Outros valores resultarão em erro do servidor, pois não são suportados.
Especifica o preço máximo que você está disposto a pagar por uma VM/VMSS de baixa prioridade. Este preço é em dólares americanos. Esse preço será comparado com o preço atual de baixa prioridade para o tamanho da VM. Além disso, os preços são comparados no momento da criação/atualização de VM/VMSS de baixa prioridade e a operação só terá êxito se o maxPrice for maior do que o preço de baixa prioridade atual. O maxPrice também será usado para remover uma VM/VMSS de baixa prioridade se o preço atual de baixa prioridade ultrapassar o maxPrice após a criação de VM/VMSS. Os valores possíveis são: qualquer valor decimal maior que zero. Exemplo: 0,01538. -1 indica que a VM/VMSS de baixa prioridade não deve ser removida por razões de preço. Além disso, o preço máximo padrão é -1 se não for fornecido por você.
Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.
Especifica o tamanho preferido da VM para o FlexProfile de pré-visualização, por Standard_D4s_v5exemplo .
A Azure pode escolher uma alternativa compatível com base na capacidade e na localização.
Em todos os conjuntos de parâmetros, este parâmetro sobrepõe os pedidos HardwareProfile.VmSize e conjuntos FlexProfile.PreferredVMSize de saída sem alterar o perfil de hardware do objeto de entrada ou o FlexProfile.
Quando omitidos, tanto o FlexProfile como o VmSize de entrada são preservados no pedido, incluindo o tamanho reportado pelo serviço de uma VM FlexProfile existente.
Para alternar editando diretamente o objeto, defina o FlexProfile e limpe o VmSize. Para optar por sair, limpe o FlexProfile, defina um VmSize fixo e omita este parâmetro.
Esta funcionalidade requer registo de pré-visualização e disponibilidade regional. O Azure valida posicionamentos não suportados e strings vazias.
Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. Por padrão, UefiSettings não será habilitado, a menos que essa propriedade esteja definida.
Especifica os recursos e os grupos de recursos que podem ser marcados com um conjunto de pares nome-valor.
Adicionar tags a recursos permite agrupar recursos entre grupos de recursos e criar suas próprias exibições.
Cada recurso ou grupo de recursos pode ter no máximo 15 tags.
O sinalizador que habilita ou desabilita um recurso para ter um ou mais discos de dados gerenciados com UltraSSD_LRS tipo de conta de armazenamento na VM.
Os discos gerenciados com o tipo de conta de armazenamento UltraSSD_LRS podem ser adicionados a uma máquina virtual somente se essa propriedade estiver habilitada.
Especifica o número de vCPUs disponíveis para a VM. Quando essa propriedade não é especificada no corpo da solicitação, o comportamento padrão é defini-la com o valor de vCPUs disponíveis para esse tamanho de VM exposto na resposta da api de Listar todos os tamanhos de máquina virtual disponíveis em uma região.
Especifica a relação vCPU para núcleo físico. Quando essa propriedade não é especificada no corpo da solicitação, o comportamento padrão é definido como o valor de vCPUsPerCore para o Tamanho da VM exposto na resposta da api de Listar todos os tamanhos de máquina virtual disponíveis em uma região. Definir essa propriedade como 1 também significa que o hyper-threading está desabilitado.
Especifica um objeto de máquina virtual local.
Para obter um objeto de máquina virtual, use o cmdlet Get-AzVM .
Este objeto de máquina virtual contém o estado atualizado para a máquina virtual.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.