Update-AzVmssVM
Atualiza o estado de uma VM Vmss.
Sintaxe
DefaultParameter (Predefinição)
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 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 o 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 o 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 disco de dados adicionado.
Exemplo 3
Atualiza o estado de uma VM Vmss. (autogenerated)
Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DataDisk
Atualiza o estado de uma VM Vmss. Por enquanto, a única atualização permitida é adicionar um disco de dados gerenciado.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-InstanceId
Especifica o ID da instância de uma VM VMSS.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
DefaultParameter
Position: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ProtectFromScaleIn
Indica que a VM do conjunto de dimensionamento da máquina virtual não deve ser considerada para exclusão durante uma operação de expansão.
Propriedades dos parâmetros
Tipo: Boolean
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ProtectFromScaleSetAction
Indica que as atualizações de modelo ou ações (incluindo scale-in) iniciadas no VMSS não devem ser aplicadas à VM VMSS.
Propriedades dos parâmetros
Tipo: Boolean
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ProxyAgentKeyIncarnationId
Aumentar o valor desse parâmetro permite que os usuários redefina a chave usada para proteger o canal de comunicação entre convidado e host.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: KeyIncarnationId
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ResourceGroupName
Especifica o nome do Grupo de Recursos do VMSS.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
DefaultParameter
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ResourceId
A ID do recurso para a VM do conjunto de dimensionamento da máquina virtual
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
ResourceIdParameter
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-UserData
UserData para o Vmss Vm, que será codificado em base-64. O cliente não deve passar nenhum segredo aqui.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
DefaultParameter
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
ResourceIdParameter
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-VirtualMachineScaleSetVM
Objeto VM do conjunto de dimensionamento da máquina virtual local
Propriedades dos parâmetros
Conjuntos de parâmetros
ObjectParameter
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-VMScaleSetName
O nome do conjunto de escala da máquina virtual
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Nome
Conjuntos de parâmetros
DefaultParameter
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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
