From 53a2904964fe716297d5c3db14e75e05d48b13d0 Mon Sep 17 00:00:00 2001 From: "Nicholas S. White" <104782157+nicholasswhite@users.noreply.github.com> Date: Thu, 19 Dec 2024 16:13:23 -0500 Subject: [PATCH 1/5] Add documentation for deploying New Outlook for Windows on Virtualized Desktop Infrastructure (VDI) --- .../virtualized-desktop-infrastructure.md | 133 ++++++++++++++++++ microsoft-365-apps/outlook/toc.yml | 2 + 2 files changed, 135 insertions(+) create mode 100644 microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md diff --git a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md new file mode 100644 index 000000000..81ce95f8a --- /dev/null +++ b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md @@ -0,0 +1,133 @@ +--- +title: New Outlook for Windows for virtualized desktop infrastructure (VDI) +ms.author: cpiranidesou +author: cpsou +manager: jhollander +audience: ITPro +ms.topic: overview +ms.service: outlook +ms.collection: +- Tier3 +- virtualized-desktop-infrastructure.md +ms.localizationpriority: medium +ms.custom: intro-overview +recommendations: true +description: "Provides an overview of the new Outlook for Windows for VDI" +ms.date: 12/23/2024 +--- + +# Deploy the New Outlook for Windows on Virtualized Desktop Infrastructure + +This article outlines the requirements, limitations, and deployment guidance for using the new Outlook for Windows in virtualized desktop infrastructure environments. + +## Requirements + +| Requirement | Version | +|----------------|----------------------------------------------------------------------------------------------| +| **Windows** | - Windows 10.0.17763.0 (1809) or later
- Windows Server 2022 (20348.2402) or later | +| **WebView2** | Update to the latest version. For more information, see [Enterprise management of WebView2 Runtimes](/microsoft-edge/webview2/concepts/enterprise). | +| **.NET Framework** | 4.7.2 or later | + +To avoid startup issues, add these processes to the exclusion list in your antivirus software: +- `olk.exe` +- `olkPushNotificationBackgroundTask.exe` +- `xpdAgent.exe` +- `relaunchNativeHost.exe` + +Alternatively, add these processes to the allowlist in your data loss prevention (DLP) software. For specific instructions, contact your DLP software provider. + +## Virtualization Provider Requirements + +The following sections outline the requirements for virtualization providers that support the new Outlook for Windows. + +### Azure Virtual Desktop and Windows 365 + +The following minimum versions are required for the new Outlook for Windows: +- Remote Desktop Client for Windows: 1.2.2606 +- Remote Desktop Client for Mac: 10.7.7 + +### Citrix Virtual Apps and Desktops and Citrix DaaS Requirements + +The following sections describe the requirements for Citrix Workspace App and Citrix Virtual Delivery Agent (VDA) to support the new Outlook for Windows. + +#### Citrix Workspace App +- Windows 2203 LTSR (and any CU) +- Windows 2302 CR + +#### Citrix Virtual Delivery Agent (VDA) +- 2203 LTSR (and any CU) +- 2212 CR +- 1912 CU6 (latest CU recommended; note that App Sharing is not supported on 1912) + +### VMware Horizon and Workspace ONE Requirements + +The following minimum version is required for the new Outlook for Windows: +- Horizon 8 2111 ESB (8.4) + +## Deploy the New Outlook for Windows + +> [!NOTE] +> The new Outlook for Windows is installed as part of Windows, starting with Windows 11, version 24H2. + +To deploy the new Outlook for Windows: +1. Download the `.exe` installer. +2. Use a distribution method such as Intune, Microsoft Endpoint Configuration Manager, Group Policy, or a non-Microsoft tool to distribute the installer. +3. Run the installer on each computer. + +For detailed instructions, see [Deploy New Outlook](/microsoft-365-apps/outlook/get-started/deployment-new-outlook). + +> [!NOTE] +> If **AllowAllTrustedApps** is disabled, the new Outlook app installation fails. This issue was fixed in the October cumulative update KB5031455 for [Windows 11](https://support.microsoft.com/topic/october-31-2023-kb5031455-os-builds-22621-2506-and-22631-2506-preview-6513c5ec-c5a2-4aaf-97f5-44c13d29e0d4) and [Windows 10](https://support.microsoft.com/topic/october-26-2023-kb5031445-os-build-19045-3636-preview-03f350cb-57f9-45e6-bfd7-438895d3c7fa). If this update is unavailable, the November security update includes the fix. + +## Disk Footprint – Key Folders and Location + +> [!IMPORTANT] +> For non-persistent VDI environments, [FSLogix](/fslogix/overview-what-is-fslogix) does not support roaming user data in the new Outlook for Windows. + +### Install Location + +The MSIX installer installs the new Outlook app in the WindowsApps folder. This location provides enhanced protection against attacks that attempt to alter the Outlook app installation. + +The folder name where the new Outlook app is installed changes with each version update. It starts with **_Microsoft.OutlookForWindows__**, ends with **__8wekyb3d8bbwe_**, and includes the version number and machine architecture. For example: **_Microsoft.OutlookForWindows_1.2024.717.400_x64_8wekyb3d8bbwe_**. + +To find the current version's install location, run the following PowerShell command: +```powershell +(get-appxpackage Microsoft.OutlookForWindows).InstallLocation +``` + +> [!NOTE] +> The MSIX installer and all files in the directory are signed with a Microsoft certificate. + +### Profile and Cache Locations for the New Outlook for Windows + +All user settings and configurations are stored in: + +- `C:\Users\\AppData\Local\Packages\Microsoft.OutlookForWindows_8wekyb3d8bbwe\` +- `C:\Users\\AppData\Local\Microsoft\olk\` + +## Folder Exclusions for Roaming + +> [!IMPORTANT] +> For non-persistent VDI environments, [FSLogix](/fslogix/overview-what-is-fslogix) does not support roaming user data in the new Outlook for Windows. + +### Recommended for Exclusion + +| **Folder** | **Folder Path** | **Purpose** | **Exclusion Impact** | +|-----------------------------|--------------------------------------------------------------------------------------|------------------------------------------|-----------------------| +| Logs and Telemetry Cache | `%LocalAppData%/Microsoft/olk/logs`
`%LocalAppData%/Microsoft/olk/cache` | Diagnostics and performance logs. | No effect. | +| WebStorage | `%LocalAppData%/Microsoft/olk/EbWebView/default/WebStorage` | Cache for web app usage in iframes. | Slower app reload. | + +### Considerations for Exclusion + +| **Folder** | **Folder Path** | **Purpose** | **Exclusion Impact** | +|-----------------------------|--------------------------------------------------------------------------------------|------------------------------------------|-----------------------| +| Service Worker | `%LocalAppData%/Microsoft/olk/EBWebView/default/Service Worker/CacheStorage`
`%LocalAppData%/Microsoft/olk/EBWebView/default/Code Cache` | Stores cached web/JS scripts. | Slower app launches due to redownload of scripts. | +| IndexedDB and Local Storage | `%LocalAppData%/Microsoft/olk/EBWebView/default/IndexedDB`
`%LocalAppData%\Microsoft\olk\EBWebView\Default\Local Storage`
`%LocalAppData%/Microsoft/olk/Attachments` | Stores user and app data. | Increased app launch time and repeated sign-ins. | +| Cache | `%LocalAppData%/Microsoft/olk/EBWebView/default/Cache` | Caches network call contents. | Resources need to be redownloaded. | + +Other than the folders in this section, avoid excluding extra directories. + +## Related articles + +- [Troubleshoot deployment issues in New Outlook](/microsoft-365-apps/outlook/troubleshoot/troubleshoot-deployment-new-outlook?tabs=windows11) +- [Manage Updates in New Outlook for Windows](/microsoft-365-apps/outlook/manage/manage-updates-new-outlook-windows) diff --git a/microsoft-365-apps/outlook/toc.yml b/microsoft-365-apps/outlook/toc.yml index 2dcfc476d..f07119125 100644 --- a/microsoft-365-apps/outlook/toc.yml +++ b/microsoft-365-apps/outlook/toc.yml @@ -14,6 +14,8 @@ items: href: get-started/deployment-new-outlook.md - name: Control new Outlook installation href: get-started/control-install.md + - name: Virtualized desktop infrastructure (VDI) + href: get-started/virtualized-desktop-infrastructure.md - name: COM add-ins items: - name: Identify COM add-ins in your organization From 8d24005290cad6adc01dda0b972986d8b7596b6d Mon Sep 17 00:00:00 2001 From: "Nicholas S. White" <104782157+nicholasswhite@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:06:59 -0500 Subject: [PATCH 2/5] Clarity. --- .../get-started/virtualized-desktop-infrastructure.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md index 81ce95f8a..8b8a5b10a 100644 --- a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md +++ b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md @@ -28,6 +28,9 @@ This article outlines the requirements, limitations, and deployment guidance for | **WebView2** | Update to the latest version. For more information, see [Enterprise management of WebView2 Runtimes](/microsoft-edge/webview2/concepts/enterprise). | | **.NET Framework** | 4.7.2 or later | +> [!NOTE] +> Windows Server 2019 and Windows Server 2016 are not supported. + To avoid startup issues, add these processes to the exclusion list in your antivirus software: - `olk.exe` - `olkPushNotificationBackgroundTask.exe` @@ -79,6 +82,8 @@ For detailed instructions, see [Deploy New Outlook](/microsoft-365-apps/outlook/ > [!NOTE] > If **AllowAllTrustedApps** is disabled, the new Outlook app installation fails. This issue was fixed in the October cumulative update KB5031455 for [Windows 11](https://support.microsoft.com/topic/october-31-2023-kb5031455-os-builds-22621-2506-and-22631-2506-preview-6513c5ec-c5a2-4aaf-97f5-44c13d29e0d4) and [Windows 10](https://support.microsoft.com/topic/october-26-2023-kb5031445-os-build-19045-3636-preview-03f350cb-57f9-45e6-bfd7-438895d3c7fa). If this update is unavailable, the November security update includes the fix. +For more information, see [Installation issues due to policy restrictions](/outlook/troubleshoot/troubleshoot-deployment-new-outlook.md#installation-issues-due-to-policy-restrictions) + ## Disk Footprint – Key Folders and Location > [!IMPORTANT] From cf376232ce5ec88e1c3b2074a11749e1365bfff6 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 21 Dec 2024 02:27:28 +0530 Subject: [PATCH 3/5] Update link --- .../outlook/get-started/virtualized-desktop-infrastructure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md index 8b8a5b10a..ab77e381f 100644 --- a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md +++ b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md @@ -82,7 +82,7 @@ For detailed instructions, see [Deploy New Outlook](/microsoft-365-apps/outlook/ > [!NOTE] > If **AllowAllTrustedApps** is disabled, the new Outlook app installation fails. This issue was fixed in the October cumulative update KB5031455 for [Windows 11](https://support.microsoft.com/topic/october-31-2023-kb5031455-os-builds-22621-2506-and-22631-2506-preview-6513c5ec-c5a2-4aaf-97f5-44c13d29e0d4) and [Windows 10](https://support.microsoft.com/topic/october-26-2023-kb5031445-os-build-19045-3636-preview-03f350cb-57f9-45e6-bfd7-438895d3c7fa). If this update is unavailable, the November security update includes the fix. -For more information, see [Installation issues due to policy restrictions](/outlook/troubleshoot/troubleshoot-deployment-new-outlook.md#installation-issues-due-to-policy-restrictions) +For more information, see [Installation issues due to policy restrictions](https://learn.microsoft.com/microsoft-365-apps/outlook/troubleshoot/troubleshoot-deployment-new-outlook#installation-issues-due-to-policy-restrictions). ## Disk Footprint – Key Folders and Location From 8898b6e57c482ad1228a6474bfcf10f2e87fd90e Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 21 Dec 2024 02:40:50 +0530 Subject: [PATCH 4/5] pencil edit --- .../outlook/get-started/virtualized-desktop-infrastructure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md index ab77e381f..d5e2a55b9 100644 --- a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md +++ b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md @@ -82,7 +82,7 @@ For detailed instructions, see [Deploy New Outlook](/microsoft-365-apps/outlook/ > [!NOTE] > If **AllowAllTrustedApps** is disabled, the new Outlook app installation fails. This issue was fixed in the October cumulative update KB5031455 for [Windows 11](https://support.microsoft.com/topic/october-31-2023-kb5031455-os-builds-22621-2506-and-22631-2506-preview-6513c5ec-c5a2-4aaf-97f5-44c13d29e0d4) and [Windows 10](https://support.microsoft.com/topic/october-26-2023-kb5031445-os-build-19045-3636-preview-03f350cb-57f9-45e6-bfd7-438895d3c7fa). If this update is unavailable, the November security update includes the fix. -For more information, see [Installation issues due to policy restrictions](https://learn.microsoft.com/microsoft-365-apps/outlook/troubleshoot/troubleshoot-deployment-new-outlook#installation-issues-due-to-policy-restrictions). +For more information, see [Installation issues due to policy restrictions](/outlook/troubleshoot/troubleshoot-deployment-new-outlook.md#installation-issues-due-to-policy-restrictions). ## Disk Footprint – Key Folders and Location From 5057fa4efba88a6a0d43a5b26388d6978f70125b Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 21 Dec 2024 02:43:32 +0530 Subject: [PATCH 5/5] pencil edit --- .../outlook/get-started/virtualized-desktop-infrastructure.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md index d5e2a55b9..ab77e381f 100644 --- a/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md +++ b/microsoft-365-apps/outlook/get-started/virtualized-desktop-infrastructure.md @@ -82,7 +82,7 @@ For detailed instructions, see [Deploy New Outlook](/microsoft-365-apps/outlook/ > [!NOTE] > If **AllowAllTrustedApps** is disabled, the new Outlook app installation fails. This issue was fixed in the October cumulative update KB5031455 for [Windows 11](https://support.microsoft.com/topic/october-31-2023-kb5031455-os-builds-22621-2506-and-22631-2506-preview-6513c5ec-c5a2-4aaf-97f5-44c13d29e0d4) and [Windows 10](https://support.microsoft.com/topic/october-26-2023-kb5031445-os-build-19045-3636-preview-03f350cb-57f9-45e6-bfd7-438895d3c7fa). If this update is unavailable, the November security update includes the fix. -For more information, see [Installation issues due to policy restrictions](/outlook/troubleshoot/troubleshoot-deployment-new-outlook.md#installation-issues-due-to-policy-restrictions). +For more information, see [Installation issues due to policy restrictions](https://learn.microsoft.com/microsoft-365-apps/outlook/troubleshoot/troubleshoot-deployment-new-outlook#installation-issues-due-to-policy-restrictions). ## Disk Footprint – Key Folders and Location