Atualizar hosts de sessão usando a atualização do host de sessão na Área de Trabalho Virtual do Azure (versão prévia)

Importante

A atualização do host da sessão para a Área de Trabalho Virtual do Azure está atualmente em VERSÃO PRÉVIA. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Quando você quiser atualizar os hosts da sessão em um pool de host com uma configuração de host da sessão, use a atualização do host da sessão. A atualização do host da sessão permite que você atualize a imagem, o tamanho, o tipo de disco e outras propriedades de configuração da VM (máquina virtual) subjacente. Durante uma atualização, as máquinas virtuais existentes são excluídas ou desalocadas e novas são criadas com a configuração atualizada armazenada na configuração do host da sessão. A atualização também usa os valores da política de gerenciamento de host da sessão para determinar como os hosts da sessão devem ser atualizados.

Este artigo mostra como atualizar a configuração do host da sessão de um pool de host, atualizar os hosts da sessão nesse pool e como monitorar o progresso de uma atualização usando o portal do Azure e o Azure PowerShell.

Para saber mais sobre como funciona a atualização do host da sessão, consulte Atualização do host da sessão.

Pré-requisitos

Antes de atualizar os hosts da sessão usando a atualização do host da sessão, você precisa:

• Um pool de host em pool existente com uma configuração de host da sessão com hosts da sessão que estão todos na mesma região e grupo de recursos do Azure. Não há suporte para pools de host pessoais.

• A nova imagem deve ser com suporte para a Área de Trabalho Virtual do Azure e corresponder à geração de máquina virtual. Se você estiver usando máquinas virtuais de início confiável ou máquinas virtuais confidenciais, sua imagem deverá ser para VMs de 2ª geração. Ela pode ser de:

  • No Azure Marketplace.
  • Uma imagem compartilhada existente da Galeria de Computação do Azure. Recomendamos ter pelo menos duas réplicas da imagem que você usa.
  • Uma imagem gerenciada existente.

• Remover todos os bloqueios de recursos em hosts da sessão ou no grupo de recursos em que estão.

• Atribuir a entidade de serviço da Área de Trabalho Virtual do Azure a função de controle de acesso baseado em função (RBAC) de Colaborador de máquina virtual da virtualização da área de trabalho no grupo de recursos ou assinatura com os pools de host e hosts da sessão que você deseja usar com a atualização do host da sessão. Para obter mais informações, veja Atribuir funções de RBAC do Azure ou funções do Microsoft Entra às entidades de serviço da Área de Trabalho Virtual do Azure.

• Uma conta do Azure que você usa para configurar a atualização do host da sessão com as seguintes funções RBAC do Azure para atualizar os seguintes tipos de recursos. Você também pode usar outra função interna que inclua as mesmas permissões ou criar uma função personalizada.

  Tipo de recurso	Função interna do RBAC do Azure	Escopo
  Pool de host	Colaborador do Pool de Host de Virtualização da Área de Trabalho Colaborador do Grupo de Aplicativos de Virtualização da Área de Trabalho	Grupo de recursos ou assinatura
  Hosts de sessão	Colaborador de Máquina Virtual	Grupo de recursos ou assinatura

• Você só pode ingressar hosts da sessão em um domínio do Active Directory. Não há suporte para ingressar hosts da sessão no Microsoft Entra ID, mas você pode usar o Ingresso híbrido do Microsoft Entra.

  • Se você estiver ingressando hosts da sessão em um domínio do Microsoft Entra Domain Services, você deve ser membro do grupo Administradores de DC do AAD.

  • Se você estiver ingressando hosts da sessão em um domínio do AD DS (Active Directory Domain Services), precisará usar uma conta com mais permissões do que normalmente é necessário para ingressar em um domínio porque a nova imagem do sistema operacional reutiliza o objeto de computador existente. As permissões e as propriedades na tabela a seguir precisam ser aplicadas à conta na UO (Unidade Organizacional) que contém os hosts da sessão:

    Nome	Tipo	Aplicável ao
    Redefinir senha	Permitir	Objetos de computador descendentes
    Gravação validada para o nome do host DNS	Permitir	Objetos de computador descendentes
    Gravação validada para o nome da entidade de serviço	Permitir	Objetos de computador descendentes
    Restrições da conta de leitura	Permitir	Objetos de computador descendentes
    Restrições da conta de gravação	Permitir	Objetos de computador descendentes

    Começando com KB5020276, outras proteções foram introduzidas para a reutilização de contas de computador em um domínio do Active Directory. Para reutilizar com sucesso o objeto de computador existente para o host de sessão:

    • A conta de usuário que ingressa o host da sessão no domínio é a criadora da conta de computador existente.
    • A conta de computador foi criada por um membro do grupo de segurança de administradores de domínio.
    • Aplique a configuração de Política de Grupo Domain controller: Allow computer account re-use during domain join ao proprietário da conta de computador. Para obter mais informações sobre o escopo dessa configuração, consulte KB5020276.

