Merge pull request #10390 from MicrosoftDocs/main

Publish main to live, Monday 10:30AM PST, 11/11

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:

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
 ---
@@ -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,15 +46,23 @@ 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).
 
-> [!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.
+> 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]
@@ -78,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 `<TaskbarLayout>` node.
 
 1. In the `<taskbar:TaskbarPinList>` node, add (or remove) the apps you want pinned. You can pin Universal Windows Platform (UWP) apps and desktop apps:
-    - `<taskbar:UWA>`: Select this option for UWP apps. Add the *AUMID* of the UWP app
-    - `<taskbar:DesktopApp>`: Select this option for desktop apps. Add the *Desktop Application ID* or the *Desktop Application Link Path* of the desktop app
+    - `<taskbar:UWA>`: Select this option for UWP apps. Add the *AUMID* of the UWP app.
+    - `<taskbar:DesktopApp>`: Select this option for desktop apps. Add the *Desktop Application ID* or the *Desktop Application Link Path* of the desktop app.
 1. In the `<CustomTaskbarLayoutCollection>` 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"`:
-    - `<CustomTaskbarLayoutCollection>`: Keeps the default pinned apps. After the default apps, the apps you add are pinned
-    - `<CustomTaskbarLayoutCollection PinListPlacement="Replace">`: 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 `<taskbar:TaskbarPinList>`, include the default apps you still want pinned
-1. In the `<defaultlayout:TaskbarLayout>` node, use `region=" | "` to use different taskbar configurations based on the device locale and region
-1. Save the file
+    - `<CustomTaskbarLayoutCollection>`: Keeps the default pinned apps. After the default apps, the apps you add are pinned.
+    - `<CustomTaskbarLayoutCollection PinListPlacement="Replace">`: 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 `<taskbar:TaskbarPinList>`, include the default apps you still want pinned.
+1. In the `<defaultlayout:TaskbarLayout>` 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:
 
@@ -147,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 `<TaskbarPinList>` node has region matching the one configured on the device, then the configuration applies
-- If the `<TaskbarPinList>` node doesn't have a region matching the one configured on the device, then the first `<TaskbarPinList>` node without region applies
+- If the `<TaskbarPinList>` node has region matching the one configured on the device, then the configuration applies.
+- If the `<TaskbarPinList>` node doesn't have a region matching the one configured on the device, then the first `<TaskbarPinList>` node without region applies.
 
 > [!NOTE]
 > [Look up country and region codes (use the ISO Short column)](/previous-versions/commerce-server/ee799297(v=cs.20))
@@ -212,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:
 

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
 ---

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)