Atualizar anfitriões de sessões com a atualização do anfitrião de sessões no Azure Virtual Desktop (pré-visualização)

Eis como agendar uma nova atualização para os anfitriões de sessão com o portal do Azure.

1. Entre no portal do Azure.

2. Na barra de pesquisa, introduza Azure Virtual Desktop e selecione a entrada de serviço correspondente.

3. Selecione Conjuntos de anfitriões e, em seguida, selecione o conjunto de anfitriões com uma configuração de anfitrião de sessão que pretende atualizar.

4. Selecione Anfitriões de sessão.

5. Se quiser rever a configuração do anfitrião da sessão antes de agendar uma atualização, selecione Gerir configuração do anfitrião da sessão e, em seguida, Ver. Depois de rever a configuração do anfitrião da sessão, selecione Cancelar.

6. Para agendar uma nova atualização, selecione Gerir atualização do anfitrião da sessão e, em seguida, selecione Nova atualização. Em alternativa, selecione Gerir configuração do anfitrião de sessões e, em seguida, Editar.

7. No separador Informações básicas , preencha as seguintes informações:

   Parâmetro	Valor/Descrição
   Tamanho do conjunto de anfitriões atual (só de leitura)	O número de anfitriões de sessão no conjunto de anfitriões.
   Tamanho do lote da VM autorizado a ser removido do conjunto de anfitriões durante a atualização	O número máximo de anfitriões de sessão atualizados de cada vez. Quando a atualização é iniciada, apenas um anfitrião de sessão, conhecido como inicial, é atualizado primeiro para verificar o processo de atualização antes de atualizar os restantes anfitriões de sessão em lotes. Se a atualização da inicial não for bem-sucedida, a atualização para.
   Anfitriões de sessão disponíveis durante a atualização (só de leitura)	O número mínimo de anfitriões de sessão que estão disponíveis para sessões de utilizador durante a atualização.

   Depois de concluir este separador, selecione Seguinte: Anfitriões de sessões.

8. No separador Anfitriões de sessões , opcionalmente, pode atualizar os seguintes parâmetros na configuração do anfitrião da sessão:

   Parâmetro	Valor/Descrição
   Tipo de segurança	Selecione a partir de Standard, Máquinas virtuais de início fidedigno ou Máquinas virtuais confidenciais. - Se selecionar Máquinas virtuais de iniciação fidedignas, as opções para arranque seguro e vTPM são selecionadas automaticamente. - Se selecionar Máquinas virtuais confidenciais, as opções de arranque seguro, vTPM e monitorização de integridade são selecionadas automaticamente. Não pode optar ativamente por não participar no vTPM ao utilizar uma VM confidencial.
   Image	Selecione a imagem do SO que pretende utilizar na lista ou selecione Ver todas as imagens para ver mais, incluindo as imagens personalizadas que criou e armazenou como uma imagem partilhada da Galeria de Computação do Azure ou uma imagem gerida.
   Tamanho da máquina virtual	Selecione um SKU recomendado na lista. Se quiser utilizar um SKU diferente, selecione Ver todos os tamanhos e, em seguida, selecione a partir da lista.
   Tipo de disco do SO	Selecione o tipo de disco a utilizar para os anfitriões de sessão. Recomendamos que utilize o SSD Premium para cargas de trabalho de produção. O tipo de disco tem de ser suportado na família de VMs e no tamanho selecionados. Certifique-se de que está a selecionar uma combinação suportada pela computação do Azure. O nome do disco do SO dos anfitriões de sessões atualizados tem um novo nome no formato SessionHostName-DateTime_Hash.
   Domínio a ser adicionado
   Selecionar qual diretório você gostaria de ingressar	Selecione Microsoft Entra ou Active Directory. Se estiver a utilizar o Active Directory, selecione o cofre de chaves que contém os segredos do nome de utilizador e palavra-passe da conta de associação a um domínio. Opcionalmente, pode especificar um nome de domínio e um caminho de unidade organizacional.
   Conta de Administrador de Máquina Virtual	Conclua os parâmetros relevantes ao selecionar o cofre de chaves e o segredo do nome de utilizador e palavra-passe da conta de administrador local das VMs do anfitrião de sessões atualizadas. O nome de utilizador e a palavra-passe têm de cumprir os requisitos das VMs do Windows no Azure.
   Configuração personalizada
   URL do script de configuração personalizado	Se quiser executar um script do PowerShell durante a implementação, pode introduzir o URL aqui.

   Depois de rever ou concluir as alterações à configuração do anfitrião da sessão, selecione Seguinte: Agendar.

9. No separador Agenda, marcar a caixa para Agendar atualização agora ou selecione uma data, hora e fuso horário que pretende que a atualização inicie, até um máximo de duas semanas a partir da hora atual.

   Depois de definir a sua agenda, selecione Seguinte: Notificações.

10. No separador Notificações , preencha as seguintes informações:

    Parâmetro	Valor/Descrição
    Minutos antes de os utilizadores terminam sessão	O período de tempo a aguardar após a hora de início da atualização para que os utilizadores sejam notificados para terminarem sessão. Este valor é configurável entre 0 e 60 minutos. A sessão dos utilizadores será terminada automaticamente após este tempo decorrido.
    Mensagem de terminar sessão	Uma mensagem que pode especificar para informar os utilizadores de que o anfitrião de sessão que estão a utilizar está prestes a começar a atualizar.

    Depois de concluir este separador, selecione Seguinte: Rever.

11. No separador Rever , certifique-se de que a validação é aprovada e reveja as informações utilizadas durante a atualização.

