Merge pull request #250105 from dknappettmsft/avd-msrdc-per-user-guid

AVD install MSRDC per-user update method

Author: v-dirichards

.openpublishing.redirection.virtual-desktop.json

@@ -199,6 +199,11 @@
             "source_path_from_root": "/articles/virtual-desktop/windows-10-multisession-faq.yml",
             "redirect_url": "/azure/virtual-desktop/windows-multisession-faq",
             "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/install-client-per-user.md",
+            "redirect_url": "/azure/virtual-desktop/install-windows-client-per-user",
+            "redirect_document_id": true
         }
     ]
 }

articles/virtual-desktop/TOC.yml

@@ -511,8 +511,8 @@
       - name: Configure device redirections
         href: configure-device-redirections.md
       - name: Install the Remote Desktop client for Windows on a per-user basis
-        displayName: apps, clients, remote desktop, rdp, connect, intune, configuration maneger, configmgr, sccm
-        href: install-client-per-user.md
+        displayName: apps, clients, remote desktop, rdp, connect, intune, configuration manager, configmgr, sccm, mem, mdm, per user
+        href: install-windows-client-per-user.md
     - name: Set up email discovery
       displayName: connect
       href: /windows-server/remote/remote-desktop-services/rds-email-discovery?context=/azure/virtual-desktop/context/context

articles/virtual-desktop/install-client-per-user.md

