将会话主机添加到主机池

项目
12/05/2024

重要

对于由世纪互联运营的 Microsoft Azure，适用于 Azure Stack HCI 的 Azure 虚拟桌面目前为预览版。有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款，请参阅 Azure 预览版的补充使用条款。

创建主机池、工作区和应用程序组后，需要将会话主机添加到主机池以便用户连接。可能还需要添加更多会话主机来提供额外的容量。

可创建新的虚拟机 (VM) 来将其用作会话主机，并使用 Azure 门户中的 Azure 虚拟桌面服务以本机方式将它们添加到主机池。或者，可以在 Azure 虚拟桌面服务外部创建 VM，例如使用自动化管道、Azure CLI 或 Azure PowerShell，然后将其作为会话主机单独添加到主机池。

本文介绍如何使用 Azure 门户、Azure CLI 或 Azure PowerShell 生成注册密钥。它还演示了如何使用 Azure 虚拟桌面服务将会话主机添加到主机池，或将它们单独添加到主机池。

先决条件

要大致了解所需内容，例如支持的操作系统、虚拟网络和标识提供者，请查看 Azure 虚拟桌面的先决条件。此外：

需要现有的主机池。不能在同一主机池中同时存在 Azure 或 Azure Stack HCI 上的会话主机。
如果主机池中已有会话主机，请记下所使用的虚拟机大小、映像和名称前缀。主机池中的所有会话主机应使用相同的配置，包括相同的标识提供者。例如，主机池不应包含一些已加入 Microsoft Entra ID 的会话主机和一些已加入 Active Directory 域的会话主机。
所用 Azure 帐户必须在资源组上至少具有以下内置 RBAC（基于角色的访问控制）角色或等效角色：

操作 RBAC 角色

生成主机池的注册密钥桌面虚拟化主机池参与者

使用 Azure 门户创建和添加会话主机桌面虚拟化主机池参与者
 虚拟机参与者
使用 Azure 门户创建和添加会话主机时，请勿禁用 Windows 远程管理 (WinRM)。 PowerShell DSC 需要使用它。
如果要在本地使用 Azure CLI 或 Azure PowerShell，请参阅将 Azure CLI 和 Azure PowerShell 与 Azure 虚拟桌面配合使用，确保已安装 desktopvirtualization Azure CLI 扩展或 Az.DesktopVirtualization PowerShell 模块。

操作	RBAC 角色
生成主机池的注册密钥	桌面虚拟化主机池参与者
使用 Azure 门户创建和添加会话主机	桌面虚拟化主机池参与者虚拟机参与者

重要

如果要创建已加入 Microsoft Entra 的会话主机，我们仅支持使用 AADLoginForWindows VM 扩展执行该操作，该扩展是在将 Azure 门户或 ARM 模板与 Azure 虚拟桌面服务配合使用时自动添加和配置的。

生成注册密钥

在将会话主机添加到主机池时，首先需要生成该主机池的注册密钥。注册密钥会授权会话主机加入主机池。它仅在指定的持续时间内有效。

若要生成注册密钥，请选择你的方案对应的选项卡，并按照步骤操作。

下面介绍如何使用 Azure 门户生成注册密钥：

登录到 Azure 门户。
在搜索栏中，输入“Azure 虚拟桌面”，然后选择匹配的服务条目。
选择“主机池”，然后选择要为其生成注册密钥的主机池的名称。
在主机池概述中，选择“注册密钥”。
选择“生成新密钥”，输入过期日期和时间，然后选择“确定”。此时将创建注册密钥。
选择“下载”以下载包含新创建的注册密钥的文本文件，或将注册密钥复制到剪贴板供以后使用。稍后还可以通过返回到主机池概述来检索注册密钥。

下面介绍如何使用 Az.DesktopVirtualization Azure PowerShell 模块生成注册密钥。在以下示例中，请务必将 <placeholder> 值更改为自己的值。

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

通过使用以下示例来使用 New-AzWvdRegistrationInfo cmdlet 生成有效期为 24 小时的注册密钥。

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    ExpirationTime = $((Get-Date).ToUniversalTime().AddHours(24).ToString('yyyy-MM-ddTHH:mm:ss.fffffffZ'))
}

New-AzWvdRegistrationInfo @parameters

