From 4d8cc115a573a43a9beefd148a8317edf3cc0fe2 Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Thu, 7 Nov 2024 07:38:35 -0500 Subject: [PATCH 1/4] updated refresh scenario --- windows/configuration/taskbar/pinned-apps.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/windows/configuration/taskbar/pinned-apps.md b/windows/configuration/taskbar/pinned-apps.md index b29c96b947..e8fa7b9652 100644 --- a/windows/configuration/taskbar/pinned-apps.md +++ b/windows/configuration/taskbar/pinned-apps.md @@ -50,8 +50,15 @@ The following steps describe how to configure the taskbar pinned applications us 1. Edit the XML file to meet your requirements and save it 1. Deploy the XML file to devices using configuration service provider (CSP), provisioning packages (PPKG), or group policy (GPO) -> [!IMPORTANT] -> If you use a provisioning package to configure the taskbar, your configuration will be reapplied each time the `explorer.exe` process restarts. If your configuration pins an app and the user then unpins that app, the user's change will be overwritten the next time the configuration is applied. To apply a taskbar configuration that allows users to make changes that will persist, apply your configuration by using CSP or GPO. +### Taskbar configuration and policy refresh + +Depending on the method you use to configure the taskbar, the configuration is reapplied at different intervals. When the taskbar configuration is reapplied, user changes are overwritten. + +| Configuration method | Reapplied interval | +|--|--| +| Configuration service provider (CSP) | Every 8 hours or based on the [ConfigRefresh](/windows/client-management/mdm/dmclient-csp#deviceproviderprovideridconfigrefresh) interval. | +| Provisioning package (PPKG) | Each time the `explorer.exe` process restarts. | +| Group policy (GPO) | In case of a group policy change. | > [!CAUTION] > The use of the `Import-StartLayout` PowerShell cmdlet to provision the Taskbar layout is no longer supported in Windows 11. The only supported configuration in Windows 11 is to use a provisioning package. From 8590a7a92a4269891f1e72482cc4d0352378d130 Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Thu, 7 Nov 2024 08:12:41 -0500 Subject: [PATCH 2/4] titles and descriptions updates --- windows/configuration/taskbar/index.md | 4 ++-- windows/configuration/taskbar/pinned-apps.md | 4 ++-- windows/configuration/taskbar/policy-settings.md | 6 +++--- windows/configuration/taskbar/xsd.md | 6 +++--- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git a/windows/configuration/taskbar/index.md b/windows/configuration/taskbar/index.md index 6ef2fe06f6..aefd8d2b6e 100644 --- a/windows/configuration/taskbar/index.md +++ b/windows/configuration/taskbar/index.md @@ -1,8 +1,8 @@ --- -title: Configure the Windows taskbar +title: Configure the Windows Taskbar Using Policy Settings description: Learn how to configure the Windows taskbar to provide quick access to the tools and applications that users need most. ms.topic: how-to -ms.date: 04/17/2024 +ms.date: 11/07/2024 ms.collection: - essentials-manage appliesto: diff --git a/windows/configuration/taskbar/pinned-apps.md b/windows/configuration/taskbar/pinned-apps.md index e8fa7b9652..fdc66cc942 100644 --- a/windows/configuration/taskbar/pinned-apps.md +++ b/windows/configuration/taskbar/pinned-apps.md @@ -1,8 +1,8 @@ --- -title: Configure the applications pinned to the taskbar +title: Configure the Windows Taskbar Pinned Apps with Policy Settings description: Learn how to configure the applications pinned to the Windows taskbar. ms.topic: how-to -ms.date: 04/17/2024 +ms.date: 11/07/2024 appliesto: zone_pivot_groups: windows-versions-11-10 --- diff --git a/windows/configuration/taskbar/policy-settings.md b/windows/configuration/taskbar/policy-settings.md index 72ca73538b..ed1b04da64 100644 --- a/windows/configuration/taskbar/policy-settings.md +++ b/windows/configuration/taskbar/policy-settings.md @@ -1,8 +1,8 @@ --- -title: Taskbar policy settings -description: Learn about the policy settings to configure the Windows taskbar. +title: List of the Policy Settings To Configure the Windows Taskbar +description: Learn about the CSP and GPO policy settings to configure the Windows taskbar. ms.topic: reference -ms.date: 04/17/2024 +ms.date: 11/07/2024 appliesto: zone_pivot_groups: windows-versions-11-10 --- diff --git a/windows/configuration/taskbar/xsd.md b/windows/configuration/taskbar/xsd.md index c6d5ded3aa..351c262871 100644 --- a/windows/configuration/taskbar/xsd.md +++ b/windows/configuration/taskbar/xsd.md @@ -1,8 +1,8 @@ --- -title: Taskbar XML Schema Definition (XSD) -description: Taskbar XSD reference article. +title: Windows Taskbar XML Schema Definition (XSD) +description: Reference article about the Taskbar XML schema definition (XSD). ms.topic: reference -ms.date: 02/15/2024 +ms.date: 11/07/2024 --- # Taskbar XML Schema Definition (XSD) From f12d62db3d0f621b1798672688346d9bc45cdec6 Mon Sep 17 00:00:00 2001 From: Paolo Matarazzo <74918781+paolomatarazzo@users.noreply.github.com> Date: Mon, 11 Nov 2024 07:33:45 -0500 Subject: [PATCH 3/4] update --- windows/configuration/taskbar/pinned-apps.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/windows/configuration/taskbar/pinned-apps.md b/windows/configuration/taskbar/pinned-apps.md index fdc66cc942..a86f85808a 100644 --- a/windows/configuration/taskbar/pinned-apps.md +++ b/windows/configuration/taskbar/pinned-apps.md @@ -61,7 +61,8 @@ Depending on the method you use to configure the taskbar, the configuration is r | Group policy (GPO) | In case of a group policy change. | > [!CAUTION] -> The use of the `Import-StartLayout` PowerShell cmdlet to provision the Taskbar layout is no longer supported in Windows 11. The only supported configuration in Windows 11 is to use a provisioning package. +> The use of the `Import-StartLayout` PowerShell cmdlet to provision the Taskbar layout is no longer supported in Windows 11. + ::: zone pivot="windows-10" >[!NOTE] From 207dcc175b89d097cd9d489a577daecb347ff186 Mon Sep 17 00:00:00 2001 From: Padma Jayaraman Date: Mon, 11 Nov 2024 18:26:01 +0530 Subject: [PATCH 4/4] Pencil edit Added missing periods --- windows/configuration/taskbar/pinned-apps.md | 48 ++++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/windows/configuration/taskbar/pinned-apps.md b/windows/configuration/taskbar/pinned-apps.md index a86f85808a..d2454b1e79 100644 --- a/windows/configuration/taskbar/pinned-apps.md +++ b/windows/configuration/taskbar/pinned-apps.md @@ -20,15 +20,15 @@ To learn about all the policy settings to customize the taskbar layout and confi Here are some considerations before you start configuring the taskbar pinned applications: -- There's no limit to the number of apps that you can pin -- In the XML file, add apps using the Application User Model ID (AUMID), the Desktop Application ID, or the Desktop Application Link Path -- Some classic Windows applications are packaged differently than they were in previous versions of Windows, including Notepad and File Explorer. Make sure to enter the correct Application ID. To learn more, see [Find the Application User Model ID of an installed app](../store/find-aumid.md) -- If you specify an app to be pinned that isn't provisioned for the user on the device, the pinned icon doesn't appear on the taskbar +- There's no limit to the number of apps that you can pin. +- In the XML file, add apps using the Application User Model ID (AUMID), the Desktop Application ID, or the Desktop Application Link Path. +- Some classic Windows applications are packaged differently than they were in previous versions of Windows, including Notepad and File Explorer. Make sure to enter the correct Application ID. To learn more, see [Find the Application User Model ID of an installed app](../store/find-aumid.md). +- If you specify an app to be pinned that isn't provisioned for the user on the device, the pinned icon doesn't appear on the taskbar. - The order of applications in the XML file dictates the order of pinned apps on the taskbar, from left to right. If the OS is configured to use a right-to-left language, then the taskbar order is reversed - Applications can be pinned using the following methods: - - Default Windows apps, pinned during the OS installation. For example: Microsoft Edge, File Explorer, and Store. These applications are pinned first (blue square) - - Pinned manually by the user. These applications are usually pinned next to the default pinned apps (red circle) - - Pinned via policy settings. These applications are pinned after the apps pinned manually by the user (green triangle) + - Default Windows apps, pinned during the OS installation. For example: Microsoft Edge, File Explorer, and Store. These applications are pinned first (blue square). + - Pinned manually by the user. These applications are usually pinned next to the default pinned apps (red circle). + - Pinned via policy settings. These applications are pinned after the apps pinned manually by the user (green triangle). ::: zone pivot="windows-10" @@ -46,9 +46,9 @@ Here are some considerations before you start configuring the taskbar pinned app The following steps describe how to configure the taskbar pinned applications using policy settings: -1. Create the XML file. You can start with the [XML example](#taskbar-layout-example) -1. Edit the XML file to meet your requirements and save it -1. Deploy the XML file to devices using configuration service provider (CSP), provisioning packages (PPKG), or group policy (GPO) +1. Create the XML file. You can start with the [XML example](#taskbar-layout-example). +1. Edit the XML file to meet your requirements and save it. +1. Deploy the XML file to devices using configuration service provider (CSP), provisioning packages (PPKG), or group policy (GPO). ### Taskbar configuration and policy refresh @@ -86,13 +86,13 @@ Here you can find an example of taskbar layout that you can use as a reference: You can change the apps pinned to the taskbar by modifying the `` node. 1. In the `` node, add (or remove) the apps you want pinned. You can pin Universal Windows Platform (UWP) apps and desktop apps: - - ``: Select this option for UWP apps. Add the *AUMID* of the UWP app - - ``: Select this option for desktop apps. Add the *Desktop Application ID* or the *Desktop Application Link Path* of the desktop app + - ``: Select this option for UWP apps. Add the *AUMID* of the UWP app. + - ``: Select this option for desktop apps. Add the *Desktop Application ID* or the *Desktop Application Link Path* of the desktop app. 1. In the `` node, the apps you add are pinned after the default apps. If you want to remove the default apps, and only show the apps you add in the XML file, then add `PinListPlacement="Replace"`: - - ``: Keeps the default pinned apps. After the default apps, the apps you add are pinned - - ``: Unpins the default apps. Only the apps you add are pinned. If you want to remove some of the default pinned apps, then add `PinListPlacement="Replace"`. When you add your apps to ``, include the default apps you still want pinned -1. In the `` node, use `region=" | "` to use different taskbar configurations based on the device locale and region -1. Save the file + - ``: Keeps the default pinned apps. After the default apps, the apps you add are pinned. + - ``: Unpins the default apps. Only the apps you add are pinned. If you want to remove some of the default pinned apps, then add `PinListPlacement="Replace"`. When you add your apps to ``, include the default apps you still want pinned. +1. In the `` node, use `region=" | "` to use different taskbar configurations based on the device locale and region. +1. Save the file. For practical examples of how to add, remove, or replace pinned apps, see the following sections: @@ -155,8 +155,8 @@ In the following XML example, two regions are added: `US|UK` and `DE|FR|IT`: [!INCLUDE [example](includes/example-region.md)] -- If the `` node has region matching the one configured on the device, then the configuration applies -- If the `` node doesn't have a region matching the one configured on the device, then the first `` node without region applies +- If the `` node has region matching the one configured on the device, then the configuration applies. +- If the `` node doesn't have a region matching the one configured on the device, then the first `` node without region applies. > [!NOTE] > [Look up country and region codes (use the ISO Short column)](/previous-versions/commerce-server/ee799297(v=cs.20)) @@ -220,15 +220,15 @@ After the taskbar layout is applied, the users must sign out and sign in again t On a clean install of Windows, if you apply a taskbar layout, the following apps are pinned to the taskbar: -- Any default apps you don't remove -- Apps that you specifically pin in the XML file +- Any default apps you don't remove. +- Apps that you specifically pin in the XML file. On a Windows OS upgrade, apps are already pinned to the taskbar. The taskbar layout applies the following logic: -- If users pinned apps to the taskbar, then those pinned apps remain. New apps are pinned after the existing user-pinned apps -- If the apps are pinned during the install or by a policy (not by a user), and the apps aren't pinned in an updated layout file, then the apps are unpinned -- If a user didn't pin an app, and the same app is pinned in the updated layout file, then the app is pinned after any existing pinned apps -- New apps in updated layout file are pinned after the user's pinned apps +- If users pinned apps to the taskbar, then those pinned apps remain. New apps are pinned after the existing user-pinned apps. +- If the apps are pinned during the install or by a policy (not by a user), and the apps aren't pinned in an updated layout file, then the apps are unpinned. +- If a user didn't pin an app, and the same app is pinned in the updated layout file, then the app is pinned after any existing pinned apps. +- New apps in updated layout file are pinned after the user's pinned apps. If you apply the taskbar configuration to a clean install or an update, users can still: