Compartilhar via


Update-AzVmssVM

Atualiza o estado de uma VM Vmss.

Sintaxe

Update-AzVmssVM
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [-InstanceId] <String>
      [-DataDisk <PSVirtualMachineDataDisk[]>]
      [-ProtectFromScaleIn <Boolean>]
      [-ProtectFromScaleSetAction <Boolean>]
      [-AsJob]
      [-UserData <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVmssVM
      [-DataDisk <PSVirtualMachineDataDisk[]>]
      [-ProtectFromScaleIn <Boolean>]
      [-ProtectFromScaleSetAction <Boolean>]
      [-ResourceId] <String>
      [-AsJob]
      [-UserData <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVmssVM
      [-DataDisk <PSVirtualMachineDataDisk[]>]
      [-ProtectFromScaleIn <Boolean>]
      [-ProtectFromScaleSetAction <Boolean>]
      [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza o estado de uma VM Vmss. Por enquanto, a única atualização permitida é adicionar um disco de dados gerenciado.

Exemplos

Exemplo 1: Adicionar um disco de dados gerenciado a uma VM Vmss usando New-AzVMDataDisk

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$datadisk = New-AzVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
Update-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk

O primeiro comando obtém um disco gerenciado existente. O próximo comando cria um objeto de disco de dados com o disco gerenciado. O próximo comando obtém uma VM Vmss existente fornecida pelo nome do grupo de recursos, o nome vmss e a ID da instância. O comando final atualiza a VM Vmss adicionando um novo disco de dados.

Exemplo 2: Adicionar um disco de dados gerenciado a uma VM Vmss usando Add-AzVMDataDisk

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
$VmssVM = Add-AzVMDataDisk -VM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
Update-AzVmssVM -VirtualMachineScaleSetVM $VmssVM

O primeiro comando obtém um disco gerenciado existente. O próximo comando obtém uma VM Vmss existente fornecida pelo nome do grupo de recursos, o nome vmss e a ID da instância. O próximo comando adiciona o disco gerenciado à VM Vmss armazenada localmente no $VmssVM. O comando final atualiza a VM Vmss com o disco de dados adicionado.

Exemplo 3

Atualiza o estado de uma VM Vmss. (gerado automaticamente)

Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DataDisk

Tipo:PSVirtualMachineDataDisk[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceId

Especifica a ID da instância de uma VM VMSS.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProtectFromScaleIn

Indica que a VM do conjunto de dimensionamento de máquinas virtuais não deve ser considerada para exclusão durante uma operação de redução horizontal.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProtectFromScaleSetAction

Indica que as atualizações ou ações de modelo (incluindo redução horizontal) iniciadas no VMSS não devem ser aplicadas à VM VMSS.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do Grupo de Recursos do VMSS.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceId

A ID do recurso para a VM do conjunto de dimensionamento de máquinas virtuais

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UserData

UserData para a VM Vmss, que será codificada em base 64. O cliente não deve passar nenhum segredo aqui.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualMachineScaleSetVM

Objeto de VM do conjunto de dimensionamento de máquinas virtuais locais

Tipo:PSVirtualMachineScaleSetVM
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMScaleSetName

O nome do conjunto de dimensionamento de máquinas virtuais

Tipo:String
Aliases:Name
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

PSVirtualMachineDataDisk[]

PSVirtualMachineScaleSetVM

Saídas

PSVirtualMachineScaleSetVM