使用 Azure 虚拟桌面中的会话主机更新 (预览版)

下面介绍如何使用 Azure 门户为会话主机计划新的更新。

1. 登录 Azure 门户。

2. 在搜索栏中，输入 Azure 虚拟桌面 并选择匹配的服务条目。

3. 选择“ 主机池”，然后选择具有要更新的会话主机配置的主机池。

4. 选择“ 会话主机”。

5. 如果要在计划更新之前查看会话主机配置，请选择“ 管理会话主机配置”，然后选择“ 查看”。 查看会话主机配置后，选择“ 取消”。

6. 若要计划新更新，请选择“ 管理会话主机更新”，然后选择“ 新建更新”。 或者，选择 “管理会话主机配置”，然后选择 “编辑”。

7. 在“ 基本信息 ”选项卡上，完成以下信息：

   参数	值/说明
   在更新后启用保存原始虚拟机	在回滚方案中很有用，但正常成本适用于存储原始 VM 的组件。
   当前主机池大小 (只读)	主机池中的会话主机数。
   在更新期间授权从主机池中删除的 VM 批大小	一次更新的最大会话主机数。 更新开始时，只会先更新一个会话主机（称为 初始），以验证更新过程，然后再批量更新剩余的会话主机。 如果初始更新不成功，更新将停止。
   更新期间可用的会话主机 (只读)	更新期间可用于用户会话的会话主机的最小数目。

   完成此选项卡后，选择“ 下一步：会话主机”。

8. 在“ 会话主机 ”选项卡上，可以选择性地更新会话主机配置中的以下参数：

   参数	值/说明
   安全类型	从Standard、受信任的启动虚拟机或机密虚拟机中进行选择。 - 如果选择 “受信任的启动虚拟机”，则会自动选择 安全启动 和 vTPM 选项。 - 如果选择“ 机密虚拟机”，则会自动选择 安全启动、 vTPM 和 完整性监视 选项。 使用机密 VM 时，无法选择退出 vTPM。
   图像	从列表中选择要使用的 OS 映像，或选择“ 查看所有映像 ”以查看详细信息，包括创建并存储为 Azure Compute Gallery 共享映像 或 托管映像的任何自定义映像。
   虚拟机大小	从列表中选择建议的 SKU。 如果要使用不同的 SKU，请选择“ 查看所有大小”，然后从列表中选择。
   操作系统磁盘类型	选择要用于会话主机的磁盘类型。 建议将 高级 SSD 用于生产工作负载。 需要在所选的 VM 系列和大小上支持磁盘类型。 确保选择 Azure 计算支持的组合。 更新的会话主机的 OS 磁盘名称具有格式 SessionHostName-DateTime_Hash的新名称。
   要加入的域
   选择要加入的目录	选择“ Active Directory”，然后选择包含域加入帐户用户名和密码的机密的密钥保管库。 可以选择指定域名和组织单位路径。
   虚拟机管理员帐户	为更新的会话主机 VM 的本地管理员帐户选择密钥保管库和机密，完成相关参数。 用户名和密码必须满足 Azure 中 Windows VM 的要求。
   自定义配置
   自定义配置脚本 URL	如果要在部署期间运行 PowerShell 脚本，可以在此处输入 URL。

   查看或完成对会话主机配置的更改后，选择“ 下一步：计划”。

9. 在“计划”选项卡上，检查“立即计划更新”框，或选择要启动更新的日期、时间和时区，最多从当前时间开始两周。

   设置计划后，选择“ 下一步：通知”。

10. 在“ 通知 ”选项卡上，完成以下信息：

    参数	值/说明
    用户注销前的分钟数	在更新开始时间之后等待用户注销的时间量。此值可在 0 到 60 分钟之间配置。 用户将在经过此时间后自动注销。
    注销消息	可以指定一条消息，通知用户他们使用的会话主机即将开始更新。

    完成此选项卡后，选择“ 下一步：查看”。

11. 在“ 审阅 ”选项卡上，确保验证通过并查看更新期间使用的信息。

12. 选择“ 更新 ”以计划更新。 查看会话主机列表时， “当前版本” 列显示会话主机正在使用的会话主机配置版本的时间戳。 如果“ 当前版本” 列有警告图标，则表示 “目标版本 ”列中的版本时间戳较晚，需要更新会话主机。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块为会话主机计划新的更新。 计划更新时，将使用主机池的会话主机配置。 在计划更新之前，需要对会话主机配置进行更改。

