配置个人桌面分配

项目
04/07/2024

重要

本教程的内容适用于包含 Azure 资源管理器 Azure 虚拟桌面对象的 Azure 虚拟桌面。

必须将用户分配到个人桌面才能启动其会话。你可以配置个人桌面主机池的分配类型，以调整 Azure 虚拟桌面环境来更好地满足你的需求。在本主题中，我们将介绍如何为用户配置自动分配或直接分配。

注意

本文中的说明仅适用于个人桌面主机池而不适用于共用主机池，因为不会将共用主机池中的用户分配到特定的会话主机。

先决条件

如果使用 Azure 门户或 PowerShell 方法，则需要以下各项：

具有至少一个会话主机的个人主机池。
分配有桌面虚拟化参与者角色的 Azure 帐户。
如果要在本地使用 Azure CLI 或 Azure PowerShell，请参阅将 Azure CLI 和 Azure PowerShell 与 Azure 虚拟桌面配合使用，确保已安装 desktopvirtualization Azure CLI 扩展或 Az.DesktopVirtualization PowerShell 模块。

如果要使用 PowerShell 分配桌面，则需要下载并安装 Azure 虚拟桌面 PowerShell 模块（如果尚未下载安装）。

配置自动分配

自动分配在用户首次连接时会为其分配个人桌面。它是在 Azure 虚拟桌面环境中新创建的个人桌面主机池的默认分配类型。自动分配用户不需要特定的会话主机。

若要自动分配用户，请先将其分配到个人桌面主机池，以便他们能够在其源中看到桌面。当分配的用户在其源中启动桌面时，如果他们尚未连接到主机池，他们的用户会话将被负载均衡到可用的会话主机。分配类型设置为自动，仍可以在他们连接之前将用户直接分配到会话主机。

若要在 Azure 门户中配置自动分配，请执行以下操作：

登录 Azure 门户。
在搜索栏中，输入“Azure 虚拟桌面”，然后选择匹配的服务条目。
选择“主机池”，然后选择要配置自动分配的个人主机池。
接下来，选择“属性”，转到“分配”下拉菜单，然后选择“自动”。
选择“保存” 。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块将主机池配置为自动将用户分配到 VM。

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

运行以下示例中的 Update-AzWvdHostPool 命令，将主机池配置为自动将用户分配到 VM。有关参数的详细信息，请参阅 az-desktopvirtualization-hostpool Azure CLI 参考。
```
Update-AzWvdHostPool -ResourceGroupName $resourceGroupName -Name $hostPoolName -PersonalDesktopAssignmentType Automatic
```

下面介绍如何使用 az-desktopvirtualization-hostpool-update 命令将主机池配置为自动将用户分配到 VM。

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

运行以下示例中的命令，将主机池配置为自动将用户分配到 VM。有关参数的详细信息，请参阅 az-desktopvirtualization-hostpool Azure CLI 参考。
```
az desktopvirtualization hostpool update \
    --resource-group $resourceGroupName \
    --name $hostPoolName \
    --personal-desktop-assignment-type Automatic
```

配置直接分配

与自动分配不同，使用直接分配时，首先将特定的个人桌面分配给用户。必须将用户分配到个人桌面主机池和特定的会话主机，然后他们才能连接到其个人桌面。如果仅将用户分配到主机池而不分配会话主机，他们将无法访问资源，并且会看到一条错误消息，指出“无可用的资源”。

若要在 Azure 门户中配置直接分配，请执行以下操作：

登录 Azure 门户。
在搜索栏中，键入“Azure 虚拟桌面”，然后选择匹配的服务条目。
选择“主机池”，然后选择要配置自动分配的个人主机池。
接下来，选择“属性”，转到“分配”下拉菜单，然后选择“直接”。
选择“保存” 。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块将主机池配置为要求将用户直接分配到会话主机。

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

运行以下示例中的 Update-AzWvdHostPool 命令，将主机池配置为要求直接分配。有关参数的详细信息，请参阅 Update-AzWvdHostPool 参考。
```
Update-AzWvdHostPool -ResourceGroupName $resourceGroupName -Name $hostPoolName -PersonalDesktopAssignmentType Direct
```

下面介绍如何使用 az-desktopvirtualization-hostpool-update 命令将主机池配置为自动将用户分配到 VM。

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

运行以下示例中的命令，将主机池配置为自动将用户分配到 VM。有关参数的详细信息，请参阅 az-desktopvirtualization-hostpool Azure CLI 参考。
```
az desktopvirtualization hostpool update \
    --resource-group $resourceGroupName \
    --name $hostPoolName \
    --personal-desktop-assignment-type Direct
```

直接将用户分配到会话主机

下面介绍如何使用 Azure 门户或 PowerShell 将用户直接分配到会话主机。无法使用 Azure CLI 将用户分配到会话主机。

Azure 门户
PowerShell

要直接将用户分配到 Azure 门户中的会话主机，请执行以下操作：