获取注册密钥并将其复制到剪贴板以供以后使用。稍后还可以在注册密钥有效期内随时通过运行此命令来检索注册密钥。
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

(Get-AzWvdHostPoolRegistrationToken @parameters).Token
```

下面介绍如何使用适用于 Azure CLI 的 desktopvirtualization 扩展生成注册密钥。在以下示例中，请务必将 <placeholder> 值更改为自己的值。

在本地设备上运行 Azure CLI。
- 如果在本地使用 Azure CLI，请先使用 Azure CLI 登录，然后务必将 Azure 上下文设置为要使用的订阅。

通过使用以下示例来使用 az desktopvirtualization workspace update 命令生成有效期为 24 小时的注册密钥。

az desktopvirtualization hostpool update \
    --name <Name> \
    --resource-group <ResourceGroupName> \
    --registration-info expiration-time=$(date -d '+24 hours' --iso-8601=ns) registration-token-operation="Update"

获取注册密钥并将其复制到剪贴板以供以后使用。稍后还可以在注册密钥有效期内随时通过运行此命令来检索注册密钥。
```
az desktopvirtualization hostpool retrieve-registration-token \
    --name <Name> \
    --resource-group <ResourceGroupName> \
    --query token --output tsv
```

创建会话主机并将其注册到 Azure 虚拟桌面服务

可以使用 Azure 门户或 Azure 资源管理器模板（ARM 模板）通过 Azure 虚拟桌面服务在单个端到端进程中创建会话主机并将其注册到主机池。可以在此 GitHub 存储库中找到一些示例 ARM 模板。

重要

如果要使用 Azure 虚拟桌面外部的替代方法（例如自动化管道）创建虚拟机，则需要将它们作为会话主机单独注册到主机池。跳到将会话主机注册到主机池部分。

下面介绍如何使用 Azure 门户中的 Azure 虚拟桌面服务创建会话主机并将其注册到主机池。请确保先生成注册密钥。

登录到 Azure 门户。
在搜索栏中，输入“Azure 虚拟桌面”，然后选择匹配的服务条目。
选择“主机池”，然后选择要向其添加会话主机的主机池的名称。
在主机池概述中，选择“会话主机”，然后选择“+ 添加”。
“基本信息”选项卡不可用，因为你使用的是现有的主机池。选择“下一步: 虚拟机”。

在虚拟机选项卡上填写信息。有关调整会话主机虚拟机大小的指导，请参阅会话主机虚拟机大小调整指导原则。

参数	值/说明
资源组	此值默认为与主机池相同的资源组，但可以从下拉列表中选择不同的资源组。
名称前缀	输入会话主机的名称前缀，例如 hp01-sh。每个会话主机都带有一个连字符后缀，然后在末尾添加序列号，例如 hp01-sh-0。此名称前缀最多可以包含 11 个字符，并用于操作系统中的计算机名。前缀和后缀加起来最多可以包含 15 个字符。会话主机名必须唯一。
虚拟机位置	选择要在其中部署会话主机的 Azure 区域。它必须是包含虚拟网络的同一区域。
可用性选项	从“可用性区域”、“可用性集”或“无需基础结构冗余”中进行选择。如果选择“可用性区域”或“可用性集”，请填写显示的额外参数。
安全类型	从“标准”或受信任启动虚拟机中进行选择。 - 如果选择“受信任启动虚拟机”，则系统会自动选择“安全启动”和“vTPM”选项。
图像	从列表中选择要使用的 OS 映像，或选择“查看所有映像”以了解详细信息。完整列表包括已创建并存储为 Azure Compute Gallery 共享映像或托管映像的所有映像。
虚拟机大小	选择一个大小。如果要使用不同的大小，请选择“更改大小”，然后从列表中选择。
VM 数量	输入要部署的虚拟机数。如果需要，此时最多可以部署 400 台会话主机（具体取决于你的订阅配额），也可以稍后再添加更多主机。有关详细信息，请参阅 Azure 虚拟桌面服务限制和虚拟机限制。
OS 磁盘类型	选择要用于会话主机的磁盘类型。建议仅将高级 SSD 用于生产工作负载。
启动诊断	选择是否要启用启动诊断。
网络和安全性
虚拟网络	选择你的虚拟网络。这会显示用于选择子网的选项。
子网	从虚拟网络中选择子网。
网络安全组	选择是否要使用网络安全组 (NSG)。如果选择“无”，则不会创建新的 NSG。- - “基本”会为 VM 网络适配器创建新的 NSG。 - 选择“高级”可以选择现有 NSG。建议不要在此处创建 NSG，而是在子网上创建 NSG。
公共入站端口	可以从列表中选择要允许的端口。 Azure 虚拟桌面不需要公共入站端口，因此建议选择“否”。
要加入的域
选择要加入的目录	从“Microsoft Entra ID”或“Active Directory”中进行选择，并填写所选选项的相关参数。若要详细了解如何将会话主机加入 Microsoft Entra ID，请参阅已加入 Microsoft Entra 的会话主机。
虚拟机管理员帐户
用户名	输入要用作新会话主机的本地管理员帐户的名称。
密码	输入本地管理员帐户的密码。
确认密码	重新输入密码。
自定义配置
自定义配置脚本 URL	如果要在部署期间运行 PowerShell 脚本，则可以在此处输入 URL。

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

在“标记”选项卡上，可以选择输入所需的任何名称/值对，然后选择“下一步: 查看 + 创建”。
在“查看 + 创建”选项卡上，确保验证通过并查看部署期间将使用的信息。如果验证未通过，请查看错误消息并检查在每个选项卡中输入的内容。
选择创建。部署完成后，会话主机应显示在主机池中。

重要

使用 Azure 虚拟桌面服务添加会话主机后，请跳到“部署后任务”部分以了解可能需要执行的一些额外配置。

将会话主机注册到主机池

如果已使用 Azure 虚拟桌面外部的替代方法（例如自动化管道）创建了虚拟机，则需要将它们作为主机池单独注册到会话主机。

要将会话主机注册到主机池，需要在每台虚拟机上安装 Azure 虚拟桌面代理和 Azure 虚拟桌面代理引导加载程序，并使用所生成的注册密钥。可以使用代理安装程序的图形用户界面 (GUI) 或从命令行中使用 msiexec 将会话主机注册到主机池。

完成后，四个应用程序将会列为已安装的应用程序：

远程桌面代理启动加载程序
远程桌面服务基础结构代理
远程桌面服务基础结构日内瓦代理
远程桌面服务 SxS 网络堆栈

选择你的方案对应的相关选项卡并按照步骤操作。

GUI
命令行

确保要用作会话主机的虚拟机已加入 Microsoft Entra ID 或 Active Directory 域（Active Directory 域服务或 Microsoft Entra 域服务）。
如果虚拟机运行的是 Windows Server OS，则需要安装远程桌面会话主机角色，然后重启虚拟机。有关详细信息，请参阅使用“添加角色和功能”向导安装角色、角色服务和功能。
以管理员身份登录到虚拟机。
使用以下链接下载该代理和代理启动加载程序的安装文件。如果需要取消阻止它们，请右键单击每个文件，选择“属性”和“取消阻止”，最后选择“确定”。
- Azure 虚拟桌面代理
- Azure 虚拟桌面代理引导加载程序
提示

Azure 虚拟桌面代理下载链接适用于非验证环境中的最新生产版本。自动生产推出完成后，将会更新此下载链接，因此你可能会看到发布生产版本与下载链接更新之间存在延迟。安装 Azure 虚拟桌面代理后，它会自动更新。有关新版本代理推出的详细信息，请参阅 Azure 虚拟桌面代理中的新增功能？。
运行 Microsoft.RDInfra.RDAgent.Installer-x64-<version>.msi 文件以安装远程桌面服务基础结构代理。
按提示操作。当安装程序提示你输入注册令牌时，请将其粘贴到显示在单行上的文本框中。选择“下一步”，然后完成安装。
运行 Microsoft.RDInfra.RDAgentBootLoader.Installer-x64-<version>.msi 文件以安装其余组件。
按照提示完成安装。
稍等片刻后，虚拟机会在主机池中列出为会话主机。会话主机的状态最初可能会显示为“不可用”。如果更新的代理版本可用，则会自动升级它。
当会话主机的状态为“可用”后，重启虚拟机。

可以通过自动化部署工具（如 Intune 或 Configuration Manager）使用 msiexec 从命令行安装代理和启动加载程序。在以下示例中，请务必将 <placeholder> 值更改为自己的值。

确保要用作会话主机的虚拟机已加入 Microsoft Entra ID 或 Active Directory 域（Active Directory 域服务或 Microsoft Entra 域服务）。
如果虚拟机运行的是 Windows Server 操作系统，则需要通过以管理员身份运行以下 PowerShell 命令来安装“远程桌面会话主机”角色，此操作还会重启虚拟机。
```
Install-WindowsFeature -Name RDS-RD-Server -Restart
```

下载该代理和代理启动加载程序的安装文件，并通过运行以下命令取消阻止它们。文件将下载到当前工作目录。

$uris = @(
    "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrmXv"
    "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RWrxrH"
)

$installers = @()
foreach ($uri in $uris) {
    $download = Invoke-WebRequest -Uri $uri -UseBasicParsing

    $fileName = ($download.Headers.'Content-Disposition').Split('=')[1].Replace('"','')
    $output = [System.IO.FileStream]::new("$pwd\$fileName", [System.IO.FileMode]::Create)
    $output.write($download.Content, 0, $download.RawContentLength)
    $output.close()
    $installers += $output.Name
}

foreach ($installer in $installers) {
    Unblock-File -Path "$installer"
}

提示

此版本的 Azure 虚拟桌面代理是非验证环境中的最新可下载版本。有关新版本代理推出的详细信息，请参阅 Azure 虚拟桌面代理中的新增功能？。

若要安装远程桌面服务基础结构代理，请以管理员身份运行以下命令：

msiexec /i Microsoft.RDInfra.RDAgent.Installer-x64-<version>.msi /quiet REGISTRATIONTOKEN=<RegistrationToken>

若要安装其余组件，请以管理员身份运行以下命令：

msiexec /i Microsoft.RDInfra.RDAgentBootLoader.Installer-x64.msi /quiet

稍等片刻后，虚拟机会在主机池中列出为会话主机。会话主机的状态最初可能会显示为“不可用”。如果更新的代理版本可用，则会自动升级它。
当会话主机的状态为“可用”后，重启虚拟机。

部署后任务

将会话主机添加到主机池后，可能需要执行一些额外的配置，如以下部分所述。

许可

要确保会话主机已正确应用许可证，需要执行以下任务：

如果拥有运行 Azure 虚拟桌面工作负载所需的正确许可证，则可以将 Windows 或 Windows Server 许可证作为 Azure 虚拟桌面的一部分应用到会话主机，无需支付单独的许可证费用即可运行。此许可证是在使用 Azure 虚拟桌面服务创建会话主机时自动应用的，但如果在 Azure 虚拟桌面外部创建了会话主机，则可能需要单独应用该许可证。有关详细信息，请参阅将 Windows 许可证应用于会话主机虚拟机。
如果会话主机运行的是 Windows Server OS，则还需要从 RDS 许可证服务器向它们颁发远程桌面服务 (RDS) 客户端访问许可证 (CAL)。有关详细信息，请参阅使用客户端访问许可证许可 RDS 部署。
对于 Azure Local 上的会话主机，必须先许可并激活虚拟机，然后才能将其与 Azure 虚拟桌面配合使用。要激活使用 Windows 10 企业版多会话、Windows 11 企业版多会话和 Windows Server 2022 Datacenter：Azure Edition 的 VM，请使用适用于 VM 的 Azure 验证。对于其他所有 OS 映像（例如 Windows 10 企业版、Windows 11 企业版，以及其他版本的 Windows Server），应继续使用现有的激活方法。有关详细信息，请参阅在 Azure Local 上激活 Windows Server VM。

已建立 Microsoft Entra 联接的会话主机

对于 Azure 上已加入 Microsoft Entra ID 的会话主机，还需要启用单一登录或更早的身份验证协议、向用户分配 RBAC 角色，并查看多重身份验证策略，以便用户可以登录到 VM。有关详细信息，请参阅已加入 Microsoft Entra 的会话主机。

现在，你已扩展了现有主机池，可以登录到 Azure 虚拟桌面客户端以在用户会话中测试主机。你可以使用以下任一客户端连接到会话：

通过