可以在计划更新之前更新会话主机管理策略，更改将保留供将来使用。 或者，可以在计划更新时重写会话主机管理策略中的值，但它们仅适用于该更新。

1. 使用 PowerShell 终端类型在Azure 门户中打开 Azure Cloud Shell，或在本地设备上运行 PowerShell。

   • 如果使用 Cloud Shell，请确保将 Azure 上下文设置为要使用的订阅。

   • 如果在本地使用 PowerShell，请先使用 Azure PowerShell 登录，然后确保 Azure 上下文设置为要使用的订阅。

2. Update-AzWvdSessionHostConfiguration使用 cmdlet 更新会话主机配置，只需指定要更改的参数。 下面是一些示例命令：

   • 若要为会话主机指定要使用的其他自定义映像，请运行以下命令。 有关如何查找市场映像的值的信息，请参阅通过Azure PowerShell查找和使用Azure 市场 VM 映像。

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

   • 若要更改存储本地管理员帐户密码的密钥保管库和机密，请运行以下命令：

     $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
     

   • 若要将虚拟机大小更改为 D8s_v5 ，将 OS 磁盘类型更改为 高级 SSD，请运行以下命令。 更新的会话主机的 OS 磁盘名称具有格式 SessionHostName-DateTime_Hash的新名称。

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

   运行以下命令，查看会话主机配置以验证更改：

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

3. 可选：如果要在计划更新之前更新会话主机管理策略，请使用 Update-AzWvdSessionHostManagement cmdlet 运行以下命令。 或者，可以在计划更新时重写特定值，这些值仅用于该更新。 有关有效的时区值，请参阅 Get-TimeZone PowerShell 参考 并使用 属性中的 StandardName 值。 建议进行设置 UpdateDeleteOriginalVM = $true ，以便在更新后无需清理会话主机资源。

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

   可以通过运行以下命令来查看已更新的会话主机管理策略的属性：

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

4. 若要计划更新，请使用 Invoke-AzWvdInitiateSessionHostUpdate cmdlet 和以下示例。 可以计划立即开始更新，也可以指定希望更新启动的时间，最长为两周。 下面是一些示例命令：

   • 若要计划立即启动更新并使用会话主机管理策略中的值，请运行以下命令：

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

   • 若要在指定的时间和日期 (以 YYYY-MM-DD HH：mm) 格式计划更新，并使用会话主机管理策略中的值，请运行以下命令。

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

   • 若要启动计划的更新，请运行以下命令：

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

5. 可以通过运行以下命令来查看计划更新的属性：

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

下面介绍如何使用 Azure 门户监视更新进度。

1. 在 Azure 虚拟桌面概述中，选择“ 主机池”，然后选择为其计划更新的主机池。

2. 选择“ 会话主机”。

3. 蓝色横幅提供更新的状态。 它仅显示一个时间点，因此需要选择“刷新”以检查最新进度。

如果选择立即启动更新，则消息将指出更新在开始时已计划，但刷新后会更新此消息。 在更新期间，你将看到更新期间从主机池中删除的会话主机的批大小数。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块监视更新进度。

在现有 PowerShell 会话中 Get-AzWvdSessionHostManagementsUpdateStatus ，将 cmdlet 与以下示例一起使用，以获取当前更新的详细信息。

• 若要查看最新更新的进度，请运行以下命令：

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

• 若要查看最新更新的所有参数，请运行以下命令：

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

下面介绍如何使用 Azure 门户暂停、恢复、取消或重试更新。

1. 在 Azure 虚拟桌面概述中，选择“ 主机池”，然后选择为其计划更新的主机池。

2. 选择“ 会话主机”，然后选择“ 管理会话主机更新”。

3. 选择“暂停”、“恢复”、“取消”或“重试”，具体取决于更新的当前状态。

4. 选择“ 刷新 ”以更新蓝色横幅中的状态消息。 显示正确状态可能需要大约 20 秒。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块暂停、继续、取消或重试更新。

在现有 PowerShell 会话中 Invoke-AzWvdControlSessionHostUpdate ，将 cmdlet 与以下示例一起使用来暂停或恢复当前更新。

1. 首先，通过运行以下命令检查更新状态：

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

2. 根据要执行的作，使用以下示例之一。

   • 若要暂停更新，请运行以下命令：

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

   • 若要恢复更新，请运行以下命令：

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

   • 若要取消更新并包含消息，请运行以下命令：

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

   • 若要重试更新，请运行以下命令：

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

3. 通过运行以下命令，检查执行作后的更新作和状态：

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