登录 Azure 门户。
在搜索栏中输入“Azure 虚拟桌面”。
在“服务”下，选择“Azure 虚拟桌面” 。
在“Azure 虚拟桌面”页上，转到窗口左侧的菜单，选择“主机池”。
选择要将用户分配到的主机池。
接下来，请跳到窗口左侧的菜单，并选择“应用程序组”。
选择要将用户分配到的应用组的名称，然后在窗口左侧的菜单中选择“分配”。
选择“+ 添加”，然后选择要分配到此应用组的用户或用户组。
选择信息栏中的“分配 VM”，从而为用户分配会话主机。
选择要分配给用户的会话主机，然后选择“分配”。也可以依次选择“分配”>“分配用户”。
从可用用户列表中选择要将会话主机分配给的用户。
完成后，选择“选择”。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块将主机池配置为将用户分配到特定会话主机。

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

运行以下示例中的 Update-AzWvdHostPool 命令，将用户分配到会话主机。有关参数的详细信息，请参阅 Update-AzWvdHostPool 参考。
```
Update-AzWvdSessionHost -HostPoolName $hostPoolName -Name $sessionHostName -ResourceGroupName $resourceGroupName -AssignedUser $userupn
```

取消分配个人桌面

下面介绍如何使用 Azure 门户或 PowerShell 取消分配个人桌面。无法使用 Azure CLI 取消分配个人桌面。

Azure 门户
PowerShell

在 Azure 门户中取消分配个人桌面的步骤：

登录 Azure 门户。
在搜索栏中输入“Azure 虚拟桌面”。
在“服务”下，选择“Azure 虚拟桌面” 。
在“Azure 虚拟桌面”页上，转到窗口左侧的菜单，选择“主机池”。
选择要修改其用户分配的主机池。
接下来，转到窗口左侧的菜单，然后选择“会话主机”。
选中要取消分配用户的会话主机旁边的复选框，选择行末尾的省略号，然后选择“取消分配用户”。也可以依次选择“分配”>“取消分配用户”。
出现警告提示时，选择“取消分配”。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块将主机池配置为取消分配个人桌面。

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

运行以下示例中的 Invoke-AzRestMethod 命令以取消分配个人桌面。有关参数的详细信息，请参阅 Invoke-AzRestMethod 参考。

$unassignDesktopParams = @{
  Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
  Payload = @{
    properties = @{
      assignedUser = ''
    }} | ConvertTo-Json
  Method = 'PATCH'
}
Invoke-AzRestMethod @unassignDesktopParams

重新分配个人桌面

下面介绍如何使用 Azure 门户或 PowerShell 重新分配个人桌面。无法使用 Azure CLI 重新分配个人桌面。

Azure 门户
PowerShell

在 Azure 门户中重新分配个人桌面的步骤：

登录 Azure 门户。
在搜索栏中输入“Azure 虚拟桌面”。
在“服务”下，选择“Azure 虚拟桌面” 。
在“Azure 虚拟桌面”页上，转到窗口左侧的菜单，选择“主机池”。
选择要修改其用户分配的主机池。
接下来，转到窗口左侧的菜单，然后选择“会话主机”。
选中要重新分配到不同用户的会话主机旁边的复选框，选择行末尾的省略号，然后选择“分配到其他用户”。也可以依次选择“分配”>“分配到其他用户”。
从可用用户列表中选择要将会话主机分配给的用户。
完成后，选择“选择”。

下面介绍如何使用 Az.DesktopVirtualization PowerShell 模块来重新分配个人桌面。

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

运行以下命令以定义 $reassignUserUpn 变量：

$reassignUserUpn = <UPN of user you are reassigning the desktop to>

运行以下示例中的 Invoke-AzRestMethod 命令以重新分配个人桌面。有关参数的详细信息，请参阅 Invoke-AzRestMethod 参考。

$reassignDesktopParams = @{
  Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
  Payload = @{
    properties = @{
      assigneduser = $reassignUserUpn
    }} | ConvertTo-Json
  Method = 'PATCH'
}
Invoke-AzRestMethod @reassignDesktopParams

为个人主机池中的会话主机指定易记的名称

可以为你创建的个人桌面指定“易记名称”，以帮助用户使用 PowerShell 在源中区分它们。 Azure 门户或 Azure CLI 目前无法为会话主机提供易记名称。

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

在 PowerShell 中运行以下命令，为会话主机添加或更改一个易记的名称：

$parameters = @{
   HostPoolName = 'HostPoolName'
   Name = 'SessionHostName'
   ResourceGroupName = 'ResourceGroupName'
   FriendlyName = 'SessionHostFriendlyName'
}

Update-AzWvdSessionHost @parameters

若要为会话主机指定易记名称，请在 PowerShell 中运行以下命令：

$sessionHostParams = @{
   HostPoolName = 'HostPoolName'
   Name = 'SessionHostName'
   ResourceGroupName = 'ResourceGroupName'
}

Get-AzWvdSessionHost @sessionHostParams | FL Name, AssignedUser, FriendlyName

后续步骤

配置个人桌面分配类型并为会话主机指定易记名称后，可以登录到 Azure 虚拟桌面客户端，将其作为用户会话的一部分进行测试。下面的文章将介绍如何使用所选的客户端连接到会话：