12. Selecione Atualizar para agendar a atualização. Quando vê a lista de anfitriões de sessão, a coluna Versão Atual mostra o carimbo de data/hora da versão da configuração do anfitrião da sessão que o anfitrião da sessão está a utilizar. 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 anfitrião da sessão tem de ser atualizado.

Eis como agendar uma nova atualização para os anfitriões de sessão com o módulo Az.DesktopVirtualization do PowerShell. Quando agenda uma atualização, é utilizada a configuração do anfitrião da sessão para o conjunto de anfitriões. Tem de fazer alterações à configuração do anfitrião da sessão antes de agendar uma atualização.

Pode atualizar a política de gestão do anfitrião de sessões antes de agendar uma atualização, onde as alterações persistem para utilização futura. Em alternativa, pode substituir os valores na política de gestão do anfitrião da sessão ao agendar uma atualização, mas estes aplicam-se apenas a essa atualização.

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

   • Se estiver a utilizar Cloud Shell, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

   • Se estiver a utilizar o PowerShell localmente, primeiro inicie sessão com Azure PowerShell e, em seguida, certifique-se de que o contexto do Azure está definido para a subscrição que pretende utilizar.

2. Utilize o Update-AzWvdSessionHostConfiguration cmdlet para atualizar a configuração do anfitrião da sessão, onde só precisa de especificar os parâmetros que pretende alterar. Eis alguns comandos de exemplo:

   • Para especificar uma imagem personalizada diferente para os anfitriões de sessão utilizarem, execute o seguinte comando. Para obter informações sobre como localizar os valores da imagem do Marketplace, veja Localizar e utilizar imagens de VMs do Azure Marketplace com 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 palavra-passe 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 SO para SSD Premium, execute o seguinte comando. O nome do disco do SO dos anfitriões de sessões 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 anfitrião da sessão para verificar as alterações ao executar o seguinte comando:

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

3. Opcional: se quiser atualizar a política de gestão do anfitrião da sessão antes de agendar uma atualização, execute o seguinte comando com o Update-AzWvdSessionHostManagement cmdlet . Em alternativa, pode substituir valores específicos ao agendar uma atualização, que são utilizadas apenas para essa atualização. Para valores de fuso horário válidos, veja Get-TimeZone PowerShell reference (Referência do PowerShell Get-TimeZone ) e utilize o valor da StandardName propriedade . Recomendamos que defina UpdateDeleteOriginalVM = $true para que não precise de limpo recursos de anfitrião 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
   

   Pode ver as propriedades da política de gestão do anfitrião de sessões atualizada ao executar o seguinte comando:

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

4. Para agendar uma atualização, utilize o Invoke-AzWvdInitiateSessionHostUpdate cmdlet com os seguintes exemplos. Pode agendar uma atualização para iniciar imediatamente ou especificar uma hora em que pretende que a atualização seja iniciada, até um máximo de duas semanas. Eis alguns comandos de exemplo:

   • Para agendar uma atualização para iniciar imediatamente e utilizar os valores da política de gestão do anfitrião de sessões, execute o seguinte comando:

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

   • Para agendar uma atualização numa hora e data especificadas (no formato AAAA-MM-DD HH:mm) e utilizar os valores da política de gestão do anfitrião de sessão, execute o seguinte comando.

     $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. Pode ver as propriedades da atualização agendada ao executar o seguinte comando:

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

Eis como monitorizar o progresso de uma atualização com o portal do Azure.

1. Na descrição geral do Azure Virtual Desktop, selecione Conjuntos de anfitriões e, em seguida, selecione o conjunto de anfitriões para o qual agendou uma atualização.

2. Selecione Anfitriões de sessão.

3. Uma faixa azul fornece a status da atualização. Só mostra um ponto anterior no tempo, pelo que tem de selecionar Atualizar para marcar o progresso mais recente.

Se tiver selecionado iniciar a atualização imediatamente, a mensagem indicará que a atualização está agendada enquanto começa, mas esta mensagem é atualizada assim que atualizar. Durante uma atualização, verá o número de tamanho do lote de anfitriões de sessão que são removidos do conjunto de anfitriões durante a atualização.

Eis como monitorizar o progresso de uma atualização com o módulo Az.DesktopVirtualization do PowerShell.

Na sua sessão do PowerShell existente, utilize o Get-AzWvdSessionHostManagementsUpdateStatus cmdlet com os seguintes exemplos 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
  

Eis como colocar em pausa, retomar, cancelar ou repetir uma atualização com o portal do Azure.

1. Na descrição geral do Azure Virtual Desktop, selecione Conjuntos de anfitriões e, em seguida, selecione o conjunto de anfitriões para o qual agendou uma atualização.

2. Selecione Anfitriões de sessões e, em seguida, selecione Gerir atualização do anfitrião da sessão.

3. Selecione Colocar em Pausa, Retomar, Cancelar ou Repetir consoante o estado atual da atualização.

4. Selecione Atualizar para atualizar a mensagem status na faixa azul. Pode demorar aproximadamente 20 segundos a mostrar a status correta.

Eis como colocar em pausa, retomar, cancelar ou repetir uma atualização com o módulo Az.DesktopVirtualization do PowerShell.

A partir da sua sessão do PowerShell existente, utilize o Invoke-AzWvdControlSessionHostUpdate cmdlet com os seguintes exemplos para colocar em pausa ou retomar a atualização atual.

1. Em primeiro lugar, marcar o status de atualização ao executar o seguinte comando:

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

2. Consoante a ação que pretende efetuar, utilize um dos seguintes exemplos.

   • Para colocar uma atualização em pausa, 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 status depois de executar uma ação ao executar o seguinte comando:

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