• Um cofre de chaves contendo os segredos que você deseja usar para as credenciais da conta de administrador local da sua máquina virtual e, se estiver ingressando hosts da sessão a um domínio do Active Directory, as credenciais da sua conta de ingresso no domínio. Você precisa de um segredo para cada nome de usuário e senha. O administrador local da máquina virtual deve atender aos requisitos de senha ao criar uma VM.

  • Você precisa fornecer à entidade de serviço da Área de Trabalho Virtual do Azure a capacidade de ler os segredos. Seu cofre de chaves pode ser configurado para usar:

    • O modelo de permissão do RBAC do Azure com a função Usuário dos segredos do cofre de chaves atribuída à entidade de serviço da Área de Trabalho Virtual do Azure.

    • Uma política de acesso com a permissão Obter segredo atribuída à entidade de serviço da Área de Trabalho Virtual do Azure.

  • O cofre de chaves deve permitir o Azure Resource Manager para implantação de modelo.

  Consulte Atribuir funções do RBAC do Azure ou funções do Microsoft Entra às entidades de serviço da Área de Trabalho Virtual do Azure para garantir que você esteja usando a entidade de serviço correta.

• Para qualquer configuração personalizada de scripts do PowerShell que você especificar na configuração do host da sessão a ser executada após uma atualização, a URL para o script deve ser resolvível da Internet pública.

• Se você quiser usar o Azure PowerShell localmente, confira Usar a CLI do Azure e o Azure PowerShell com a Área de Trabalho Virtual do Azure para garantir que você tenha o módulo Az.DesktopVirtualization do PowerShell instalado. Como alternativa, use o Azure Cloud Shell.

• Os cmdlets do Azure PowerShell para a Área de Trabalho Virtual do Azure com suporte para atualização de host da sessão estão em versão prévia. Você precisa baixar e instalar a versão de versão prévia do módulo Az.DesktopVirtualization para usar esses cmdlets, que são adicionados na versão 5.3.0.

Agendar uma atualização e editar uma configuração de host da sessão

Quando você agenda uma atualização, a configuração do host da sessão para o pool de host é usada. Você precisa fazer alterações na configuração do host da sessão ao agendar uma atualização, caso contrário, os hosts da sessão serão reimplantados com os mesmos valores de configuração do host da sessão. Todas as alterações feitas ao agendar uma atualização são salvas na configuração do host da sessão.

Para agendar uma atualização dos hosts da sessão, selecione a guia relevante para seu cenário e siga as etapas.

Importante

• Durante uma atualização, o número de hosts da sessão disponíveis para sessões de usuário é reduzido e todos os usuários conectados serão solicitados a fazer logoff. Recomendamos que você agende uma atualização durante períodos menos movimentados para minimizar a interrupção para os usuários finais.

• Se você usar um NSG (grupo de segurança de rede) personalizado para os hosts da sessão que deseja atualizar, há um problema conhecido em que você não pode iniciar uma atualização usando o portal do Azure. Para solucionar esse problema, use o Azure PowerShell para iniciar a atualização.

Azure portal

Veja como agendar uma nova atualização para os hosts da sessão usando o portal do Azure.

Dica

