You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/virtual-desktop/add-session-hosts-host-pool.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,8 +14,10 @@ ms.date: 10/01/2024
14
14
> The following features are currently in preview:
15
15
>
16
16
> - Azure Virtual Desktop on Azure Stack HCI for Azure Government and for Azure operated by 21Vianet (Azure in China).
17
+
>
17
18
> - Azure Virtual Desktop on Azure Extended Zones.
18
-
> - Managing session hosts using a session host configuration. This preview is provided as-is, with all faults and as available, and are excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability.
19
+
>
20
+
> - Managing session hosts using a session host configuration. This limited preview is provided as-is, with all faults and as available, and are excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability.
19
21
>
20
22
> For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
> The following features are currently in preview:
16
16
>
17
17
> - Azure Virtual Desktop on Azure Stack HCI for Azure Government and for Azure operated by 21Vianet (Azure in China).
18
+
>
18
19
> - Azure Virtual Desktop on Azure Extended Zones.
19
-
> - Managing session hosts using a session host configuration. This preview is provided as-is, with all faults and as available, and are excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability.
20
+
>
21
+
> - Managing session hosts using a session host configuration. This is a limited preview is provided as-is, with all faults and as available, and is excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability. To register for the limited preview, complete this form: [https://forms.office.com/r/ZziQRGR1Lz](https://forms.office.com/r/ZziQRGR1Lz).
20
22
>
21
23
> For legal terms that apply to Azure features that are in beta, in preview, or otherwise not yet released into general availability, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
22
24
@@ -199,7 +201,7 @@ To create a host pool with a session host configuration, select the relevant tab
199
201
200
202
Here's how to create a host pool with a session host configuration using the Azure portal, which also creates a default session host management policy and default session host configuration. You can change the default session host management policy and session host configuration after deployment.
201
203
202
-
1.Sign in to the [Azure portal](https://portal.azure.com/).
204
+
1.Make sure you've registered for the limited preview using the link at the beginning of this article, then sign in to the Azure portal using the specific link provided to you after registration.
203
205
204
206
1. In the search bar, enter *Azure Virtual Desktop* and select the matching service entry.
205
207
@@ -225,7 +227,7 @@ Here's how to create a host pool with a session host configuration using the Azu
225
227
226
228
| Parameter | Value/Description |
227
229
|--|--|
228
-
| Number of session hosts | Enter the number of session hosts you want to create when creating the host pool. You can enter **0** to not create any session hosts at this point, but a session host configuration is still created with the values you specify for when you do create session hosts.<br /><br />You can deploy up to 500 session host VMs at this point if you wish (depending on your [subscription quota](../quotas/view-quotas.md)), or you can add more later.<br /><br />For more information, see [Azure Virtual Desktop service limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-virtual-desktop-service-limits) and [Virtual Machines limits](../azure-resource-manager/management/azure-subscription-service-limits.md#virtual-machines-limits---azure-resource-manager). |
230
+
| Number of session hosts | Enter the number of session hosts you want to create when creating the host pool. You can enter **0** to not create any session hosts at this point, but a session host configuration is still created with the values you specify for when you do create session hosts.<br /><br />You can deploy up to 500 session host VMs at this point if you wish (depending on your [subscription quota](/azure/quotas/view-quotas)), or you can add more later.<br /><br />For more information, see [Azure Virtual Desktop service limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-virtual-desktop-service-limits) and [Virtual Machines limits](../azure-resource-manager/management/azure-subscription-service-limits.md#virtual-machines-limits---azure-resource-manager). |
229
231
|**Session host configuration**||
230
232
| Resource group | Automatically defaults to the resource group you chose your host pool to be in on the *Basics* tab, but you can also select an alternative from the drop-down list. |
231
233
| Name prefix | Enter a name for your session hosts, for example **hp01-sh**.<br /><br />This value is used as the prefix for your session host VMs. Each session host has a suffix of a hyphen and then a sequential number added to the end, for example **hp01-sh-0**.<br /><br />It can be a maximum of 10 characters and is used in the computer name in the operating system. The prefix and the suffix combined can be a maximum of 15 characters. Session host names must be unique. |
@@ -298,7 +300,7 @@ Here's how to create a host pool with a session host configuration, and a sessio
2. Use the `New-AzWvdHostPool` cmdlet with the following example to create a host pool with a session host configuration using the *breadth-first*[load-balancing algorithm](host-pool-load-balancing.md) and *Desktop* as the preferred [application group type](environment-setup.md#app-groups). More parameters are available; for more information, see the [New-AzWvdHostPool PowerShell reference](/powershell/module/az.desktopvirtualization/new-azwvdhostpool).
303
+
2.Make sure you've registered for the limited preview using the link at the beginning of this article. Use the `New-AzWvdHostPool` cmdlet with the following example to create a host pool with a session host configuration using the *breadth-first*[load-balancing algorithm](host-pool-load-balancing.md) and *Desktop* as the preferred [application group type](environment-setup.md#app-groups). More parameters are available; for more information, see the [New-AzWvdHostPool PowerShell reference](/powershell/module/az.desktopvirtualization/new-azwvdhostpool).
Copy file name to clipboardExpand all lines: articles/virtual-desktop/host-pool-management-approaches.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ Creating, updating, and scaling session hosts in a host pool can require much ef
38
38
39
39
### Session host configuration
40
40
41
-
A session host configuration is a sub-resource of a the session host configuration management approach that specifies the configuration of session hosts in the host pool. The session host configuration persists throughout the lifecycle of the host pool and is aligned with the session hosts in the host pool. The session host configuration includes the following properties:
41
+
A session host configuration is a sub-resource of the session host configuration management approach that specifies the configuration of session hosts in the host pool. The session host configuration persists throughout the lifecycle of the host pool and is aligned with the session hosts in the host pool. The session host configuration includes the following properties:
Copy file name to clipboardExpand all lines: articles/virtual-desktop/session-host-update-configure.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ ms.date: 10/01/2024
10
10
# Update session hosts in host pool with a session host configuration using session host update in Azure Virtual Desktop (preview)
11
11
12
12
> [!IMPORTANT]
13
-
> Session host update for Azure Virtual Desktop is currently in PREVIEW. This preview is provided as-is, with all faults and as available, and are excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability.
13
+
> Session host update for Azure Virtual Desktop is currently in PREVIEW. This is a limited preview is provided as-is, with all faults and as available, and are excluded from the service-level agreements (SLAs) or any limited warranties Microsoft provides for Azure services in general availability. To register for the limited preview, complete this form: [https://forms.office.com/r/ZziQRGR1Lz](https://forms.office.com/r/ZziQRGR1Lz).
14
14
>
15
15
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
16
16
@@ -101,7 +101,7 @@ Here's how to schedule a new update for your session hosts using the Azure porta
101
101
>
102
102
> If you edit the session host configuration using the Azure portal, you have to schedule an update.
103
103
104
-
1. From the Azure Virtual Desktop overview, select **Host pools**, then select the host pool with a session host configuration that you want to update.
104
+
1.Make sure you've registered for the limited preview using the link at the beginning of this article, then sign in to the Azure portal using the specific link provided to you after registration. From the Azure Virtual Desktop overview, select **Host pools**, then select the host pool with a session host configuration that you want to update.
105
105
106
106
1. Select **Session hosts**.
107
107
@@ -367,7 +367,7 @@ From your existing PowerShell session, use the `Get-AzWvdSessionHostManagementsU
367
367
---
368
368
369
369
> [!TIP]
370
-
> You can also see the activity of an update using [Azure Monitor activity log](../azure-monitor/essentials/activity-log.md).
370
+
> You can also see the activity of an update using [Azure Monitor activity log](/azure/azure-monitor/essentials/activity-log).
Copy file name to clipboardExpand all lines: articles/virtual-desktop/session-host-update-diagnostics.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ ms.date: 10/01/2024
14
14
>
15
15
> See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.
16
16
17
-
Session host update uses [Log Analytics in Azure Monitor](../azure-monitor/logs/log-analytics-overview.md) to store information about updates. This article has some example Kusto queries you can use with Log Analytics to see information about session host updates.
17
+
Session host update uses [Log Analytics in Azure Monitor](/azure/azure-monitor/logs/log-analytics-overview) to store information about updates. This article has some example Kusto queries you can use with Log Analytics to see information about session host updates.
18
18
19
19
## Prerequisites
20
20
@@ -32,7 +32,7 @@ Once you configure diagnostic settings on a host pool, diagnostic data for sessi
32
32
33
33
The table `WVDSessionHostManagement` is specific to session host update and is created once you enable the category **Session Host Management Activity Logs** on the diagnostic settings for each host pool you use with session host update, and session host update runs. If you previously configured diagnostic settings for a host pool, you need to enable the category **Session Host Management Activity Logs**. For more information [Configure diagnostic settings to capture platform logs and metrics for Azure Virtual Desktop](diagnostics-log-analytics.md).
34
34
35
-
The rest of this article has some example queries you can run. You can use them as a basis to create your own queries. You need to run each of these queries in Log Analytics. For more information on how to run queries, see [Start Log Analytics](../azure-monitor/logs/log-analytics-overview.md#start-log-analytics).
35
+
The rest of this article has some example queries you can run. You can use them as a basis to create your own queries. You need to run each of these queries in Log Analytics. For more information on how to run queries, see [Start Log Analytics](/azure/azure-monitor/logs/log-analytics-overview#start-log-analytics).
36
36
37
37
## Session host updates that completed successfully
Copy file name to clipboardExpand all lines: articles/virtual-desktop/session-host-update.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,10 +58,10 @@ The existing power state and drain mode of session hosts is honored. You can per
58
58
59
59
> [!IMPORTANT]
60
60
> - If you use Azure Virtual Desktop Insights, the Azure Monitor agent or Log Analytics agent isn't automatically installed on the updated session hosts. To install the agent automatically, here are some options:
61
-
> - For the Azure Monitor agent, you can [use Azure Policy](../azure-monitor/agents/azure-monitor-agent-policy.md).
62
-
> - For the Log Analytics agent, you can [use Azure Automation](../azure-monitor/agents/agent-windows.md?tabs=azure-automation#install-the-agent).
61
+
> - For the Azure Monitor agent, you can [use Azure Policy](/azure/azure-monitor/agents/azure-monitor-agent-policy).
62
+
> - For the Log Analytics agent, you can [use Azure Automation](/azure/azure-monitor/agents/agent-windows?tabs=azure-automation#install-the-agent).
63
63
>
64
-
> - Keep in mind [quota limits](../quotas/view-quotas.md) on your Azure subscription and consider [submitting a request to increase a quota](../quotas/quickstart-increase-quota-portal.md) if an update would go over the limit.
64
+
> - Keep in mind [quota limits](/azure/quotas/view-quotas) on your Azure subscription and consider [submitting a request to increase a quota](/azure/quotas/quickstart-increase-quota-portal) if an update would go over the limit.
65
65
>
66
66
> - We recommend that you test the update process on a test host pool aligned to the host pool you want to update. This will test the update process itself and also the result of a new VM with the same name as the previous VM within your environment. It's also important to test that any updates, such as new applications or hotfixes, work as expected within your environment before updating a production host pool.
67
67
@@ -110,8 +110,8 @@ Here are known issues and limitations:
110
110
- If you decide to create an image that is taken from an existing session host that you then use as the source image for your session host update, you need to delete the `C:\packages\plugin` folder before creating the image. Otherwise this folder prevents the DSC extension that joins the updated virtual machines to the host pool from running.
111
111
112
112
- If you use Azure Virtual Desktop Insights, the Azure Monitor agent or Log Analytics agent isn't automatically installed on the updated session hosts. To install the agent automatically, here are some options:
113
-
- For the Azure Monitor agent, you can [use Azure Policy](../azure-monitor/agents/azure-monitor-agent-policy.md).
114
-
- For the Log Analytics agent, you can [use Azure Automation](../azure-monitor/agents/agent-windows.md?tabs=azure-automation#install-the-agent).
113
+
- For the Azure Monitor agent, you can [use Azure Policy](/azure/azure-monitor/agents/azure-monitor-agent-policy).
114
+
- For the Log Analytics agent, you can [use Azure Automation](/azure/azure-monitor/agents/agent-windows?tabs=azure-automation#install-the-agent).
115
115
- Manually add these new session hosts from within [Azure Virtual Desktop Insights](insights.md) in the Azure portal.
116
116
117
117
- Avoid modifying a session host configuration in a host pool with no session hosts at the same time a session host is being created as this can result in a host pool with inconsistent session host properties.
description: Some troubleshoot guidance to help with session host update.
3
+
description: Troubleshooting guidance to help with session host update.
4
4
ms.topic: troubleshooting
5
5
author: dknappettmsft
6
6
ms.author: daknappe
@@ -66,7 +66,7 @@ Here are some example failures that prevent an update from starting:
66
66
67
67
-**Capacity issues**: validation checks for sufficient capacity in your virtual network subnet and VM core quota. This check does not guarantee capacity during an update; creation of other resources outside of session host update can result in errors mid-update associated with capacity limits. Set your batch size to be within the remaining quota for your subscription.
68
68
69
-
-**Parameter consistency with current session hosts**: session host update doesn't support changing the region, subscription, resource group, or domain join type for a session host. If the session host configuration contains properties in these fields that differs from the session hosts in the host pool, the update fails to start. You should remove the session hosts that are inconsistent with the configuration.
69
+
-**Parameter consistency with current session hosts**: session host update doesn't support changing the region, subscription, resource group, or domain join type for a session host. If the session host configuration contains properties in these fields that differ from the session hosts in the host pool, the update fails to start. You should remove the session hosts that are inconsistent with the configuration.
0 commit comments