Merge pull request #215754 from dknappettmsft/avd-rd-clients-how-to-revamp

AVD RD clients how to revamp

Author: v-dirichards

.openpublishing.redirection.virtual-desktop.json

@@ -34,6 +34,46 @@
             "source_path": "articles/virtual-desktop/azure-stack-hci-faq.yml",
             "redirect_url": "/azure/virtual-desktop/azure-stack-hci",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-android.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-android-chrome-os",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-ios.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-ios-ipados",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-macos.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-macos",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-microsoft-store.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-microsoft-store",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-web.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-web",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/connect-windows-7-10.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-windows",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/index.yml",
+            "redirect_url": "/azure/virtual-desktop/users/",
+            "redirect_document_id": true
+        },
+        {
+            "source_path_from_root": "/articles/virtual-desktop/user-documentation/linux-overview.md",
+            "redirect_url": "/azure/virtual-desktop/users/connect-thin-clients",
+            "redirect_document_id": true
         }
     ]
 }

articles/virtual-desktop/TOC.yml

@@ -21,17 +21,17 @@
     - name: Remote Desktop clients
       items:
       - name: Windows (Desktop)
-        href: /windows-server/remote/remote-desktop-services/clients/windowsdesktop-whatsnew?context=/azure/virtual-desktop/context/context
+        href: /windows-server/remote/remote-desktop-services/clients/windowsdesktop-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
       - name: Windows (Microsoft Store)
-        href: /windows-server/remote/remote-desktop-services/clients/windows-whatsnew?context=/azure/virtual-desktop/context/context
+        href: /windows-server/remote/remote-desktop-services/clients/windows-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
       - name: macOS
-        href: /windows-server/remote/remote-desktop-services/clients/mac-whatsnew?context=/azure/virtual-desktop/context/context
-      - name: iOS
-        href: /windows-server/remote/remote-desktop-services/clients/ios-whatsnew?context=/azure/virtual-desktop/context/context
-      - name: Android
-        href: /windows-server/remote/remote-desktop-services/clients/android-whatsnew?context=/azure/virtual-desktop/context/context
+        href: /windows-server/remote/remote-desktop-services/clients/mac-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+      - name: iOS/iPadOS
+        href: /windows-server/remote/remote-desktop-services/clients/ios-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+      - name: Android/Chrome OS
+        href: /windows-server/remote/remote-desktop-services/clients/android-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
       - name: Web
-        href: /windows-server/remote/remote-desktop-services/clients/web-client-whatsnew?context=/azure/virtual-desktop/context/context
+        href: /windows-server/remote/remote-desktop-services/clients/web-client-whatsnew?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
   - name: Azure Virtual Desktop (classic) documentation
     href: ./virtual-desktop-fall-2019/tenant-setup-azure-active-directory.md
 - name: Quickstarts
@@ -60,13 +60,13 @@
   - name: Example architecture scenarios
     items:
     - name: Azure Virtual Desktop for the enterprise
-      href: /azure/architecture/example-scenario/wvd/windows-virtual-desktop?context=/azure/virtual-desktop/context/context
+      href: /azure/architecture/example-scenario/wvd/windows-virtual-desktop?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
     - name: Multiple identity sources
       items:
       - name: AD DS and Azure AD
-        href: /azure/architecture/example-scenario/wvd/multi-forest?context=/azure/virtual-desktop/context/context
+        href: /azure/architecture/example-scenario/wvd/multi-forest?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
       - name: AD DS, Azure AD, and Azure AD DS
-        href: /azure/architecture/example-scenario/wvd/multi-forest-azure-managed?context=/azure/virtual-desktop/context/context
+        href: /azure/architecture/example-scenario/wvd/multi-forest-azure-managed?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
   - name: Network connectivity
     items:
       - name: Understanding network connectivity
@@ -84,7 +84,7 @@
       - name: Determine user connection quality
         href: connection-latency.md
   - name: Virtual machine sizing guidance
