Update-AzureRmVmss
Atualiza o estado de um VMSS.
Aviso
O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Syntax
Update-AzureRmVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
[-ImageReferenceSku <String>]
[-ManagedDiskStorageAccountType <String>]
[-PlanPublisher <String>]
[-ProvisionVMAgent <Boolean>]
[-BootDiagnosticsEnabled <Boolean>]
[-Overprovision <Boolean>]
[-MaxBatchInstancePercent <Int32>]
[-TimeZone <String>]
[-BootDiagnosticsStorageUri <String>]
[-AutomaticOSUpgrade <Boolean>]
[-DisableAutoRollback <Boolean>]
[-SinglePlacementGroup <Boolean>]
[-CustomData <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-ImageReferenceId <String>]
[-DisablePasswordAuthentication <Boolean>]
[-Tag <Hashtable>]
[-PlanName <String>]
[-MaxUnhealthyUpgradedInstancePercent <Int32>]
[-ImageReferencePublisher <String>]
[-PlanProduct <String>]
[-VhdContainer <String[]>]
[-ImageUri <String>]
[-SkuTier <String>]
[-EnableAutomaticUpdate <Boolean>]
[-LicenseType <String>]
[-SkuName <String>]
[-PlanPromotionCode <String>]
[-MaxUnhealthyInstancePercent <Int32>]
[-SkuCapacity <Int32>]
[-OsDiskWriteAccelerator <Boolean>]
[-ImageReferenceOffer <String>]
[-PauseTimeBetweenBatches <String>]
[-OsDiskCaching <CachingTypes>]
[-ImageReferenceVersion <String>]
[-UltraSSDEnabled <Boolean>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzureRmVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
[-ImageReferenceSku <String>]
[-IdentityId <String[]>]
[-ManagedDiskStorageAccountType <String>]
[-PlanPublisher <String>]
[-ProvisionVMAgent <Boolean>]
[-BootDiagnosticsEnabled <Boolean>]
[-Overprovision <Boolean>]
[-MaxBatchInstancePercent <Int32>]
[-TimeZone <String>]
[-BootDiagnosticsStorageUri <String>]
[-AutomaticOSUpgrade <Boolean>]
[-DisableAutoRollback <Boolean>]
[-SinglePlacementGroup <Boolean>]
[-CustomData <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-ImageReferenceId <String>]
[-DisablePasswordAuthentication <Boolean>]
[-Tag <Hashtable>]
[-PlanName <String>]
[-MaxUnhealthyUpgradedInstancePercent <Int32>]
[-ImageReferencePublisher <String>]
[-PlanProduct <String>]
[-VhdContainer <String[]>]
[-ImageUri <String>]
[-SkuTier <String>]
[-EnableAutomaticUpdate <Boolean>]
[-LicenseType <String>]
-IdentityType <ResourceIdentityType>
[-SkuName <String>]
[-PlanPromotionCode <String>]
[-MaxUnhealthyInstancePercent <Int32>]
[-SkuCapacity <Int32>]
[-OsDiskWriteAccelerator <Boolean>]
[-ImageReferenceOffer <String>]
[-PauseTimeBetweenBatches <String>]
[-OsDiskCaching <CachingTypes>]
[-ImageReferenceVersion <String>]
[-UltraSSDEnabled <Boolean>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Update-AzureRmVmss atualiza o estado de um VMSS (Conjunto de Escala de Máquina Virtual) para o estado de um objeto VMSS local.
Exemplos
Exemplo 1: Atualize o estado de um VMSS para o estado de um objeto VMSS local.
PS C:\> Update-AzureRmVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS
Este comando atualiza o estado do VMSS chamado VMSS001 que pertence ao grupo de recursos chamado Group001 para o estado de um objeto VMSS local, $LocalVMSS.
Parâmetros
-AsJob
Execute o cmdlet em segundo plano e retorne um Job para acompanhar o progresso.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutomaticOSUpgrade
Define se as atualizações do sistema operacional devem ser aplicadas automaticamente para dimensionar instâncias de conjunto de forma contínua quando uma versão mais recente da imagem estiver disponível.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootDiagnosticsEnabled
Se o diagnóstico de inicialização deve ser habilitado no conjunto de dimensionamento da máquina virtual.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BootDiagnosticsStorageUri
URI da conta de armazenamento a ser usada para colocar a saída do console e a captura de tela.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomData
Especifica uma cadeia de caracteres codificada em base 64 de dados personalizados. Isso é decodificado para uma matriz binária que é salva como um arquivo na máquina virtual. O comprimento máximo da matriz binária é de 65535 bytes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableAutoRollback
Desativar a reversão automática para a política de atualização automática do sistema operacional
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisablePasswordAuthentication
Indica que esse cmdlet desabilita a autenticação de senha para o sistema operacional Linux.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutomaticUpdate
Indica se as máquinas virtuais do Windows no VMSS estão habilitadas para atualizações automáticas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdentityId
Especifica a lista de identidades de usuário associadas ao conjunto de escala da máquina virtual. As referências de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IdentityType
Especifica o tipo de identidade usado para o conjunto de escala de máquina virtual. O tipo 'SystemAssignedUserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'Nenhum' removerá todas as identidades do conjunto de escala da máquina virtual. Os valores aceitáveis para este parâmetro são:
- SystemAssigned
- UserAssigned
- SystemAssignedUserAssigned
- Nenhuma
Type: | Nullable<T>[ResourceIdentityType] |
Accepted values: | SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageReferenceId
Especifica a ID de referência da imagem.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageReferenceOffer
Especifica o tipo de oferta de imagem de máquina virtual (VMImage). Para obter uma oferta de imagem, use o cmdlet Get-AzureRmVMImageOffer.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageReferencePublisher
Especifica o nome de um editor de um VMImage. Para obter um editor, use o cmdlet Get-AzureRmVMImagePublisher.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageReferenceSku
Especifica a SKU VMImage. Para obter SKUs, use o cmdlet Get-AzureRmVMImageSku.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageReferenceVersion
Especifica a versão do VMImage. Para usar a versão mais recente, especifique um valor de latest em vez de uma versão específica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageUri
Especifica o URI de blob para a imagem do usuário. O VMSS cria um disco do sistema operacional no mesmo contêiner da imagem do usuário.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseType
Especifique o tipo de licença, que é para trazer seu próprio cenário de licença.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagedDiskStorageAccountType
Especifica o tipo de conta de armazenamento para disco gerenciado. Os valores aceitáveis para este parâmetro são:
- PadrãoLRS
- PremiumLRS
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxBatchInstancePercent
A porcentagem máxima do total de instâncias de máquina virtual que serão atualizadas simultaneamente pela atualização sem interrupção em um lote. Como isso é máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que a porcentagem de instâncias em um lote diminua para garantir maior confiabilidade. Se o valor não for especificado, ele será definido como 20.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxUnhealthyInstancePercent
A porcentagem máxima do total de instâncias de máquina virtual no conjunto de escala que pode estar simultaneamente não íntegra, seja como resultado de ser atualizada ou por ser encontrada em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização contínua seja abortada. Esta restrição será verificada antes de iniciar qualquer lote. Se o valor não for especificado, ele será definido como 20.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxUnhealthyUpgradedInstancePercent
A porcentagem máxima de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação acontecerá depois que cada lote for atualizado. Se essa porcentagem for excedida, a atualização contínua será anulada. Se o valor não for especificado, ele será definido como 20.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OsDiskCaching
Especifica o modo de cache do disco do sistema operacional. Os valores aceitáveis para este parâmetro são:
- Nenhuma
- ReadOnly
- ReadWrite O valor padrão é ReadWrite. Se você alterar o valor de cache, o cmdlet reiniciará a máquina virtual. Essa configuração afeta a consistência e o desempenho do disco.
Type: | CachingTypes |
Accepted values: | None, ReadOnly, ReadWrite |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OsDiskWriteAccelerator
Especifica se o WriteAccelerator deve ser habilitado ou desabilitado no disco do sistema operacional.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Overprovision
Indica se o cmdlet provisiona demais o VMSS.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PauseTimeBetweenBatches
O tempo de espera entre a conclusão da atualização para todas as máquinas virtuais em um lote e o início do próximo lote. A duração do tempo deve ser especificada no formato ISO 8601. O valor padrão é 0 segundos (PT0S).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanName
Especifica o nome do plano.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanProduct
Especifica o produto do plano.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanPromotionCode
Especifica o código promocional do plano.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PlanPublisher
Especifica o editor do plano.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProvisionVMAgent
Indica se o agente de máquina virtual deve ser provisionado nas máquinas virtuais do Windows no VMSS.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos ao qual o VMSS pertence.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SinglePlacementGroup
Especifica o grupo de posicionamento único.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuCapacity
Especifica o número de instâncias no VMSS.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuName
Especifica o tamanho de todas as instâncias do VMSS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkuTier
Especifica a camada do VMSS. Os valores aceitáveis para este parâmetro são:
- Standard
- Básica
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeZone
Especifica o fuso horário para o sistema operacional Windows.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UltraSSDEnabled
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 no conjunto de dimensionamento de máquina virtual. Os discos gerenciados com UltraSSD_LRS tipo de conta de armazenamento só podem ser adicionados a um VMSS se essa propriedade estiver habilitada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpgradePolicyMode
Especificado o modo de uma atualização para máquinas virtuais no conjunto de escala. Os valores aceitáveis para este parâmetro são:
- Automático
- Manual
- Rolamento
Type: | UpgradeMode |
Accepted values: | Automatic, Manual, Rolling |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VhdContainer
Especifica as URLs de contêiner usadas para armazenar discos do sistema operacional para o VMSS.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualMachineScaleSet
Especifica um objeto VMSS local. Para obter um objeto VMSS, use o cmdlet Get-AzureRmVmss. Este objeto de máquina virtual contém o estado atualizado para o VMSS.
Type: | PSVirtualMachineScaleSet |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMScaleSetName
Especifica o nome do VMSS que esse cmdlet cria.
Type: | String |
Aliases: | Name |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Parâmetros: VirtualMachineScaleSet (ByValue)