Skip to content

Commit b982054

Browse files
Merge pull request #217859 from Heidilohr/work-client-limitation
Adding note to creation section.
2 parents f19f98d + 52839a1 commit b982054

File tree

1 file changed

+19
-8
lines changed

1 file changed

+19
-8
lines changed

articles/virtual-desktop/apply-windows-license.md

Lines changed: 19 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,29 @@ title: Apply Windows license to session host virtual machines - Azure
33
description: Describes how to apply the Windows license for Azure Virtual Desktop VMs.
44
author: Heidilohr
55
ms.topic: how-to
6-
ms.date: 08/14/2019
6+
ms.date: 11/11/2022
77
ms.author: helohr
88
ms.custom: devx-track-azurepowershell
99
---
1010
# Apply Windows license to session host virtual machines
1111

1212
Customers who are properly licensed to run Azure Virtual Desktop workloads are eligible to apply a Windows license to their session host virtual machines and run them without paying for another license. For more information, see [Azure Virtual Desktop pricing](https://azure.microsoft.com/pricing/details/virtual-desktop/).
1313

14-
## Ways to use your Azure Virtual Desktop license
15-
Azure Virtual Desktop licensing allows you to apply a license to any Windows or Windows Server virtual machine that is registered as a session host in a host pool and receives user connections. This license does not apply to virtual machines that are running as file share servers, domain controllers, and so on.
14+
## Ways to apply an Azure Virtual Desktop license
1615

17-
There are a few ways to use the Azure Virtual Desktop license:
18-
- You can create a host pool and its session host virtual machines using the [Azure Marketplace offering](./create-host-pools-azure-marketplace.md). Virtual machines created this way automatically have the license applied.
19-
- You can create a host pool and its session host virtual machines using the [GitHub Azure Resource Manager template](https://github.com/Azure/RDS-Templates/tree/master/ARM-wvd-templates). Virtual machines created this way automatically have the license applied.
20-
- You can apply a license to an existing session host virtual machine. To do this, first follow the instructions in [Create a host pool with PowerShell or the Azure CLI](./create-host-pools-powershell.md) to create a host pool and associated VMs, then return to this article to learn how to apply the license.
16+
Azure Virtual Desktop licensing allows you to apply a license to any Windows or Windows Server virtual machine (VM) that's registered as a session host in a host pool and receives user connections. This license doesn't apply to virtual machines running as file share servers, domain controllers, and so on.
17+
18+
You can apply an Azure Virtual Desktop license to your VMs with the following methods:
19+
20+
- You can create a host pool and its session host virtual machines [in the Azure portal](./create-host-pools-azure-marketplace.md). Creating VMs in the Azure portal automatically applies the license.
21+
- You can create a host pool and its session host virtual machines using the [GitHub Azure Resource Manager template](https://github.com/Azure/RDS-Templates/tree/master/ARM-wvd-templates). Creating VMs with this method automatically applies the license.
22+
- You can manually apply a license to an existing session host virtual machine. To apply the license this way, first follow the instructions in [Create a host pool with PowerShell or the Azure CLI](./create-host-pools-powershell.md) to create a host pool and associated VMs, then return to this article to learn how to apply the license.
2123

2224
## Apply a Windows license to a session host VM
23-
Make sure you have [installed and configured the latest Azure PowerShell](/powershell/azure/). Run the following PowerShell cmdlet to apply the Windows license:
25+
26+
Before you start, make sure you've [installed and configured the latest version of Azure PowerShell](/powershell/azure/).
27+
28+
Next, run the following PowerShell cmdlet to apply the Windows license:
2429

2530
```powershell
2631
$vm = Get-AzVM -ResourceGroup <resourceGroupName> -Name <vmName>
@@ -29,7 +34,9 @@ Update-AzVM -ResourceGroupName <resourceGroupName> -VM $vm
2934
```
3035

3136
## Verify your session host VM is utilizing the licensing benefit
37+
3238
After deploying your VM, run this cmdlet to verify the license type:
39+
3340
```powershell
3441
Get-AzVM -ResourceGroupName <resourceGroupName> -Name <vmName>
3542
```
@@ -60,3 +67,7 @@ $vms | Where-Object {$_.LicenseType -like "Windows_Client"} | Select-Object Reso
6067
## Requirements for deploying Windows Server Remote Desktop Services
6168

6269
If you deploy Windows Server as Azure Virtual Desktop hosts in your deployment, a Remote Desktop Services license server must be accessible from those virtual machines. The Remote Desktop Services license server can be located on-premises or in Azure. For more information, see [Activate the Remote Desktop Services license server](/windows-server/remote/remote-desktop-services/rds-activate-license-server).
70+
71+
## Known limitations
72+
73+
If you create a Windows Server VM using the Azure Virtual Desktop host pool creation process, the process might automatically assign it an incorrect license type. To change the license type using PowerShell, follow the instructions in [Convert an existing VM using Azure Hybrid Benefit for Windows Server](../virtual-machines/windows/hybrid-use-benefit-licensing.md#powershell-1).

0 commit comments

Comments
 (0)