Skip to content

Commit 80a58ed

Browse files
diberrydiberry
committed
Azure Virtual Desktop
1 parent 5695fe4 commit 80a58ed

File tree

3 files changed

+90
-0
lines changed

3 files changed

+90
-0
lines changed

‎articles/azure-mcp-server/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,8 @@ items:
5757
href: tools/azure-sql.md
5858
- name: Azure Storage
5959
href: tools/storage.md
60+
- name: Azure Virtual Desktop
61+
href: tools/azure-virtual-desktop.md
6062
- name: Resource Group
6163
href: tools/resource-group.md
6264
- name: Subscription

‎articles/azure-mcp-server/includes/tools/supported-azure-services.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,7 @@ Azure MCP Server provides the following tools for Azure services and Azure-relat
3535
| [Azure Service Bus](../../tools/service-bus.md) | Work with Azure Service Bus messaging services. |
3636
| [Azure SQL](../../tools/azure-sql.md) | Work with Azure SQL Database servers, databases, firewall rules, and elastic pools. |
3737
| [Azure Storage](../../tools/storage.md) | List Azure Storage accounts, containers, blobs, and tables. |
38+
| [Azure Virtual Desktop](../../tools/azure-virtual-desktop.md) | Manage Azure Virtual Desktop host pools, session hosts, and user sessions. |
3839
| [Resource Groups](../../tools/resource-group.md) | List Azure resource groups. |
3940
| [Subscription](../../tools/subscription.md) | List Azure subscriptions. |
4041
| [Terraform best practices for Azure](../../tools/azure-terraform-best-practices.md) | Get guidance on implementing Terraform for Azure resources. |

‎articles/azure-mcp-server/tools/azure-virtual-desktop.md

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
---
2+
title: Azure Virtual Desktop Tools
3+
description: Learn how to use the Azure MCP Server with Azure Virtual Desktop.
4+
keywords: azure mcp server, azmcp, azure virtual desktop, avd, host pools, session hosts
5+
author: diberry
6+
ms.author: diberry
7+
ms.date: 08/06/2025
8+
content_well_notification:
9+
- AI-contribution
10+
ai-usage: ai-assisted
11+
ms.topic: reference
12+
ms.custom: build-2025
13+
---
14+
15+
# Azure Virtual Desktop tools for the Azure MCP Server
16+
17+
The Azure MCP Server enables you to manage Azure Virtual Desktop resources by using natural language prompts. You can list host pools, view session hosts, monitor user sessions, and manage your virtual desktop infrastructure without needing to remember complex command syntax.
18+
19+
[Azure Virtual Desktop](/azure/virtual-desktop/overview) is a desktop and app virtualization service that runs on the cloud. It provides a full Windows experience with optimized Office 365 ProPlus, and supports Remote Desktop Services environments.
20+
21+
[!INCLUDE [tip-about-params](../includes/tools/parameter-consideration.md)]
22+
23+
## Conditional parameters
24+
25+
Some of the Azure Virtual Desktop tools require **one** of the following parameter options within the conversation context:
26+
27+
- **Option 1**: Host pool name
28+
- **Option 2**: Host pool resource ID
29+
30+
Don't provide both parameters (host pool name and host pool resource ID) together, because this combination creates conflicting inputs. When you provide a host pool resource ID, the tool uses it instead of searching by name.
31+
32+
## Host pools: list
33+
34+
The Azure MCP Server can list all host pools in a subscription or resource group. This feature provides an overview of your virtual desktop infrastructure and helps you manage your desktop deployment.
35+
36+
Example prompts include:
37+
38+
- **List all host pools**: "Show me all host pools in my subscription."
39+
- **View host pools**: "What host pools do I have available?"
40+
- **Find host pools**: "List all virtual desktop host pools."
41+
- **Query host pools**: "Show available host pools in my environment."
42+
- **Check infrastructure**: "Get all Azure Virtual Desktop host pools."
43+
44+
| Parameter | Required or optional | Description |
45+
|-----------|-------------|-------------|
46+
| **Resource group** | Optional | The name of the resource group. If specified, the command returns only host pools in that resource group. |
47+
48+
## Host pools: list session hosts in a host pool
49+
50+
The Azure MCP Server can list all session hosts in a host pool. This functionality helps you monitor your virtual machines and understand the capacity and status of your virtual desktop environment.
51+
52+
Example prompts include:
53+
54+
- **List session hosts**: "Show me all session hosts in the 'production-hostpool' host pool."
55+
- **View VMs**: "What session hosts are in my host pool?"
56+
- **Find hosts**: "List all virtual machines in hostpool 'dev-environment'."
57+
- **Query capacity**: "Show session hosts in my virtual desktop pool."
58+
- **Check hosts**: "Get all session hosts for host pool ID '/subscriptions/abc123/resourceGroups/rg/providers/Microsoft.DesktopVirtualization/hostPools/pool1'."
59+
60+
| Parameter | Required or optional | Description |
61+
|-----------|-------------|-------------|
62+
| **Host pool** | [Conditionally](#conditional-parameters) required | The name of the Azure Virtual Desktop host pool. This is the unique name you choose for your host pool. |
63+
| **Host pool resource ID** | [Conditionally](#conditional-parameters) required | The Azure resource ID of the host pool. When you provide this ID, the server uses it instead of searching by name. |
64+
65+
## Host pools: list user sessions
66+
67+
The Azure MCP Server can list all user sessions on a specific session host in a host pool. This capability helps you monitor active users, troubleshoot connection issues, and manage user workloads.
68+
69+
Example prompts include:
70+
71+
- **List user sessions**: "Show me all user sessions on session host 'vm-prod-001' in host pool 'production-pool'."
72+
- **View active users**: "What users are connected to session host 'desktop-vm-02'?"
73+
- **Find sessions**: "List all active sessions on host 'avd-host-001'."
74+
- **Monitor users**: "Show user sessions for session host in my host pool."
75+
- **Check connections**: "Get all user sessions on virtual machine 'session-host-03'."
76+
77+
| Parameter | Required or optional | Description |
78+
|-----------|-------------|-------------|
79+
| **Host pool** | [Conditionally](#conditional-parameters) required | The name of the Azure Virtual Desktop host pool. This is the unique name you choose for your host pool. |
80+
| **Host pool resource ID** | [Conditionally](#conditional-parameters) required | The Azure resource ID of the host pool. When you provide this ID, the server uses it instead of searching by name. |
81+
| **Session host** | Required | The name of the session host. This name is the computer name of the virtual machine in the host pool. |
82+
83+
## Related content
84+
85+
- [What are the Azure MCP Server tools?](index.md)
86+
- [Get started using Azure MCP Server](../get-started.md)
87+
- [Azure Virtual Desktop documentation](/azure/virtual-desktop/)

0 commit comments

Comments
 (0)