Update-AzVmssVM
Atualiza o estado de uma VM de VMss.
Sintaxe
DefaultParameter (Default)
Update-AzVmssVM
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[-InstanceId] <String>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-AsJob]
[-UserData <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceIdParameter
Update-AzVmssVM
[-ResourceId] <String>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-AsJob]
[-UserData <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ObjectParameter
Update-AzVmssVM
[-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
[-ProxyAgentKeyIncarnationId <Int32>]
[-DataDisk <PSVirtualMachineDataDisk[]>]
[-ProtectFromScaleIn <Boolean>]
[-ProtectFromScaleSetAction <Boolean>]
[-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. (autogenerated)
Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: cf
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DataDisk
Atualiza o estado de uma VM de VMss. Por enquanto, a única atualização permitida é adicionar um disco de dados gerenciado.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-InstanceId
Especifica a ID da instância de uma VM VMSS.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
DefaultParameter
Cargo: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: Boolean
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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.
Propriedades do parâmetro
Tipo: Boolean
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ProxyAgentKeyIncarnationId
Aumentar o valor desse parâmetro permite que os usuários redefinam a chave usada para proteger o canal de comunicação entre o convidado e o host.
Propriedades do parâmetro
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: KeyIncarnationId
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceGroupName
Especifica o nome do Grupo de Recursos do VMSS.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
DefaultParameter
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceId
A ID do recurso para a VM do conjunto de dimensionamento de máquinas virtuais
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
ResourceIdParameter
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-UserData
UserData para a VM de Vmss, que será codificada em base 64. O cliente não deve passar segredos aqui.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
DefaultParameter
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
ResourceIdParameter
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-VirtualMachineScaleSetVM
Objeto de VM do conjunto de dimensionamento de máquinas virtuais local
Propriedades do parâmetro
Conjuntos de parâmetros
ObjectParameter
Cargo: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-VMScaleSetName
O nome do conjunto de dimensionamento de máquinas virtuais
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: Nome
Conjuntos de parâmetros
DefaultParameter
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: wi
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
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 .
Saídas