Quando você agenda uma atualização usando o portal do Azure, os valores são preenchidos usando a configuração do host da sessão. Se esta for a primeira atualização e uma configuração de host da sessão ainda não tiver sido criada, o portal mostrará a configuração de host da sessão padrão até que a configuração do host da sessão seja criada. Todas as alterações feitas na configuração do host da sessão durante uma atualização serão salvas.

Se você editar a configuração do host da sessão usando o portal do Azure, deverá agendar uma atualização.

1. Entre no portal do Azure.

2. Na barra de pesquisa, insira Área de Trabalho Virtual do Azure e selecione a entrada de serviço correspondente.

3. Selecione Pools de hosts e, em seguida, selecione o pool de hosts com uma configuração de host de sessão que você deseja atualizar.

4. Selecione Hosts da sessão.

5. Se você quiser examinar a configuração do host da sessão antes de agendar uma atualização, selecione Gerenciar configuração do host da sessão e, em seguida, Exibir. Depois de examinar a configuração do host da sessão, selecione Cancelar.

6. Para agendar uma nova atualização, selecione Gerenciar atualização do host da sessão e selecione Nova atualização. Como alternativa, selecione Gerenciar configuração de host de sessão e, em seguida, Editar.

7. Na guia Básico, complete as seguintes informações:

   Parâmetro	Valor/Descrição
   Habilitar o salvamento de máquinas virtuais originais após a atualização	Útil em cenários de reversão, mas os custos normais se aplicam ao armazenamento dos componentes da VM original.
   Tamanho atual do pool de host (somente leitura)	O número total de hosts da sessão no pool de host.
   Tamanho do lote da VM autorizado a ser removido do pool de host durante a atualização	O número máximo de hosts da sessão que são atualizados por vez. Quando a atualização é iniciada, apenas um host da sessão, conhecido como inicial, é atualizado primeiro para verificar o processo de atualização antes de atualizar os hosts da sessão restantes em lotes. Se a atualização do inicial não for bem-sucedida, a atualização será interrompida.
   Hosts da sessão disponíveis durante a atualização (somente leitura)	O número mínimo de hosts da sessão disponíveis para sessões de usuário durante a atualização.

   Depois de concluir essa guia, selecione Avançar: hosts da sessão.

8. Na guia Hosts da sessão, opcionalmente, você pode atualizar os seguintes parâmetros na configuração do host da sessão:

   Parâmetro	Valor/Descrição
   Tipo de segurança	Selecione entre Padrão, Máquinas virtuais de início confiável ou Máquinas virtuais confidenciais. — Se você selecionar Máquinas virtuais de início confiável, as opções para inicialização segura e vTPM serão selecionadas automaticamente. — Se você selecionar Máquinas virtuais confidenciais, as opções para inicialização segura, vTPM e monitoramento de integridade serão selecionadas automaticamente. Você não pode recusar o vTPM se estiver usando uma VM confidencial.
   Imagem	Selecione a imagem do sistema operacional que você deseja usar na lista ou selecione Ver todas as imagens para ver mais, incluindo as imagens personalizadas que você criou e armazenou como uma imagem compartilhada da Galeria de Computação do Azure ou uma imagem gerenciada.
   Tamanho da máquina virtual	Selecione um SKU recomendado na lista. Se você quiser usar um SKU diferente, selecione Ver todos os tamanhos e selecione na lista.
   Tipo de disco de SO	Selecione o tipo de disco a ser usado para os hosts da sessão. Recomendamos usar o SSD Premium para cargas de trabalho de produção. O tipo de disco precisa ter suporte no tamanho e na família de VM selecionados. Verifique se você está selecionando uma combinação compatível com a computação do Azure. O nome do disco do sistema operacional dos hosts da sessão atualizados tem um novo nome no formato SessionHostName-DateTime_Hash.
   Domínio a ingressar
   Selecionar qual diretório você deseja ingressar	Selecione Active Directory e, em seguida, selecione o cofre de chaves que contém os segredos do nome de usuário e da senha da conta de ingresso no domínio. Opcionalmente, você pode especificar um nome de domínio e um caminho de unidade organizacional.
   Conta de administrador da Máquina Virtual	Insira os parâmetros relevantes selecionando o cofre de chaves e o segredo do nome de usuário e da senha da conta de administrador local das VMs atualizadas do host da sessão. O nome de usuário e a senha devem atender aos requisitos para VMs do Windows no Azure.
   Configuração personalizada
   URL do script de configuração personalizada	Se desejar executar um script do PowerShell durante a implantação, é possível inserir a URL aqui.

   Depois de examinar ou terminar de fazer alterações na configuração do host da sessão, selecione Avançar: agendar.

