diff --git a/windows/configuration/taskbar/includes/example.md b/windows/configuration/taskbar/includes/example.md index 030ef184c6..d3e3103cab 100644 --- a/windows/configuration/taskbar/includes/example.md +++ b/windows/configuration/taskbar/includes/example.md @@ -5,12 +5,6 @@ ms.date: 03/13/2024 ms.topic: include --- -## Create the XML file - -### Sample taskbar configuration XML file - -Here's an example: - ```xml [!CAUTION] > When you make changes to the XML file, be aware that the XML format must adhere to an [XML schema definition (XSD)](xsd.md). -You can change the apps pinned to the taskbar by modifying the `` section. +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 + - ``: 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 -### Add pins +For practical examples of how to add, remove, or replace pinned apps, see the following sections: -The `` section will append listed apps to the taskbar by default. The following sample keeps the default apps pinned and adds pins for Paint, Microsoft Reader, and a command prompt. +- [Add pins](#example-add-pins) +- [Remove default pins](#example-remove-pins) +- [Replace default pins](#example-replace-pins) +- [Configuration by country or region](#example-configuration-by-country-or-region) + +#### Example: add pins + +The `` section appends the listed apps to the taskbar by default. The following sample keeps the default apps pinned and adds pins for Paint, Microsoft Reader, and a command prompt. [!INCLUDE [example-add-pins](includes/example-add-pins.md)] @@ -97,10 +104,10 @@ The `` section will append listed apps to the tas ::: zone-end ::: zone pivot="windows-10" -:::image type="content" source="images/pin-add-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after adding pinsr." border="false" lightbox="./images/pin-add-10.png"::: +:::image type="content" source="images/pin-add-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after adding pins." border="false" lightbox="./images/pin-add-10.png"::: ::: zone-end -### Remove default pins +#### Example: remove default pins To remove all default pins, add `PinListPlacement="Replace"` to ``. @@ -116,7 +123,7 @@ To remove all default pins, add `PinListPlacement="Replace"` to ``. Then, add the pins that you want to `TaskbarPinList`. @@ -132,7 +139,7 @@ To replace all default pins and add your own pins, add `PinListPlacement="Replac :::image type="content" source="images/pin-replace-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after replacing pins." border="false" lightbox="images/pin-replace-10.png"::: ::: zone-end -### Configuration by country or region +#### Example: configuration by country or region In the following XML example, two regions are added: `US|UK` and `DE|FR|IT`: @@ -206,7 +213,7 @@ On a clean install of Windows, if you apply a taskbar layout, the following apps - 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 apps may have been pinned by a user, by an image, or by using Windows unattended setup. For upgrades, the taskbar layout applies the following behavior: +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 diff --git a/windows/configuration/taskbar/policy-settings.md b/windows/configuration/taskbar/policy-settings.md index 6812b85b90..cf9fa4a5ea 100644 --- a/windows/configuration/taskbar/policy-settings.md +++ b/windows/configuration/taskbar/policy-settings.md @@ -13,8 +13,8 @@ This reference article outlines the policy settings available for customizing th The settings are categorized and presented in alphabetical order to facilitate navigation and configuration. -1. **Taskbar layout**: settings to control the taskbar appearance and its behavior -1. **Taskbar behaviors**: settings to control users' allowed actions on the taskbar +1. **Taskbar layout**: settings to control the taskbar layout and appearance +1. **Taskbar behaviors**: settings to control the taskbar behaviors and the users' allowed actions Select one of the tabs to see the list of available settings: