Deploy Azure Virtual Desktop Hybrid

1. Sign in to the Azure portal.
2. In the search bar, enter Resource groups and select the matching entry.
3. Select the resource group containing your Arc-enabled servers.
4. In the left menu, select Access control (IAM).
5. Select Add > Add role assignment.
6. Search for Reader and select it, then select Next.
7. For Assign access to, select Managed identity.
8. Select Select members, then select your subscription and choose Host pool from the Managed identity dropdown.
9. Select the managed identity for your host pool, then select Select.
10. Select Review + assign, review your selections, and select Review + assign again.

$hostPool    = Get-AzWvdHostPool -Name "<HostPoolName>" -ResourceGroupName "<HostPoolResourceGroup>"
$principalId = $hostPool.IdentityPrincipalId

New-AzRoleAssignment -ObjectId $principalId -RoleDefinitionName "Reader" -ResourceGroupName "<ArcServersResourceGroup>"

1. Sign in to the Azure portal.

2. In the search bar, enter Azure Arc and select the matching entry.

3. In the left menu, expand Infrastructure.

4. Select Machines.

5. Click on the Name of the machine you wish to add to AVD.

6. In the left menu, expand Settings and select Extensions.

7. Click Add.

8. Select the Azure Virtual Desktop Hybrid extension and click Next.

9. Select the Subscription that contains the Host pool.

10. Select the Resource Group that contains the Host pool.

11. Select the Host pool to which you want to add the session host.

12. Click Review + Create.

13. Click Create.

Required PowerShell modules

• The Az.DesktopVirtualization Azure PowerShell module must be installed.

• The Az.ConnectedMachine Azure PowerShell module must be installed.

• If you're using PowerShell locally, first sign in with Azure PowerShell, and then make sure your Azure context is set to the subscription that you want to use.

Generate a host pool registration key

When you add session hosts to a host pool, first you need to generate a registration key for that host pool. A registration key authorizes session hosts to join the host pool. It's valid only for the duration that you specify.

$expiresUtc = (Get-Date).ToUniversalTime().AddHours(24).ToString("yyyy-MM-ddTHH:mm:ss.fffffffZ")
$regInfo    = New-AzWvdRegistrationInfo -ResourceGroupName $HostPoolRG -HostPoolName $HostPoolName -ExpirationTime $expiresUtc
$token      = $regInfo.Token

Install the Arc extension and pass the registration token

Run the CloudDeviceExtension and pass the registration token.

# Settings
$protectedSettings = @{ registrationToken = $token }
 
# Install extension
New-AzConnectedMachineExtension -Name 'Microsoft.AzureVirtualDesktop.CloudDeviceExtension' -ResourceGroupName '<ResourceGroupName>' -MachineName '<MachineName>' -Location '<Azure Region>' -Publisher 'Microsoft.AzureVirtualDesktop' -ExtensionType 'CloudDeviceExtension' -ProtectedSetting $protectedSettings

Validate the Arc extension was successfully installed

After the Arc extension completes, Azure Arc reports Succeeded if the extension installed successfully.

1. Sign in to the Azure portal.

2. In the search bar, enter Azure Arc and select the matching service entry.

3. Select Infrastructure.

4. Select Machines.

5. In the Name column, select the Arc VM you need to validate.

6. In the left menu, select Settings > Extensions.

7. The Status column for Microsoft.AzureVirtualDesktop.CloudDeviceExtension should show Succeeded.

This example uses the Az.ConnectedMachine Azure PowerShell module.

Get-AzConnectedMachineExtension -ResourceGroupName '<ResourceGroupName>' -MachineName '<Machine_Name>' -Name 'Microsoft.AzureVirtualDesktop.CloudDeviceExtension'

This example requires the connectedmachine extension for Azure CLI.

az connectedmachine extension show \
--resource-group "<ResourceGroupName>" \
--machine-name "<Machine_Name>" \
--name "Microsoft.AzureVirtualDesktop.CloudDeviceExtension"

1. Sign in to the Azure portal.

2. In the search bar, enter Azure Virtual Desktop and select the matching service entry.

3. Select Host Pools.

4. Select the appropriate Host Pool.

5. In the host pool blade, select Session hosts.

6. Locate the VM name in the list and confirm status is Available.

The Az.DesktopVirtualization Azure PowerShell module must be installed.

# List all session hosts in the host pool
Get-AzWvdSessionHost -ResourceGroupName "<Resource Group>" -HostPoolName "<HOST POOL>"
 
# Get details of the specific session host
$sessionHost = Get-AzWvdSessionHost -ResourceGroupName "<Resource Group>" -HostPoolName "<HOST POOL>" -Name "<Arc_Machine_Name_FQDN>"

This example requires the connectedmachine extension for Azure CLI.

# List all session hosts in the host pool
az desktopvirtualization sessionhost list \
    --resource-group "<Resource Group>" \
    --host-pool-name "<HOST POOL>" -o table
 
# Get details of the specific session host
az desktopvirtualization sessionhost show \
    --resource-group "<Resource Group>" \
    --host-pool-name "<HOST POOL>" \
    --name "<Arc_Machine_Name_FQDN>" \
    --output table