-    href: /windows-server/remote/remote-desktop-services/virtual-machine-recs?context=/azure/virtual-desktop/context/context
+    href: /windows-server/remote/remote-desktop-services/virtual-machine-recs?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
   - name: Identity and access management
     items:
     - name: Identities and authentication
@@ -115,6 +115,12 @@
       items:
       - name: How the scaling tool works
         href: scaling-automation-logic-apps.md
+  - name: Remote Desktop clients
+    items: 
+    - name: Compare the clients
+      href: compare-remote-desktop-clients.md
+    - name: Supported RDP properties
+      href: rdp-properties.md
   - name: Azure Virtual Desktop FAQ
     href: faq.yml
   - name: Windows 10 Enterprise multi-session FAQ
@@ -159,26 +165,40 @@
         href: automatic-migration.md
       - name: Migrate manually
         href: manual-migration.md
-  - name: Connect to Azure Virtual Desktop resources
+  - name: Connect to Azure Virtual Desktop
     items:
+    - name: Windows Desktop client
+      href: ./users/connect-windows.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: Web client
+      href: ./users/connect-web.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: macOS client
+      href: ./users/connect-macos.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: iOS/iPadOS client
+      href: ./users/connect-ios-ipados.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: Android/Chrome OS client
+      href: ./users/connect-android-chrome-os.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: Windows Microsoft Store client
+      href: ./users/connect-microsoft-store.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+    - name: Thin clients
+      href: ./users/connect-thin-clients.md?toc=%2Fazure%2Fvirtual-desktop%2Ftoc.json&bc=%2Fazure%2Fvirtual-desktop%2Fbreadcrumb%2Ftoc.json
+  - name: Remote Desktop clients
+    items: 
+    - name: Use client features
+      items:
       - name: Windows Desktop client
-        href: ./user-documentation/connect-windows-7-10.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: Microsoft Store client
-        href: ./user-documentation/connect-microsoft-store.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: macOS client
-        href: ./user-documentation/connect-macos.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
+        href: ./users/client-features-windows.md
       - name: Web client
-        href: ./user-documentation/connect-web.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: iOS client
-        href: ./user-documentation/connect-ios.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: Android client
-        href: ./user-documentation/connect-android.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: Thin clients
-        href: ./user-documentation/linux-overview.md?toc=/azure/virtual-desktop/toc.json&bc=/azure/virtual-desktop/breadcrumb/toc.json
-      - name: Configure device redirections
-        href: configure-device-redirections.md
-      - name: Supported RDP file settings
-        href: /windows-server/remote/remote-desktop-services/clients/rdp-files?context=/azure/virtual-desktop/context/context
+        href: ./users/client-features-web.md
+      - name: macOS client
+        href: ./users/client-features-macos.md
+      - name: iOS/iPadOS client
+        href: ./users/client-features-ios-ipados.md
+      - name: Android/Chrome OS client
+        href: ./users/client-features-android-chrome-os.md
+      - name: Windows Microsoft Store client
+        href: ./users/client-features-microsoft-store.md
+    - name: Configure device redirections
+      href: configure-device-redirections.md
   - name: Set up the PowerShell module
     href: powershell-module.md
   - name: Create a host pool and session hosts

articles/virtual-desktop/authentication.md

@@ -107,7 +107,7 @@ Once you're connected to your remote app or desktop, you may be prompted for aut
 > This preview version is provided without a service level agreement, and is not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
