Merge pull request #227455 from Heidilohr/work-friendly-sessions2

Creating alternate pull request with split info.

Author: American-Dipper

articles/virtual-desktop/configure-host-pool-personal-desktop-assignment-type.md

@@ -3,12 +3,12 @@ title: Azure Virtual Desktop personal desktop assignment type - Azure
 description: How to configure automatic or direct assignment for an Azure Virtual Desktop personal desktop host pool.
 author: Heidilohr
 ms.topic: how-to
-ms.date: 07/09/2020
+ms.date: 03/02/2023
 ms.author: helohr 
 ms.custom: devx-track-azurepowershell
 manager: femila
 ---
-# Configure the personal desktop host pool assignment type
+# Configure personal desktop host pool assignment
 
 >[!IMPORTANT]
 >This content applies to Azure Virtual Desktop with Azure Resource Manager Azure Virtual Desktop objects. If you're using Azure Virtual Desktop (classic) without Azure Resource Manager objects, see [this article](./virtual-desktop-fall-2019/configure-host-pool-personal-desktop-assignment-type-2019.md).
@@ -22,6 +22,18 @@ You can configure the assignment type of your personal desktop host pool to adju
 
 This article assumes you've already downloaded and installed the Azure Virtual Desktop PowerShell module. If you haven't, follow the instructions in [Set up the PowerShell module](powershell-module.md).
 
+### Define variables
+
+The PowerShell commands listed in this article require defining the following variables:
+
+```powershell
+#Define variables
+$subscriptionId = '00000000-0000-0000-0000-000000000000'
+$resourceGroupName = 'MyResourceGroupName'
+$hostPoolName = 'MyHostPoolName'
+$sessionHostName = 'SessionHostName'
+```
+
 ## Personal host pools overview
 
 A personal host pool is a type of host pool that has personal desktops. Personal desktops have one-to-one mapping, which means a single user can only be assigned to a single personal desktop. Every time the user signs in, their user session is directed to their assigned personal desktop session host. This host pool type is ideal for customers with resource-intensive workloads because user experience and session performance will improve if there's only one session on the session host. Another benefit of this host pool type is that user activities, files, and settings persist on the virtual machine operating system (VM OS) disk after the user signs out.
@@ -83,10 +95,10 @@ To directly assign a user to a session host in the Azure portal:
 11. Select the user you want to assign the session host to from the list of available users.
 12. When you're done, select **Select**.
 
-
-## How to unassign a personal desktop
+## Unassign a personal desktop using the Azure portal
 
 To unassign a personal desktop in the Azure portal:
+
 1. Sign in to the [Azure portal](https://portal.azure.com).
 2. Enter **Azure Virtual Desktop** into the search bar.
 3. Under **Services**, select **Azure Virtual Desktop**.
@@ -103,7 +115,23 @@ To unassign a personal desktop in the Azure portal:
 
 8. Select **Unassign** when prompted with the warning.
 
-## How to reassign a personal desktop
+## Unassign a personal desktop using PowerShell
+
+To unassign a personal desktop in PowerShell, run the following command:
+
+```powershell
+$unassignDesktopParams = @{
+  Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
+  Payload = @{
+    properties = @{
+      assignedUser = ''
+    }} | ConvertTo-Json
+  Method = 'PATCH'
+}
+Invoke-AzRestMethod @unassignDesktopParams
+```
+
+## Reassign a personal desktop using the Azure portal
 
 To reassign a personal desktop in the Azure portal:
 1. Sign in to the [Azure portal](https://portal.azure.com).
@@ -123,6 +151,57 @@ To reassign a personal desktop in the Azure portal:
 8. Select the user you want to assign the session host to from the list of available users.
 9. When you're done, select **Select**.
 
+## Reassign a personal desktop using PowerShell
+
+To reassign a personal desktop, run this command:
+
+```powershell
+$reassignDesktopParams = @{
+  Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview&force=true"
+  Payload = @{
+    properties = @{
+      assigneduser = 'UPN of new user'
+    }} | ConvertTo-Json
+  Method = 'PATCH'
+}
+Invoke-AzRestMethod @reassignDesktopParams
+```
+
+## Give session hosts within a personal host pools a friendly name
+
+You can give personal desktops you create *friendly names* to help users distinguish them in their feeds.
+
+To give a host pool a friendly name, run the following command in PowerShell:
+
+```powershell
+$body = '{ "properties": {
+"friendlyName": "friendlyName"
+} }'
+
+$parameters = @{
+    Method = 'Patch'
+    Path = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName?api-version=2022-02-10-preview"
+    Payload = $body
+}
+
+Invoke-AzRestMethod @parameters
+```
+
+>[!NOTE]
+>You can also set the friendly name by using a [REST API](/rest/api/desktopvirtualization/session-hosts/update?tabs=HTTP).
+
+### Get the session host friendly name
+
+To get the session host friendly name, run this command in PowerShell
+
+```powershell
+$getParams = @{
+  Path = '/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DesktopVirtualization/hostPools/$hostPoolName/sessionHosts/$($sessionHostName)?api-version=2022-02-10-preview'
+  Method = 'GET'
+}
+Invoke-AzRestMethod @getParams
+```
+
 ## Next steps
 
 Now that you've configured the personal desktop assignment type, you can sign in to an Azure Virtual Desktop client to test it as part of a user session. These articles will show you how to connect to a session using the client of your choice:

articles/virtual-desktop/create-host-pools-powershell.md

@@ -144,7 +144,7 @@ To successfully domain-join, do the following things on each virtual machine:
 
 ## Register the virtual machines to the Azure Virtual Desktop host pool
 
-Registering the virtual machines to a Azure Virtual Desktop host pool is as simple as installing the Azure Virtual Desktop agents.
+Registering the virtual machines to an Azure Virtual Desktop host pool is as simple as installing the Azure Virtual Desktop agents.
 
 To register the Azure Virtual Desktop agents, do the following on each virtual machine:
 
@@ -184,7 +184,6 @@ To update the agent:
 
 6. Once you've uninstalled these items, this should remove all associations with the old host pool. If you want to reregister this host to the service, follow the instructions in [Register the virtual machines to the Azure Virtual Desktop host pool](create-host-pools-powershell.md#register-the-virtual-machines-to-the-azure-virtual-desktop-host-pool).
 
-
 ## Next steps
 
 Now that you've made a host pool, you can populate it with RemoteApps. To learn more about how to manage apps in Azure Virtual Desktop, see the Manage app groups tutorial.