Skip to content

Commit f40e507

Browse files
committed
Added form link and fixed build issues
1 parent 28bd75d commit f40e507

8 files changed

+34
-34
lines changed

articles/virtual-desktop/add-session-hosts-host-pool.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,10 @@ ms.date: 10/01/2024
1414
> The following features are currently in preview:
1515
>
1616
> - Azure Virtual Desktop on Azure Stack HCI for Azure Government and for Azure operated by 21Vianet (Azure in China).
17+
>
1718
> - 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.
1921
>
2022
> 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/).
2123

articles/virtual-desktop/deploy-azure-virtual-desktop.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ zone_pivot_groups: azure-virtual-desktop-host-pool-management-approaches
66
ms.custom: devx-track-azurecli, devx-track-azurepowershell
77
author: dknappettmsft
88
ms.author: daknappe
9-
ms.date: 10/01/2024
9+
ms.date: 10/18/2024
1010
---
1111

1212
# Deploy Azure Virtual Desktop
@@ -15,8 +15,10 @@ ms.date: 10/01/2024
1515
> The following features are currently in preview:
1616
>
1717
> - Azure Virtual Desktop on Azure Stack HCI for Azure Government and for Azure operated by 21Vianet (Azure in China).
18+
>
1819
> - 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).
2022
>
2123
> 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/).
2224
@@ -199,7 +201,7 @@ To create a host pool with a session host configuration, select the relevant tab
199201

200202
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.
201203

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.
203205

204206
1. In the search bar, enter *Azure Virtual Desktop* and select the matching service entry.
205207

@@ -225,7 +227,7 @@ Here's how to create a host pool with a session host configuration using the Azu
225227

226228
| Parameter | Value/Description |
227229
|--|--|
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). |
229231
| **Session host configuration** | |
230232
| 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. |
231233
| 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
298300
299301
[!INCLUDE [include-cloud-shell-local-powershell](includes/include-cloud-shell-local-powershell.md)]
300302

301-
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).
302304

303305
```azurepowershell
304306
$parameters = @{

articles/virtual-desktop/host-pool-management-approaches.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Creating, updating, and scaling session hosts in a host pool can require much ef
3838
3939
### Session host configuration
4040

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:
4242

4343
:::row:::
4444
:::column:::

articles/virtual-desktop/session-host-update-configure.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 10/01/2024
1010
# Update session hosts in host pool with a session host configuration using session host update in Azure Virtual Desktop (preview)
1111

1212
> [!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).
1414
>
1515
> 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.
1616
@@ -101,7 +101,7 @@ Here's how to schedule a new update for your session hosts using the Azure porta
101101
>
102102
> If you edit the session host configuration using the Azure portal, you have to schedule an update.
103103
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.
105105

106106
1. Select **Session hosts**.
107107

@@ -367,7 +367,7 @@ From your existing PowerShell session, use the `Get-AzWvdSessionHostManagementsU
367367
---
368368

369369
> [!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).
371371
372372
## Pause, resume, cancel, or retry an update
373373

articles/virtual-desktop/session-host-update-diagnostics.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.date: 10/01/2024
1414
>
1515
> 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.
1616
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.
1818

1919
## Prerequisites
2020

@@ -32,7 +32,7 @@ Once you configure diagnostic settings on a host pool, diagnostic data for sessi
3232

3333
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).
3434

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).
3636

3737
## Session host updates that completed successfully
3838

articles/virtual-desktop/session-host-update.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,10 +58,10 @@ The existing power state and drain mode of session hosts is honored. You can per
5858

5959
> [!IMPORTANT]
6060
> - 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).
6363
>
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.
6565
>
6666
> - 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.
6767
@@ -110,8 +110,8 @@ Here are known issues and limitations:
110110
- 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.
111111

112112
- 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).
115115
- Manually add these new session hosts from within [Azure Virtual Desktop Insights](insights.md) in the Azure portal.
116116

117117
- 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.

articles/virtual-desktop/troubleshoot-session-host-update.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Troubleshoot session host update - Azure Virtual Desktop
3-
description: Some troubleshoot guidance to help with session host update.
3+
description: Troubleshooting guidance to help with session host update.
44
ms.topic: troubleshooting
55
author: dknappettmsft
66
ms.author: daknappe
@@ -66,7 +66,7 @@ Here are some example failures that prevent an update from starting:
6666

6767
- **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.
6868

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.
7070

7171
### Failures during an update
7272

0 commit comments

Comments
 (0)