-Azure Virtual Desktop supports in-session passwordless authentication (preview) using [Windows Hello for Business](/windows/security/identity-protection/hello-for-business/hello-overview) or security devices like FIDO keys when using the [Windows Desktop client](user-documentation/connect-windows-7-10.md). Passwordless authentication is enabled automatically when the session host and local PC are using the following operating systems:
+Azure Virtual Desktop supports in-session passwordless authentication (preview) using [Windows Hello for Business](/windows/security/identity-protection/hello-for-business/hello-overview) or security devices like FIDO keys when using the [Windows Desktop client](users/connect-windows.md). Passwordless authentication is enabled automatically when the session host and local PC are using the following operating systems:
 
   - Windows 11 Enterprise single or multi-session with the [2022-09 Cumulative Updates for Windows 11 Preview (KB5017383)](https://support.microsoft.com/kb/KB5017383) or later installed.
   - Windows 10 Enterprise single or multi-session, versions 20H2 or later with the [2022-09 Cumulative Updates for Windows 10 Preview (KB5017380)](https://support.microsoft.com/kb/KB5017380) or later installed.

articles/virtual-desktop/compare-remote-desktop-clients.md

@@ -0,0 +1,76 @@
+---
+title: Compare the features of the Remote Desktop clients for Azure Virtual Desktop - Azure Virtual Desktop
+description: Compare the features of the Remote Desktop clients when connecting to Azure Virtual Desktop.
+author: dknappettmsft
+ms.topic: conceptual
+ms.date: 09/26/2022
+ms.author: daknappe
+---
+
+# Compare the features of the Remote Desktop clients when connecting to Azure Virtual Desktop
+
+There are some differences between the features of each of the Remote Desktop clients when connecting to Azure Virtual Desktop. Below you can find information about what these differences are.
+
+> [!TIP]
+> Some clients and features differ when using Azure Virtual Desktop to using Remote Desktop Services. If you want to see the clients and features for Remote Desktop Services, see [Compare the clients: features](/windows-server/remote/remote-desktop-services/clients/remote-desktop-features) and [Compare the clients: redirections](/windows-server/remote/remote-desktop-services/clients/remote-desktop-app-compare).
+
+## Features comparison
+
+The following table compares the features of each Remote Desktop client when connecting to Azure Virtual Desktop.
+
+| Feature | Windows Desktop | Microsoft Store | Android or Chrome OS | iOS or iPadOS | macOS | Web | Description |
+|--|--|--|--|--|--|--|--|
+| Remote Desktop sessions | X | X | X | X | X | X | Desktop of a remote computer presented in a full screen or windowed mode. |
+| Integrated RemoteApp sessions | X |  |  |  | X |  | Individual remote apps integrated into the local desktop as if they are running locally. |
+| Immersive RemoteApp sessions |  | X | X | X |  | X | Individual remote apps presented in a window or maximized to a full screen. |
+| Multiple monitors | 16 monitor limit |  |  |  | 16 monitor limit |  | Lets the user run Remote Desktop or remote apps on all local monitors.<br /><br />Each monitor can have a maximum resolution of 8K, with the total resolution limited to 32K. These limits depend on factors such as session host specification and network connectivity. |
+| Dynamic resolution | X | X |  |  | X | X | Resolution and orientation of local monitors is dynamically reflected in the remote session. If the client is running in windowed mode, the remote desktop is resized dynamically to the size of the client window. |
+| Smart sizing | X | X |  |  | X |  | Remote Desktop in Windowed mode is dynamically scaled to the window's size. |
+| Localization | X | X | English only | X |  | X | Client user interface is available in multiple languages. |
+| Multi-factor authentication | X | X | X | X | X | X | Supports multi-factor authentication for remote connections. |
+| Teams optimization for Azure Virtual Desktop | X |  |  |  | X |  | Media optimizations for Microsoft Teams to provide high quality calls and screen sharing experiences. Learn more at [Use Microsoft Teams on Azure Virtual Desktop](/azure/virtual-desktop/teams-on-avd). |
+
+## Redirections comparison
+
+The following tables compare support for device and other redirections across the different Remote Desktop clients when connecting to Azure Virtual Desktop. Organizations can configure redirections centrally through Azure Virtual Desktop RDP properties or Group Policy.
+
+> [!IMPORTANT]
+> You can only enable redirections with binary settings that apply to both to and from the remote machine. One-way blocking of redirections from only one side of the connection is not supported.
+
+### Input redirection
+
+| Input | Windows Desktop | Microsoft Store client | Android or Chrome OS | iOS or iPadOS | macOS | Web client |
+|--|--|--|--|--|--|--|
+| Keyboard | X | X | X | X | X | X |
+| Mouse | X | X | X | X | X | X |
+| Touch | X | X | X | X |  | X |
+| Pen | X |  | X (as touch) | X (as touch) |  |  |
+
+### Port redirection
+
+| Redirection | Windows Desktop | Microsoft Store client | Android or Chrome OS | iOS or iPadOS | macOS | Web client |
+|--|--|--|--|--|--|--|
+| Serial port | X |  |  |  |  |  |
+| USB | X |  |  |  |  |  |
+
+When you enable USB port redirection, all USB devices attached to USB ports are automatically recognized in the remote session. For devices to work as expected, you must make sure to install their required drivers on both the local device and session host. You will need to make sure the drivers are certified to run in remote scenarios. If you need more information about using your USB device in remote scenarios, talk to the device manufacturer.
+
+### Other redirection (devices, etc.)
+
+| Redirection | Windows Desktop | Microsoft Store client | Android or Chrome OS | iOS or iPadOS | macOS | Web client |
+|--|--|--|--|--|--|--|
+| Cameras | X |  |  | X | X |  |
+| Clipboard | X | X | Text | Text, images | X | Text |
+| Local drive/storage | X |  | X | X | X | X\* |
+| Location | X |  |  |  |  |  |
+| Microphones | X | X | X | X | X | X |
+| Printers | X |  |  |  | X\*\* (CUPS only) | PDF print |
+| Scanners | X |  |  |  |  |  |
+| Smart cards | X |  |  |  | X (Windows sign-in not supported) |  |
+| Speakers | X | X | X | X | X | X |
+| Third-party virtual channel plugins | X |  |  |  |  |  |
+| WebAuthn | X |  |  |  |  |  |
+
+\* Limited to uploading and downloading files through the Remote Desktop Web client.
+
+\*\* For printer redirection, the macOS app supports the Publisher Imagesetter printer driver by default. The app doesn't support the native printer drivers.

articles/virtual-desktop/configure-adfs-sso.md

@@ -35,8 +35,8 @@ Before configuring AD FS single sign-on, you must have the following setup runni
 
 The following Azure Virtual Desktop clients support this feature:
 
-* [Windows Desktop client](./user-documentation/connect-windows-7-10.md)
-* [Web client](./user-documentation/connect-web.md)
+* [Windows Desktop client](./users/connect-windows.md)
+* [Web client](./users/connect-web.md)
 
 ## Configure the certificate authority to issue certificates
 
@@ -275,5 +275,5 @@ UnConfigureWVDSSO.ps1 -WvdWebAppAppIDUri "<WVD Web App URI>" -WvdClientAppApplic
 
 Now that you've configured single sign-on, you can sign in to a supported Azure Virtual Desktop client to test it as part of a user session. If you want to learn how to connect to a session using your new credentials, check out these articles:
 
-* [Connect with the Windows Desktop client](./user-documentation/connect-windows-7-10.md)
-* [Connect with the web client](./user-documentation/connect-web.md)
+* [Connect with the Windows Desktop client](./users/connect-windows.md)
+* [Connect with the web client](./users/connect-web.md)

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

@@ -152,8 +152,8 @@ To reassign a personal desktop in the Azure portal:
 
 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:
 
-- [Connect with the Windows Desktop client](./user-documentation/connect-windows-7-10.md)
-- [Connect with the web client](./user-documentation/connect-web.md)
-- [Connect with the Android client](./user-documentation/connect-android.md)
-- [Connect with the iOS client](./user-documentation/connect-ios.md)
-- [Connect with the macOS client](./user-documentation/connect-macos.md)
+- [Connect with the Windows Desktop client](./users/connect-windows.md)
+- [Connect with the web client](./users/connect-web.md)
+- [Connect with the Android client](./users/connect-android-chrome-os.md)
+- [Connect with the iOS client](./users/connect-ios-ipados.md)
+- [Connect with the macOS client](./users/connect-macos.md)