9. Na guia Agendar, marque a caixa para Agendar atualização agoraou selecione uma data, hora e fuso horário que você deseja que a atualização inicie, até um máximo de duas semanas a partir da hora atual.

   Depois de definir sua agenda, selecione Avançar: notificações.

10. Na guia Notificações, insira as seguintes informações:

    Parâmetro	Valor/Descrição
    Minutos antes de os usuários serem desconectados	O tempo de espera após a hora de início da atualização para que os usuários sejam notificados a sair. Esse valor pode ser configurado entre 0 e 60 minutos. Os usuários serão automaticamente desconectados após esse tempo decorrido.
    Mensagem de saída	Uma mensagem que você pode especificar para informar aos usuários que o host da sessão que eles estão usando está prestes a começar a atualização.

    Depois de concluir essa guia, selecione Avançar: examinar.

11. Na guia Examinar, verifique se a validação está aprovada e examine as informações que são usadas durante a atualização.

12. Selecione Atualizar para agendar a atualização. Quando você exibe a lista de hosts da sessão, a coluna Versão atual mostra o carimbo de data/hora da versão da configuração do host da sessão que o host da sessão está usando. Se a coluna Versão atual tiver um ícone de aviso, isso significa que o carimbo de data/hora da versão na coluna Versão de destino será posterior e o host da sessão precisará ser atualizado.

Observação

Na primeira vez que você agenda uma atualização, as configurações fornecidas substituem as configurações padrão na política de gerenciamento de host da sessão. As atualizações subsequentes terão esses parâmetros pré-preenchidos e todas as alterações serão salvas.

PowerShell do Azure

Veja como agendar uma nova atualização para os hosts da sessão usando o módulo Az.DesktopVirtualization do PowerShell. Quando você agenda uma atualização, a configuração do host da sessão para o pool de host é usada. Você precisa fazer alterações na configuração do host da sessão antes de agendar uma atualização.

Você pode atualizar a política de gerenciamento de host da sessão antes de agendar uma atualização, em que as alterações persistem para uso futuro. Como alternativa, você pode substituir os valores na política de gerenciamento de host da sessão ao agendar uma atualização, mas eles só se aplicam a essa atualização.

Importante

Nos exemplos a seguir, será necessário alterar os valores de <placeholder> para os seus próprios.

1. Abra o Azure Cloud Shell no portal do Azure com o tipo de terminal PowerShell ou execute o PowerShell em seu dispositivo local.

   • Se estiver usando o Cloud Shell, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

   • Se estiver usando o PowerShell localmente, primeiro conecte-se com o Azure PowerShell e, em seguida, certifique-se de que seu contexto do Azure está definido para a assinatura que você deseja usar.

2. Use o cmdlet Update-AzWvdSessionHostConfiguration para atualizar a configuração do host da sessão, em que você só precisa especificar os parâmetros que deseja alterar. Veja a seguir alguns comandos de exemplo:

   • Para especificar uma imagem personalizada diferente para os hosts da sessão usarem, execute o comando a seguir. Para obter informações sobre como encontrar os valores da imagem do Marketplace, veja Localizar e usar imagens de VM do Azure Marketplace com o Azure PowerShell.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ImageInfoType = 'Custom'
          CustomInfoResourceID  = '/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Compute/galleries/<GalleryName>/images/<ImageName>/versions/<ImageVersion>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Para alterar o cofre de chaves e o segredo que armazena a senha da conta de administrador local, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMAdminCredentialsUsernameKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
          VMAdminCredentialsPasswordKeyVaultSecretUri = 'https://<VaultName>.vault.azure.net/secrets/<SecretName>/<Version>'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   • Para alterar o tamanho da máquina virtual para D8s_v5 e o tipo de disco do sistema operacional para SSD Premium, execute o comando a seguir. O nome do disco do sistema operacional dos hosts da sessão atualizados tem um novo nome no formato SessionHostName-DateTime_Hash.

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          VMSizeId = 'Standard_D8s_v5'
          DiskInfoType = 'Premium_LRS'
     }
     
     Update-AzWvdSessionHostConfiguration @parameters
     

   Veja a configuração do host da sessão para verificar as alterações executando o seguinte comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostConfiguration @parameters | FL *
   

