Atualizar hosts de sessão usando o host de sessão atualizar na Área de Trabalho Virtual do Azure

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

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 host e, em seguida, selecione o pool de host com uma configuração de host de sessão que você deseja atualizar.

4. Selecione os hosts da sessão.

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

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

7. Na guia Informações básicas , preencha as seguintes informações:

   Parâmetro	Valor/Descrição
   Tamanho atual do pool de hosts (somente leitura)	O número de hosts de sessão em seu pool de hosts.
   Tamanho do lote de VM autorizado a ser removido do pool de host durante a atualização	O número máximo de hosts de sessão que são atualizados por vez. Quando a atualização começa, apenas um host de sessão, conhecido como inicial, é atualizado primeiro para verificar o processo de atualização antes de atualizar os hosts de sessão restantes em lotes. Se a atualização da inicial não for bem-sucedida, a atualização será interrompida.
   Hosts de sessão disponíveis durante a atualização (somente leitura)	O número mínimo de hosts de sessão que estão disponíveis para sessões de usuário durante a atualização.

   Depois de concluir esta guia, selecione Próximo: Hosts de sessão.

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

   Parâmetro	Valor/Descrição
   Tipo de segurança	Selecione entre Standard, Máquinas virtuais de inicialização confiável ou Máquinas virtuais confidenciais. - Se você selecionar Máquinas virtuais de inicialização confiáveis, as opções para inicialização segura e vTPM serão selecionadas automaticamente. - Se você selecionar máquinas virtuais confidenciais, as opções de inicialização segura, vTPM e monitoramento de integridade serão selecionadas automaticamente. Você não pode recusar o vTPM ao usar uma VM confidencial.
   Image	Selecione a imagem do sistema operacional que você deseja usar na lista ou selecione Ver todas as imagens para ver mais, incluindo quaisquer 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, em seguida, selecione na lista.
   Tipo de disco do SO	Selecione o tipo de disco a ser usado para os hosts da sessão. Recomendamos que você use o SSD Premium para cargas de trabalho de produção. O tipo de disco precisa ter suporte na família de VMs e o tamanho deve ser selecionado. Verifique se você está selecionando uma combinação compatível com a computação do Azure. O nome do disco do SO dos hosts de sessão atualizados tem um novo nome no formato SessionHostName-DateTime_Hash.
   Domínio a ser adicionado
   Selecionar qual diretório você gostaria de ingressar	Selecione o Microsoft Entra ou o Active Directory. Se estiver usando o Active Directory, selecione o cofre de chaves que contém os segredos para o nome de usuário e a senha da conta de ingresso no domínio. Opcionalmente, é possível especificar um nome de domínio e um caminho de unidade organizacional.
   Conta de administrador de máquina virtual	Conclua os parâmetros relevantes selecionando o cofre de chaves e o segredo para o nome de usuário e a senha da conta de administrador local das VMs de host de sessão atualizadas. O nome de usuário e a senha devem atender aos requisitos para VMs do Windows no Azure.
   Configuração personalizada
   URL de script de configuração personalizada	Se você quiser executar um script do PowerShell durante a implantação, poderá inserir a URL aqui.

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

9. Na guia Agendamento, marque a caixa para Agendar atualização agora ou selecione uma data, hora e fuso horário em que 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 , preencha as seguintes informações:

    Parâmetro	Valor/Descrição
    Minutos antes de os usuários saírem	A quantidade de tempo a aguardar após a hora de início da atualização para que os usuários sejam notificados para sair. Esse valor é configurável entre 0 e 60 minutos. Os usuários serão automaticamente desconectados após esse tempo.
    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 atualizar.

    Depois de concluir esta guia, selecione Avançar: Examinar.

11. Na guia Revisão , certifique-se de que a validação seja aprovada e revise as informações usadas durante a atualização.

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

Veja como agendar uma nova atualização para seus hosts de sessão usando o módulo Az.DesktopVirtualization do PowerShell. Quando você agenda uma atualização, a configuração do host de sessão para o pool de hosts é 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 de sessão antes de agendar uma atualização, onde as alterações persistem para uso futuro. Como alternativa, você pode substituir os valores na política de gerenciamento de host de sessão ao agendar uma atualização, mas eles só se aplicam a essa atualização.

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

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

   • Se você estiver usando o PowerShell localmente, primeiro entre no Azure PowerShell e, em seguida, verifique se o contexto do Azure está definido para a assinatura que você deseja usar.

2. Use o Update-AzWvdSessionHostConfiguration cmdlet para atualizar a configuração do host de sessão, onde você só precisa especificar os parâmetros que deseja alterar. Aqui estão alguns exemplos de comandos:

   • 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, consulte 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 SO dos hosts de 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
     

   Exiba 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 de sessão antes de agendar uma atualização, execute o comando a seguir, usando o Update-AzWvdSessionHostManagement cmdlet. Como alternativa, você pode substituir valores específicos ao agendar uma atualização, que são usados apenas para essa atualização. Para valores válidos de fuso horário, consulte a referência Get-TimeZone do PowerShell e use o valor da StandardName propriedade. Recomendamos a configuração UpdateDeleteOriginalVM = $true para que você não precise limpar os recursos do host de sessão após uma atualização.

   $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 de sessão atualizada executando o seguinte comando:

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

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

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

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

   • Para agendar uma atualização em uma hora e data especificadas (no formato AAAA-MM-DD HH:mm) e usar os valores da política de gerenciamento de host de 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>'
   }
   
   Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
   

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 os hosts da sessão.

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

Se você optou por iniciar a atualização imediatamente, a mensagem informará que a atualização está agendada enquanto começa, mas essa mensagem será atualizada depois que você atualizar. Durante uma atualização, você verá o número do tamanho do lote de hosts de sessão que são removidos do pool de hosts durante a atualização.

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

Em sua sessão existente do PowerShell, use o Get-AzWvdSessionHostManagementsUpdateStatus cmdlet 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>'
  }
  
  $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>'
  }
  $updateProgress = Get-AzWvdSessionHostManagementsUpdateStatus @parameters | FL *
  
  $updateProgress
  

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 de sessão e, em seguida, selecione Gerenciar atualização de host de sessão.

3. Selecione Pausar, Retomar, Cancelar ou Tentar novamente , 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.

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

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

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

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

2. Dependendo da ação que 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 a atualização, execute o seguinte comando:

     $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 a ação de atualização e o status depois de executar uma ação executando o seguinte comando:

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