@@ -0,0 +1,109 @@
+---
+title: Install the Remote Desktop client for Windows on a per-user basis with Intune or Configuration Manager - Azure
+description: How to install the Azure Virtual Desktop client on a per-user basis with Intune or Configuration Manager.
+author: dknappettmsft
+ms.topic: how-to
+ms.date: 09/01/2023
+ms.author: daknappe
+---
+
+# Install the Remote Desktop client for Windows on a per-user basis with Intune or Configuration Manager
+
+You can install the [Remote Desktop client for Windows](./users/connect-windows.md) on either a per-system or per-user basis. Installing it on a per-system basis installs the client on the machines for all users by default, and administrators control updates. Per-user installation installs the application to a subfolder within the local AppData folder of each user's profile, enabling users to install updates with needing administrative rights.
+
+When you install the client using `msiexec.exe`, per-system is the default method of client installation. You can use the parameters `ALLUSERS=2 MSIINSTALLPERUSER=1` with msiexec to install the client per-user, however, if you're deploying the client with Intune or Configuration Manager, using msiexec directly to install causes the client to be installed per-system, regardless of the parameters used. Wrapping the msiexec command in a PowerShell script enables the client to be successfully installed per-user.
+
+## Prerequisites
+
+In order to install the Remote Desktop client for Windows on a per-user basis with Intune or Configuration Manager, you need the following things:
+
+- Devices managed by Microsoft Intune or Configuration Manager with permission to add applications.
+
+- Download the latest version of [the Remote Desktop client for Windows](./users/connect-windows.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json).
+
+- For Intune, you need a local Windows device to use the [Microsoft Win32 Content Prep Tool](https://github.com/Microsoft/Microsoft-Win32-Content-Prep-Tool).
+
+## Install the Remote Desktop client per-user using a PowerShell script
+
+To install the client on a per-user basis using a PowerShell script, select the relevant tab for your scenario and follow the steps.
+
+#### [Intune](#tab/intune)
+
+Here's how to install the client on a per-user basis using a PowerShell script with Intune as a *Windows app (Win32)*.
+
+1. Create a new folder on your local Windows device and add the Remote Desktop client MSI file you downloaded.
+
+1. Within that folder, create a PowerShell script file called `Install.ps1` and add the following content, replacing `<RemoteDesktop>` with the filename of the `.msi` file you downloaded:
+
+   ```powershell
+   msiexec /i <RemoteDesktop>.msi /qn ALLUSERS=2 MSIINSTALLPERUSER=1
+   ```
+
+1. In the same folder, create a PowerShell script file called `Uninstall.ps1` and add the following content:
+
+   ```powershell
+   $productCode = (Get-WmiObject -Class Win32_Product | Where-Object {$_.Name -eq 'Remote Desktop' -and $_.Vendor -eq 'Microsoft Corporation'}).IdentifyingNumber
+
+   msiexec /x $productCode /qn
+   ```
+
+1. Follow the steps in [Prepare Win32 app content for upload](/mem/intune/apps/apps-win32-prepare) to package the contents of the folder into an `.intunewin` file.
+
+1. Follow the steps in [Add, assign, and monitor a Win32 app in Microsoft Intune](/mem/intune/apps/apps-win32-add) to add the Remote Desktop client. You need to specify the following information during the process:
+
+   | Parameter | Value/Description |
+   |--|--|
+   | Install command | `powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File .\Install.ps1` |
+   | Uninstall command | `powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File .\Uninstall.ps1` |
+   | Install behavior | Select **User**. |
+   | Operating system architecture | Select **64-bit**. |
+   | Detection rules format | Select **Manually configure detection rules**. |
+   | Detection rule type | Select **File**. |
+   | Detection rule path | `%LOCALAPPDATA%\Programs\Remote Desktop\` |
+   | Detection rule file or folder | `msrdc.exe` |
+   | Detection method | Select **File or folder exists**. |
+   | Assignments | Assign to users you want to use the Remote Desktop client. |
+
+#### [Configuration Manager](#tab/configmgr)
+
+Here's how to install the client on a per-user basis using a PowerShell script with Configuration Manager as a *Script Installer*.
+
+1. Create a new folder in your content location share for Configuration Manager and add the Remote Desktop client MSI file you downloaded.
+
+1. Within that folder, create a PowerShell script file called `Install.ps1` and add the following content, replacing `<RemoteDesktop>` with the filename of the `.msi` file you downloaded:
+
+   ```powershell
+   msiexec /i <RemoteDesktop>.msi /qn ALLUSERS=2 MSIINSTALLPERUSER=1
+   ```
+
+1. In the same folder, create a PowerShell script file called `Uninstall.ps1` and add the following content:
+
+   ```powershell
+   $productCode = (Get-WmiObject -Class Win32_Product | Where-Object {$_.Name -eq 'Remote Desktop' -and $_.Vendor -eq 'Microsoft Corporation'}).IdentifyingNumber
+
+   msiexec /x $productCode /qn
+   ```
+
+1. Follow the steps in [Create applications in Configuration Manager](/mem/configmgr/apps/deploy-use/create-applications) and [manually specify application information](/mem/configmgr/apps/deploy-use/create-applications#bkmk_manual-app) to add the Remote Desktop client. You need to specify the following information during the process:
+
+   | Parameter | Value/Description |
+   |--|--|
+   | Deployment type | Select **Script Installer**. |
+   | Content location | Enter the UNC path to the new folder you created. |
+   | Installation program | `powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File .\Install.ps1` |
+   | Uninstall program | `powershell.exe -ExecutionPolicy Bypass -WindowStyle Hidden -File .\Uninstall.ps1` |
+   | Detection method | Select **Configure rules to detect the presence of this deployment type**. |
+   | Detection rule setting type | Select **File System**. |
+   | Detection rule type | Select **File**. |
+   | Detection rule path | `%LOCALAPPDATA%\Programs\Remote Desktop\` |   
+   | Detection rule file or folder name | `msrdc.exe` |
+   | Detection rule criteria | Select **The file system setting must exist on the target system to indicate presence of this application**. |
+   | Installation behavior | Select **Install for user**. |
+
+1. Follow the steps in [Deploy applications with Configuration Manager](/mem/configmgr/apps/deploy-use/deploy-applications) to deploy the Remote Desktop client to your users.
+
+---
+
+## Next steps
+
+Learn more about the Remote Desktop client at [Use features of the Remote Desktop client for Windows](./users/client-features-windows.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json).