Update-AzVmssVM

Referência

Módulo:: Az.Compute

Atualiza o estado de uma VM de 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 de 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 de 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 de VMss existente fornecida pelo nome do grupo de recursos, o nome da vmss e a ID da instância. O comando final atualiza a VM de VMss adicionando um novo disco de dados.

Exemplo 2: adicionar um disco de dados gerenciado a uma VM de 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 de VMss existente fornecida pelo nome do grupo de recursos, o nome da vmss e a ID da instância. O comando a seguir adiciona o disco gerenciado à VM de VMss armazenada localmente em $VmssVM. O comando final atualiza a VM de VMss com disco de dados adicionado.

Exemplo 3

Atualiza o estado de uma VM de 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 a 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 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 dimensionamento.

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 o scale-in) 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 de Vmss, que será codificada em base 64. O cliente não deve passar segredos 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 local

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