3. Opcional: se você quiser atualizar a política de gerenciamento de host da sessão antes de agendar uma atualização, execute o seguinte comando usando o cmdlet Update-AzWvdSessionHostManagement. Como alternativa, você pode substituir valores específicos ao agendar uma atualização, que são usadas apenas para essa atualização. Para valores de fuso horário válidos, veja Referência do PowerShell Get-TimeZone e use o valor da propriedade StandardName.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       ScheduledDateTimeZone = '<TimeZoneID>'
       UpdateDeleteOriginalVM = <$true or $false>
       UpdateMaxVmsRemoved = '<Quantity>'
       UpdateLogOffDelayMinute = '<Minutes>'
       UpdateLogOffMessage = '<Message>'
   }
   
   Update-AzWvdSessionHostManagement @parameters
   

   Você pode exibir as propriedades da política de gerenciamento de host da sessão atualizada executando o seguinte comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdSessionHostManagement @parameters
   

4. Para agendar uma atualização, use o cmdlet Invoke-AzWvdInitiateSessionHostUpdate com os seguintes exemplos. Você pode agendar uma atualização para iniciar imediatamente ou especificar uma hora em que deseja que a atualização seja iniciada, até um máximo de duas semanas. Veja a seguir alguns comandos de exemplo:

   • Para agendar uma atualização para iniciar imediatamente e usar os valores da política de gerenciamento de host da sessão, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Para agendar uma atualização em uma data e hora especificadas (no formato YYYY-MM-DD HH:mm) e usar os valores da política de gerenciamento de host da sessão, execute o comando a seguir.

     $dateTime = Get-Date -Date "2024-03-15 01:30"
     
     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          ScheduledDateTime = $dateTime
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

   • Para iniciar uma atualização agendada, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = Start
     }
     
     $update = Invoke-AzWvdInitiateSessionHostUpdate @parameters
     

5. Você pode exibir as propriedades da atualização agendada executando o seguinte comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       IsLatest = $true
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

Importante

• Depois que uma atualização for agendada, você não poderá editar a agenda ou as configurações. Se você precisar fazer alterações, precisará cancelar a atualização e agendar uma nova.

• Não remova nenhuma VM do pool de host enquanto a atualização estiver em andamento. Isso pode criar problemas com a atualização em andamento.

• Não altere o modo esvaziar de nenhuma VM no pool de host enquanto uma atualização estiver em andamento. O modo esvaziar das VMs é alterado automaticamente com base em qual fase da atualização ela está. Se um host da sessão não for recuperável após uma atualização, sua configuração de modo esvaziar será habilitada. Depois que a atualização for concluída, o modo esvaziar será redefinido.

• Demora cerca de 20 minutos para um host da sessão atualizar. O número de hosts de sessão especificados no tamanho do lote será atualizado simultaneamente antes de passar para o próximo lote. Você deve considerar o tempo de conclusão geral em seu horário agendado.

Monitorar o progresso de uma atualização

Depois que uma atualização for iniciada, você poderá verificar seu progresso. Selecione a guia relevante para o seu cenário e siga as etapas.

Azure portal

Veja como monitorar o progresso de uma atualização usando o portal do Azure.

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Pools de host e, em seguida, selecione o pool de host para o qual você agendou uma atualização.

2. Selecione Hosts da sessão.

3. Uma faixa azul fornece o status da atualização. Ele só mostra um ponto no tempo, portanto, você precisa selecionar Atualizar para verificar o progresso mais recente.

Se você tiver selecionado para iniciar a atualização imediatamente, a mensagem indicará que a atualização está agendada enquanto ela começa, mas essa mensagem será atualizada após a atualização. Durante uma atualização, você verá o número de tamanho do lote de hosts da sessão que são removidos do pool de host durante a atualização.

PowerShell do Azure

Veja como monitorar o progresso de uma atualização usando o módulo Az.DesktopVirtualization do PowerShell.

Na sessão existente do PowerShell, use o cmdlet Get-AzWvdSessionHostManagementsUpdateStatus com os exemplos a seguir para obter os detalhes da atualização atual.

• Para ver o progresso da atualização mais recente, execute os seguintes comandos:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       IsLatest = $true
  }
  
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters |
       FL PercentComplete,
       ProgressExecutionStartTime,
       ProgressSessionHostsCompleted,
       ProgressSessionHostsInProgress,
       ProgressSessionHostsRollbackFailed,
       ProgressTotalSessionHost,
       EndTime
  
  $updateProgress
  

• Para ver todos os parâmetros da atualização mais recente, execute o seguinte comando:

  $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       IsLatest = $true
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

Dica

Você também pode ver a atividade de uma atualização usando o log de atividades do Azure Monitor.

Pausar, retomar, cancelar ou repetir uma atualização

Você pode pausar, retomar ou cancelar uma atualização em andamento. Se você pausar ou cancelar uma atualização, a atividade atual será concluída antes de pausar o restante da atualização. Por exemplo, se um lote de hosts da sessão estiver sendo atualizado, a atualização para esses hosts da sessão será concluída primeiro. A faixa azul mostrando o status das alterações de atualização para mostrar o quanto a atualização avançou quando foi pausada. Depois que uma atualização é pausada, você pode apenas retomá-la, o que continua a partir do ponto em que foi pausada.

Se você não retomar uma atualização dentro de duas semanas, a atualização será cancelada. Depois que uma atualização é cancelada, você não pode retomá-la.

Cuidado

Se você cancelar uma atualização no meio do processo, haverá diferenças entre os hosts da sessão no pool de host, como uma versão diferente do sistema operacional ou ingressado em um domínio diferente do Active Directory. Isso pode fornecer uma experiência inconsistente aos usuários, portanto, você precisará agendar outra atualização o mais rápido possível para garantir que haja paridade em todos os hosts da sessão.

Azure portal

Veja como pausar, retomar, cancelar ou repetir uma atualização usando o portal do Azure.

1. Na visão geral da Área de Trabalho Virtual do Azure, selecione Pools de host e, em seguida, selecione o pool de host para o qual você agendou uma atualização.

2. Selecione Hosts da sessão e depois Gerenciar atualização do host da sessão.

3. Selecione Pausar, Retomar, Cancelar ou Repetir, dependendo do estado atual da atualização.

4. Selecione Atualizar para atualizar a mensagem de status na faixa azul. Pode levar aproximadamente 20 segundos para mostrar o status correto.

PowerShell do Azure

Veja como pausar, retomar, cancelar ou repetir uma atualização usando o módulo Az.DesktopVirtualization do PowerShell.

Na sessão existente do PowerShell, use o cmdlet Invoke-AzWvdControlSessionHostUpdate com os exemplos a seguir para pausar ou retomar a atualização atual.

1. Primeiro, verifique o status da atualização executando o seguinte comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       IsLatest = $true
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Status
   

2. Dependendo de qual ação você deseja executar, use um dos exemplos a seguir.

   • Para pausar uma atualização, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Pause'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para retomar uma atualização, execute o comando a seguir:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Resume'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para cancelar uma atualização e incluir uma mensagem, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Cancel'
          CancelMessage = '<Message>'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

   • Para repetir uma atualização, execute o seguinte comando:

     $parameters = @{
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          Action = 'Retry'
     }
     
     Invoke-AzWvdControlSessionHostUpdate @parameters
     

3. Verifique o status e a ação de atualização depois de realizar uma ação executando o seguinte comando:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       IsLatest = $true
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL Action, Status
   

Próximas etapas

• Saiba como usar o diagnóstico de atualização de host da sessão.

• Encontre diretrizes para Solucionar problemas de atualização do host da sessão.