diff --git a/.openpublishing.redirection.windows-configuration.json b/.openpublishing.redirection.windows-configuration.json index 971d493152..d92acf14b2 100644 --- a/.openpublishing.redirection.windows-configuration.json +++ b/.openpublishing.redirection.windows-configuration.json @@ -162,7 +162,7 @@ }, { "source_path": "windows/configuration/start-taskbar-lockscreen.md", - "redirect_url": "/windows/configuration/windows-10-start-layout-options-and-policies", + "redirect_url": "/windows/configuration/start/policy-settings", "redirect_document_id": false }, { @@ -287,7 +287,7 @@ }, { "source_path": "windows/configuration/customize-and-export-start-layout.md", - "redirect_url": "/windows/configuration/start/customize-and-export-start-layout", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { @@ -422,12 +422,12 @@ }, { "source_path": "windows/configuration/start-layout-xml-desktop.md", - "redirect_url": "/windows/configuration/start/start-layout-xml-desktop", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { "source_path": "windows/configuration/start-secondary-tiles.md", - "redirect_url": "/windows/configuration/start/start-secondary-tiles", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { @@ -442,7 +442,7 @@ }, { "source_path": "windows/configuration/supported-csp-start-menu-layout-windows.md", - "redirect_url": "/windows/configuration/start/supported-csp-start-menu-layout-windows", + "redirect_url": "/windows/configuration/start/policy-settings", "redirect_document_id": false }, { @@ -452,7 +452,7 @@ }, { "source_path": "windows/configuration/windows-10-start-layout-options-and-policies.md", - "redirect_url": "/windows/configuration/start/windows-10-start-layout-options-and-policies", + "redirect_url": "/windows/configuration/start/policy-settings", "redirect_document_id": false }, { @@ -822,22 +822,22 @@ }, { "source_path": "windows/configuration/start/customize-start-menu-layout-windows-11.md", - "redirect_url": "/windows/configuration/start/customize-and-export-start-layout", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { "source_path": "windows/configuration/start/customize-windows-10-start-screens-by-using-group-policy.md", - "redirect_url": "/windows/configuration/start/customize-and-export-start-layout", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { "source_path": "windows/configuration/start/customize-windows-10-start-screens-by-using-mobile-device-management.md", - "redirect_url": "/windows/configuration/start/customize-and-export-start-layout", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { "source_path": "windows/configuration/start/customize-windows-10-start-screens-by-using-provisioning-packages-and-icd.md", - "redirect_url": "/windows/configuration/start/customize-and-export-start-layout", + "redirect_url": "/windows/configuration/start/layout", "redirect_document_id": false }, { @@ -850,6 +850,11 @@ "redirect_url": "/windows/configuration/taskbar/", "redirect_document_id": false }, + { + "source_path": "windows/configuration/start/supported-csp-start-menu-layout-windows.md", + "redirect_url": "/windows/configuration/start/policy-settings", + "redirect_document_id": false + }, { "source_path": "windows/configuration/tips/manage-tips-and-suggestions.md", "redirect_url": "/windows/configuration", @@ -864,6 +869,26 @@ "source_path": "windows/configuration/taskbar/supported-csp-taskbar-windows.md", "redirect_url": "/windows/configuration/taskbar/policy-settings", "redirect_document_id": false + }, + { + "source_path": "windows/configuration/start/start-layout-xml-desktop.md", + "redirect_url": "/windows/configuration/start/layout", + "redirect_document_id": false + }, + { + "source_path": "windows/configuration/start/customize-and-export-start-layout.md", + "redirect_url": "/windows/configuration/start/layout", + "redirect_document_id": false + }, + { + "source_path": "windows/configuration/start/windows-10-start-layout-options-and-policies.md", + "redirect_url": "/windows/configuration/start/policy-settings", + "redirect_document_id": false + }, + { + "source_path": "windows/configuration/start/start-secondary-tiles.md", + "redirect_url": "/windows/configuration/start/layout", + "redirect_document_id": false } ] } \ No newline at end of file diff --git a/windows/client-management/mdm/policy-csp-start.md b/windows/client-management/mdm/policy-csp-start.md index 8ae3504c72..cfa71536be 100644 --- a/windows/client-management/mdm/policy-csp-start.md +++ b/windows/client-management/mdm/policy-csp-start.md @@ -542,7 +542,7 @@ Allows admin to override the default items pinned to Start. With this policy you can push a new list of pinned apps to override the default/current list of pinned apps in the Windows Start menu. -For more information on how to configure the Start menu, see [Customize the Start menu layout on Windows 11](/windows/configuration/customize-start-menu-layout-windows-11). +For more information on how to configure the Start menu, see [Customize the Start layout](/windows/configuration/start/layout). This string policy takes a JSON file named `LayoutModification.json`. The file enumerates the items to pin and their relative order. diff --git a/windows/configuration/assigned-access/configuration-file.md b/windows/configuration/assigned-access/configuration-file.md index 5a96fcc4a4..3d2532b2af 100644 --- a/windows/configuration/assigned-access/configuration-file.md +++ b/windows/configuration/assigned-access/configuration-file.md @@ -232,9 +232,9 @@ Either don't use the node or leave it empty. For a restricted user experience profile (`AllAppList`), you must define the Start layout. The Start layout contains a list of applications that are pinned to the Start menu. You can choose to pin all the allowed applications to the Start menu, or a subset. The easiest way to create a customized Start layout is to configure the Start menu on a test device and then export the layout. -::: zone pivot="windows-10" +To learn how to customize and export a Start menu configuration, see [Customize the Start menu](../start/layout.md). -To learn how to customize and export a Start menu configuration, see [Customize the Start menu](../start/customize-and-export-start-layout.md). +::: zone pivot="windows-10" With the exported Start menu configuration, use the `StartLayout` element and add the content of the XML file. For example: @@ -278,8 +278,6 @@ Example with some apps pinned: ::: zone pivot="windows-11" -To learn how to customize and export a Start menu configuration, see [Customize the Start menu](../start/customize-and-export-start-layout.md). - With the exported Start menu configuration, use the `v5:StartPins` element and add the content of the exported JSON file. For example: ```xml diff --git a/windows/configuration/assigned-access/overview.md b/windows/configuration/assigned-access/overview.md index aaac72ceeb..cef2e32f30 100644 --- a/windows/configuration/assigned-access/overview.md +++ b/windows/configuration/assigned-access/overview.md @@ -155,7 +155,7 @@ Write-Output "Successfully applied Shell Launcher configuration" [!INCLUDE [powershell-wmi-bridge-2](../../../includes/configure/powershell-wmi-bridge-2.md)] -#### [:::image type="icon" source="../images/icons/settings.svg"::: **Settings**](#tab/settings) +#### [:::image type="icon" source="../images/icons/settings-app.svg"::: **Settings**](#tab/settings) Here are the steps to configure a kiosk using the Settings app: @@ -260,7 +260,7 @@ Write-Output "Successfully applied Assigned Access configuration" [!INCLUDE [powershell-wmi-bridge-2](../../../includes/configure/powershell-wmi-bridge-2.md)] -#### [:::image type="icon" source="../images/icons/settings.svg"::: **Settings**](#tab/settings) +#### [:::image type="icon" source="../images/icons/settings-app.svg"::: **Settings**](#tab/settings) This option isn't available using Settings. diff --git a/windows/configuration/assigned-access/quickstart-kiosk.md b/windows/configuration/assigned-access/quickstart-kiosk.md index 60839e646e..0dd9ff9fa7 100644 --- a/windows/configuration/assigned-access/quickstart-kiosk.md +++ b/windows/configuration/assigned-access/quickstart-kiosk.md @@ -64,7 +64,7 @@ Assign the policy to a group that contains as members the devices that you want -#### [:::image type="icon" source="../images/icons/settings.svg"::: **Settings**](#tab/settings) +#### [:::image type="icon" source="../images/icons/settings-app.svg"::: **Settings**](#tab/settings) Here are the steps to configure a kiosk using the Settings app: diff --git a/windows/configuration/images/icons/allapps.svg b/windows/configuration/images/icons/allapps.svg new file mode 100644 index 0000000000..dbcdff6268 --- /dev/null +++ b/windows/configuration/images/icons/allapps.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/certificate.svg b/windows/configuration/images/icons/certificate.svg new file mode 100644 index 0000000000..956bfc1e42 --- /dev/null +++ b/windows/configuration/images/icons/certificate.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/cmd.svg b/windows/configuration/images/icons/cmd.svg new file mode 100644 index 0000000000..e712a4fff5 --- /dev/null +++ b/windows/configuration/images/icons/cmd.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/windows/configuration/images/icons/control-panel.svg b/windows/configuration/images/icons/control-panel.svg new file mode 100644 index 0000000000..6eebbe9be8 --- /dev/null +++ b/windows/configuration/images/icons/control-panel.svg @@ -0,0 +1,9 @@ + + + + + + + + + diff --git a/windows/configuration/images/icons/face.svg b/windows/configuration/images/icons/face.svg new file mode 100644 index 0000000000..a4fa1ca0df --- /dev/null +++ b/windows/configuration/images/icons/face.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/fingerprint.svg b/windows/configuration/images/icons/fingerprint.svg new file mode 100644 index 0000000000..2494d65659 --- /dev/null +++ b/windows/configuration/images/icons/fingerprint.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/folder.svg b/windows/configuration/images/icons/folder.svg new file mode 100644 index 0000000000..468edaf961 --- /dev/null +++ b/windows/configuration/images/icons/folder.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/group-policy.svg b/windows/configuration/images/icons/group-policy.svg index c9cb511415..e6ec2d2c2e 100644 --- a/windows/configuration/images/icons/group-policy.svg +++ b/windows/configuration/images/icons/group-policy.svg @@ -1,9 +1,14 @@ - - + + + + - + - + + + + diff --git a/windows/configuration/images/icons/information.svg b/windows/configuration/images/icons/information.svg index bc692eabb9..4a33944103 100644 --- a/windows/configuration/images/icons/information.svg +++ b/windows/configuration/images/icons/information.svg @@ -1,3 +1,3 @@ - - - \ No newline at end of file + + + diff --git a/windows/configuration/images/icons/insider.svg b/windows/configuration/images/icons/insider.svg new file mode 100644 index 0000000000..fa002fa2a1 --- /dev/null +++ b/windows/configuration/images/icons/insider.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/intune.svg b/windows/configuration/images/icons/intune.svg index 6e0d938aed..22148b48fb 100644 --- a/windows/configuration/images/icons/intune.svg +++ b/windows/configuration/images/icons/intune.svg @@ -1,24 +1,23 @@ - - - - - - - - - - - - - - - - Icon-intune-329 - - - - - - - - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + + + diff --git a/windows/configuration/images/icons/iris.svg b/windows/configuration/images/icons/iris.svg new file mode 100644 index 0000000000..465902e0b3 --- /dev/null +++ b/windows/configuration/images/icons/iris.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/kiosk.svg b/windows/configuration/images/icons/kiosk.svg new file mode 100644 index 0000000000..f975677d19 --- /dev/null +++ b/windows/configuration/images/icons/kiosk.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/lock.svg b/windows/configuration/images/icons/lock.svg new file mode 100644 index 0000000000..ccd1850fbb --- /dev/null +++ b/windows/configuration/images/icons/lock.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/package.svg b/windows/configuration/images/icons/package.svg new file mode 100644 index 0000000000..99c1148922 --- /dev/null +++ b/windows/configuration/images/icons/package.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/pin-code.svg b/windows/configuration/images/icons/pin-code.svg new file mode 100644 index 0000000000..a5bfdc4148 --- /dev/null +++ b/windows/configuration/images/icons/pin-code.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/pin.svg b/windows/configuration/images/icons/pin.svg new file mode 100644 index 0000000000..64426df32c --- /dev/null +++ b/windows/configuration/images/icons/pin.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/power.svg b/windows/configuration/images/icons/power.svg new file mode 100644 index 0000000000..e74606b72c --- /dev/null +++ b/windows/configuration/images/icons/power.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/powershell.svg b/windows/configuration/images/icons/powershell.svg index b23a99c61d..3d90e2ff6f 100644 --- a/windows/configuration/images/icons/powershell.svg +++ b/windows/configuration/images/icons/powershell.svg @@ -1,9 +1,9 @@ - - + + - + - + diff --git a/windows/configuration/images/icons/registry.svg b/windows/configuration/images/icons/registry.svg index bc4aa2f534..667bce7438 100644 --- a/windows/configuration/images/icons/registry.svg +++ b/windows/configuration/images/icons/registry.svg @@ -1,9 +1,9 @@ - + - + - + diff --git a/windows/configuration/images/icons/rocket.svg b/windows/configuration/images/icons/rocket.svg index 133e0c7daf..ee39fb57aa 100644 --- a/windows/configuration/images/icons/rocket.svg +++ b/windows/configuration/images/icons/rocket.svg @@ -1,19 +1,155 @@ - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - diff --git a/windows/configuration/images/icons/sc.svg b/windows/configuration/images/icons/sc.svg new file mode 100644 index 0000000000..d1924ffebb --- /dev/null +++ b/windows/configuration/images/icons/sc.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/settings-app.svg b/windows/configuration/images/icons/settings-app.svg new file mode 100644 index 0000000000..d62d13fb54 --- /dev/null +++ b/windows/configuration/images/icons/settings-app.svg @@ -0,0 +1,24 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/windows/configuration/images/icons/settings.svg b/windows/configuration/images/icons/settings.svg index 9ec19d16aa..36da6757f2 100644 --- a/windows/configuration/images/icons/settings.svg +++ b/windows/configuration/images/icons/settings.svg @@ -1,19 +1,3 @@ - - - - - - - - - - - - - - - - - + diff --git a/windows/configuration/images/icons/start.svg b/windows/configuration/images/icons/start.svg new file mode 100644 index 0000000000..a3e6c3d8e8 --- /dev/null +++ b/windows/configuration/images/icons/start.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/subscription.svg b/windows/configuration/images/icons/subscription.svg new file mode 100644 index 0000000000..ffa73c424e --- /dev/null +++ b/windows/configuration/images/icons/subscription.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/user.svg b/windows/configuration/images/icons/user.svg new file mode 100644 index 0000000000..76c0b2ce5d --- /dev/null +++ b/windows/configuration/images/icons/user.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/vsc.svg b/windows/configuration/images/icons/vsc.svg new file mode 100644 index 0000000000..cbf23de89e --- /dev/null +++ b/windows/configuration/images/icons/vsc.svg @@ -0,0 +1,3 @@ + + + diff --git a/windows/configuration/images/icons/windows-os.svg b/windows/configuration/images/icons/windows-os.svg deleted file mode 100644 index da64baf975..0000000000 --- a/windows/configuration/images/icons/windows-os.svg +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/windows/configuration/index.yml b/windows/configuration/index.yml index c71df35e46..33f47997d5 100644 --- a/windows/configuration/index.yml +++ b/windows/configuration/index.yml @@ -21,14 +21,18 @@ landingContent: linkLists: - linkListType: how-to-guide links: - - text: Customize the Windows Start menu layout - url: start/customize-and-export-start-layout.md - - text: Customize the Windows taskbar + - text: Configure the Start menu + url: start/index.md + - text: Customize the Taskbar url: taskbar/index.md - - text: Configure Windows Spotlight on the lock screen + - text: Configure the Lock Screen url: lock-screen/windows-spotlight.md - text: Accessibility information for IT pros url: accessibility/index.md + - linkListType: reference + links: + - text: Start policy settings + url: start/policy-settings.md - title: Configure a Windows kiosk linkLists: diff --git a/windows/configuration/start/customize-and-export-start-layout.md b/windows/configuration/start/customize-and-export-start-layout.md deleted file mode 100644 index 4a22ee3b6f..0000000000 --- a/windows/configuration/start/customize-and-export-start-layout.md +++ /dev/null @@ -1,524 +0,0 @@ ---- -title: Customize and export the Start layout -description: Learn how to customize the Windows Start layout and export the configuration to apply to other devices. -ms.topic: how-to -ms.date: 03/04/2024 -zone_pivot_groups: windows-versions-11-10 -appliesto: -ms.collection: - - tier1 ---- - -# Customize and export the Start layout - -> **Looking for OEM information?** See [Customize the Taskbar](/windows-hardware/customize/desktop/customize-the-windows-11-taskbar) and [Customize the Start layout](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). - -::: zone pivot="windows-11" - -Your organization can deploy a customized Start layout to your Windows 11 devices. Customizing the Start layout is common when you have similar devices used by many users, or you want to pin specific apps. - -For example, you can override the default set of apps with your own a set of pinned apps, and in the order you choose. As an administrator, use this feature to pin apps, remove default pinned apps, order the apps, and more. - -To add apps you want pinned to the Start menu, you use a JSON file. In previous Windows versions, IT administrators used an XML file to customize the Start menu. The XML file isn't available on Windows 11 and later ***unless*** [you're an OEM](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). - -This article shows you how to export an existing Start menu layout, and use the JSON in a Microsoft Intune policy. - -## Before you begin - -- When you customize the Start layout, you overwrite the entire full layout. A partial Start layout isn't available. Users can pin and unpin apps, and uninstall apps from Start. When a user signs in or Explorer restarts, Windows reapplies the MDM policy. This action restores the specified layout and doesn't retain any user changes. - - To prevent users from making any changes to the Start menu layout, see the [NoChangeStartMenu](/windows/client-management/mdm/policy-csp-admx-startmenu#admx-startmenu-nochangestartmenu) policy. - -- It's recommended to use a mobile device management (MDM) provider. MDM providers help manage your devices, and help manage apps on your devices. You can use Microsoft Intune. Intune is a family of products that include Microsoft Intune, which is a cloud service, and Configuration Manager, which is on-premises. - - In this article, we mention these services. If you're not managing your devices using an MDM provider, the following resources may help you get started: - - - [Endpoint Management at Microsoft](/mem/endpoint-manager-overview) - - [What is Microsoft Intune](/mem/intune/fundamentals/what-is-intune) and [Microsoft Intune planning guide](/mem/intune/fundamentals/intune-planning-guide) - - [What is Configuration Manager?](/mem/configmgr/core/understand/introduction) - -## Start menu features and areas - -In Windows 11, the Start menu is redesigned with a simplified set of apps that are arranged in a grid of pages. There aren't folders, groups, or different-sized app icons: - -:::image type="content" source="./images/start-windows-11.png" alt-text="Sample start menu layout on Windows 11 that shows pinned apps, access to all apps, and recommended files."::: - -Start has the following areas: - -- **Pinned**: Shows pinned apps, or a subset of all of the apps installed on the device. You can create a list of pinned apps you want on the devices using the **ConfigureStartPins** policy. **ConfigureStartPins** overrides the entire layout, which also removes apps that are pinned by default. - - This article shows you [how to use the **ConfigureStartPins** policy](#get-the-pinnedlist-json). - -- **All apps**: Users select this option to see an alphabetical list of all the apps on the device. This section can't be customized using the JSON file. - - The [Start/HideFrequentlyUsedApps CSP](/windows/client-management/mdm/policy-csp-start#start-hidefrequentlyusedapps) exposes settings that configure the "Most used" section, which is at the top of the all apps list. - - In **Intune**, you can configure this Start menu layout feature, and more. For more information on the Start menu settings you can configure in an Intune policy, see [Windows 10/11 device settings to allow or restrict features](/mem/intune/configuration/device-restrictions-windows-10#start). - - In **Group Policy**, there are policies that include settings that control the Start menu layout. Some policies may not work as expected. Be sure to test your policies before broadly deploying them across your devices: - - - `Computer Configuration\Administrative Templates\Start Menu and Taskbar` - - `User Configuration\Administrative Templates\Start Menu and Taskbar` - -- **Recommended**: Shows recently opened files and recently installed apps. This section can only be customized in Windows 11 SE using the following policy. - - - `Computer Configuration\Administrative Templates\Start Menu and Taskbar\Remove Recommended section from Start Menu` - -## Create the JSON file - -On an existing Windows 11 device, set up your own Start layout with the pinned apps you want users to see. Then, use the [Windows PowerShell Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet to export the existing layout to a `LayoutModification.json` file. - -The JSON file controls the Start menu layout, and lists all the apps that are pinned. You can update the JSON file to: - -- Change the order of existing apps. The apps in the JSON file are shown on Start in the same order. -- Add more apps by entering the app ID. For more information, see [Get the pinnedList JSON](#get-the-pinnedlist-json) (in this article). - -If you're familiar with creating JSON files, you can create your own `LayoutModification.json` file. But, it's easier and faster to export the layout from an existing device. - -### Export an existing Start layout - -1. Create a folder to save the `.json` file. For example, create the `C:\Layouts` folder. -1. On a Windows 11 device, open the Windows PowerShell app. -1. Run the following cmdlet. Name the file `LayoutModification.json`. - - ```powershell - Export-StartLayout -Path "C:\Layouts\LayoutModification.json" - - ``` - -### Get the pinnedList JSON - -1. Open the `LayoutModification.json` file in a JSON editor, such as Visual Studio Code or Notepad. For more information, see [edit JSON with Visual Studio Code](https://code.visualstudio.com/docs/languages/json). -1. In the file, you see the `pinnedList` section. This section includes all of the pinned apps. Copy the `pinnedList` content in the JSON file. You'll use it in the next section. - - In the following example, you see that Microsoft Edge, Microsoft Word, the Microsoft Store app, and Notepad are pinned: - - ```json - { - "pinnedList": [ - { "desktopAppId": "MSEdge" }, - { "desktopAppId": "Microsoft.Office.WINWORD.EXE.15" }, - { "packagedAppId": "Microsoft.WindowsStore_8wekyb3d8bbwe!App" }, - { "packagedAppId": "Microsoft.WindowsNotepad_8wekyb3d8bbwe!App" } - ] - } - ``` - -1. Starting with Windows 11, the **ConfigureStartPins** policy is available. This policy uses the `LayoutModification.json` file to add apps to the Pinned section. In your JSON file, you can add more apps to this section using the following keys: - -| Key | Description | -|--|--| -| packagedAppID | Use this option for Universal Windows Platform apps. To pin a UWP app, use the app's AUMID. | -| desktopAppID | Use this option for unpackaged Win32 apps. To pin a Win32 app, use the app's AUMID. If the app doesn't have an AUMID, then enter the `desktopAppLink` instead. | -| desktopAppLink | Use this option for unpackaged Win32 apps that don't have an associated AUMID. To pin this type of app, use the path to the `.lnk` shortcut that points to the app. | - -## Use MDM to create and deploy a pinned list policy - -Now that you have the JSON syntax, you're ready to deploy your customized Start layout to devices in your organization. - -MDM providers can deploy policies to devices managed by the organization, including organization-owned devices, and personal or bring your own device (BYOD). Using an MDM provider, such as Microsoft Intune, you can deploy a policy that configures the pinned list. - -This section shows you how to create a pinned list policy in Intune. There isn't a Group Policy to create a pinned list. - -### Create a pinned list using an Intune policy - -To deploy this policy, the devices must be enrolled, and managed by your organization. For more information, see [What is device enrollment?](/mem/intune/enrollment/device-enrollment). - -1. Sign in to the [Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431). -1. Select **Devices** > **Configuration profiles** > **Create profile**. -1. Enter the following properties: - - - **Platform**: Select **Windows 10 and later**. - - **Profile**: Select **Templates** > **Custom**. - -1. Select **Create**. -1. In **Basics**, enter the following properties: - - - **Name**: Enter a descriptive name for the profile. Name your profiles so you can easily identify them later. For example, a good profile name is **Win11: Custom Start layout**. - - **Description**: Enter a description for the profile. This setting is optional, and recommended. - -1. Select **Next**. -1. In **Configuration settings** > **OMA-URI**, select **Add**. Add the following properties: - - - **Name**: Enter something like **Configure Start pins**. - - **Description**: Enter a description for the row. This setting is optional, and recommended. - - **OMA-URI**: Enter `./Vendor/MSFT/Policy/Config/Start/ConfigureStartPins`. - - **Data type**: Select **String**. - - **Value**: Paste the JSON you created or updated in the previous section. For example, enter the following text: - - ```json - { - "pinnedList": [ - { "desktopAppId": "MSEdge" }, - { "desktopAppId": "Microsoft.Office.WINWORD.EXE.15" }, - { "packagedAppId": "Microsoft.WindowsStore_8wekyb3d8bbwe!App" }, - { "packagedAppId": "Microsoft.WindowsNotepad_8wekyb3d8bbwe!App" } - ] - } - ``` - - Your settings look similar to the following settings: - - :::image type="content" source="./images/endpoint-manager-admin-center-custom-oma-uri-start-layout.png" alt-text="Custom OMA-URI settings to customize Start menu layout using pinnedList"::: - -1. Select **Save** > **Next** to save your changes. -1. Configure the rest of the policy settings. For more specific information, see [Create a profile with custom settings](/mem/intune/configuration/custom-settings-configure). - -The Windows OS exposes many CSPs that apply to the Start menu. For a list, see [Supported CSP policies for Windows 11 Start menu](supported-csp-start-menu-layout-windows.md). - -### Deploy the policy using Intune - -When the policy is created, you can deploy it now, or deploy it later. Since this policy is a customized Start layout, the policy can be deployed anytime, including before users sign in the first time. - -For more information and guidance on assigning policies to devices in your organization, see [Assign user and device profiles](/mem/intune/configuration/device-profile-assign). - -::: zone-end - -::: zone pivot="windows-10" - -The easiest method for creating a customized Start layout to apply to other Windows 10 devices is to set up the Start screen on a test computer and then export the layout. - -After you export the layout, decide whether you want to apply a *full* Start layout or a *partial* Start layout. - -When a full Start layout is applied, the users can't pin, unpin, or uninstall apps from Start. Users can view and open all apps in the **All Apps** view, but they can't pin any apps to Start. - -When [a partial Start layout](#configure-a-partial-start-layout) is applied, the contents of the specified tile groups can't be changed, but users can move those groups, and can also create and customize their own groups. - -## Customize the Start screen on your test computer - -To prepare a Start layout for export, you simply customize the Start layout on a test computer. - -To prepare a test computer: - -1. Set up a test computer on which to customize the Start layout. Your test computer should have the operating system that is installed on the users' computers (Windows 10 Pro, Enterprise, or Education). Install all apps and services that the Start layout should display. -1. Create a new user account that you'll use to customize the Start layout. - -To customize Start: - -1. Sign in to your test computer with the user account that you created. -1. Customize the Start layout as you want users to see it by using the following techniques: - - - **Pin apps to Start**. From Start, type the name of the app. When the app appears in the search results, right-click the app, and then select **Pin to Start**. - To view all apps, select **All apps** in the bottom-left corner of Start. Right-click any app, and pin or unpin it from Start. - - **Unpin apps** that you don't want to display. To unpin an app, right-click the app, and then select **Unpin from Start**. - - **Drag tiles** on Start to reorder or group apps. - - **Resize tiles**. To resize tiles, right-click the tile and then select **Resize.** - - **Create your own app groups**. Drag the apps to an empty area. To name a group, select above the group of tiles and then type the name in the **Name group** field that appears above the group. - -> [!IMPORTANT] -> If the Start layout includes tiles for apps that are not installed on the device that the layout is later applied to, the tiles for those apps will be blank. The blank tiles will persist until the next time the user signs in, at which time the blank tiles are removed. Some system events may cause the blank tiles to be removed before the next sign-in. - -### Export the Start layout - -When you have the Start layout that you want your users to see, use the [Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet in Windows PowerShell to export the Start layout to an .xml file. Start layout is located by default at C:\Users\username\AppData\Local\Microsoft\Windows\Shell\ - -> [!IMPORTANT] -> If you include secondary Microsoft Edge tiles (tiles that link to specific websites in Microsoft Edge), see [Add custom images to Microsoft Edge secondary tiles](start-secondary-tiles.md) for instructions. - -To export the Start layout to an .xml file: - -1. While signed in with the same account that you used to customize Start, right-click Start, and select **Windows PowerShell**. -1. Run `Export-StartLayout` with the switch `-UseDesktopApplicationID`. For example: - - ```PowerShell - Export-StartLayout -UseDesktopApplicationID -Path layout.xml - ``` - - In the previous command, `-path` is a required parameter that specifies the path and file name for the export file. You can specify a local path or a UNC path (for example, `\\FileServer01\StartLayouts\StartLayoutMarketing.xml`). - - Use a file name of your choice—for example, StartLayoutMarketing.xml. Include the .xml file name extension. The [Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet doesn't append the file name extension, and the policy settings require the extension. - - Example of a layout file produced by `Export-StartLayout`: - - ```xml - - - - - - - - - - - - - - - ``` - -1. (Optional) Edit the .xml file to add [a taskbar configuration](../taskbar/configure.md) or to [modify the exported layout](start-layout-xml-desktop.md). When you make changes to the exported layout, be aware that [the order of the elements in the .xml file is critical.](start-layout-xml-desktop.md#required-order) - -> [!IMPORTANT] -> If the Start layout that you export contains tiles for desktop (Win32) apps or .url links, **Export-StartLayout** will use **DesktopApplicationLinkPath** in the resulting file. Use a text or XML editor to change **DesktopApplicationLinkPath** to **DesktopApplicationID**. See [Specify Start tiles](start-layout-xml-desktop.md#specify-start-tiles) for details on using the app ID in place of the link path. - -> [!NOTE] -> All clients that the start layout applies to must have the apps and other shortcuts present on the local system in the same location as the source for the Start layout. -> -> For scripts and application tile pins to work correctly, follow these rules: -> ->- Executable files and scripts should be listed in \Program Files or wherever the installer of the app places them. ->- Shortcuts that will pinned to Start should be placed in \ProgramData\Microsoft\Windows\Start Menu\Programs. ->- If you place executable files or scripts in the \ProgramData\Microsoft\Windows\Start Menu\Programs folder, they will not pin to Start. ->- Start on Windows 10 does not support subfolders. We only support one folder. For example, \ProgramData\Microsoft\Windows\Start Menu\Programs\Folder. If you go any deeper than one folder, Start will compress the contents of all the subfolder to the top level. ->- Three additional shortcuts are pinned to the start menu after the export. These are shortcuts to %ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs, %APPDATA%\Microsoft\Windows\Start Menu\Programs, and %APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\. - -### Configure a partial Start layout - -A partial Start layout enables you to add one or more customized tile groups to users' Start screens or menus, while still allowing users to make changes to other parts of the Start layout. All groups that you add are *locked*, meaning users can't change the contents of those tile groups, however users can change the location of those groups. Locked groups are identified with an icon, as shown in the following image. - -![locked tile group.](images/start-pinned-app.png) - -When a partial Start layout is applied for the first time, the new groups are added to the users' existing Start layouts. If an app tile is in both an existing group and in a new locked group, the duplicate app tile is removed from the existing (unlocked) group. - -When a partial Start layout is applied to a device that already has a StartLayout.xml applied, groups that were added previously are removed and the groups in the new layout are added. - -If the Start layout is applied by Group Policy or MDM, and the policy is removed, the groups remain on the devices but become unlocked. - -To configure a partial Start screen layout: - -1. [Customize the Start layout](#customize-the-start-screen-on-your-test-computer). -1. [Export the Start layout](#export-the-start-layout). -1. Open the layout .xml file. There is a `` element. Add `LayoutCustomizationRestrictionType="OnlySpecifiedGroups"` to the **DefaultLayoutOverride** element as follows: - - ```xml - - ``` - -1. Save the file and apply using any of the deployment methods. - -> [!NOTE] -> Office 2019 tiles might be removed from the Start menu when you upgrade Office 201. This only occurs if Office 2019 app tiles are in a custom group in the Start menu and only contains the Office 2019 app tiles. To avoid this problem, place another app tile in the Office 2019 group prior to the upgrade. For example, add Notepad.exe or calc.exe to the group. This issue occurs because Office 2019 removes and reinstalls the apps when they are upgraded. Start removes empty groups when it detects that all apps for that group have been removed. - -You can deploy the resulting .xml file to devices using one of the following methods: - -- Configuration Service Provider (CSP) -- Group Policy -- Provisioning package - -[!INCLUDE [tab-intro](../../../includes/configure/tab-intro.md)] - -#### [:::image type="icon" source="../images/icons/intune.svg"::: **Intune/CSP**](#tab/intune) - -You can use a mobile device management (MDM) policy to deploy a customized Start and taskbar layout to users. No reimaging is required. The layout can be updated simply by overwriting the `.xml` file that contains the layout. This feature enables you to customize Start layouts for different departments or organizations, with minimal management overhead. - -**Before you begin**: [Customize and export Start layout](customize-and-export-start-layout.md). - ->[!WARNING] ->When a full Start layout is applied with this method, the users cannot pin, unpin, or uninstall apps from Start. Users can view and open all apps in the **All Apps** view, but they cannot pin any apps to Start. When a partial Start layout is applied, the contents of the specified tile groups cannot be changed, but users can move those groups, and can also create and customize their own groups. - -Two features enable Start layout control: - -- The **Export-StartLayout** cmdlet in Windows PowerShell exports a description of the current Start layout in .xml file format. - - >[!NOTE] - >To import the layout of Start to a mounted Windows image, use the [Import-StartLayout](/powershell/module/startlayout/import-startlayout) cmdlet. - -- In Microsoft Intune, you select the Start layout XML file and add it to a device configuration profile. - - >[!NOTE] - >Please do not include XML Prologs like \ in the Start layout XML file. The settings may not be reflected correctly. - -## Create a policy for your customized Start layout - -The following example uses Microsoft Intune to configure an MDM policy that applies a customized Start layout: - -1. Sign in to the [Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431). - -1. Select **Devices** > **Configuration profiles** > **Create profile**. - -1. Enter the following properties: - - - **Platform**: Select **Windows 10 and later**. - - **Profile type**: Select **Templates** > **Device restrictions** > **Create**. - -1. In **Basics**, enter the following properties: - - - **Name**: Enter a descriptive name for the profile. Name your profiles so you can easily identify it later. For example, a good profile name is **Customize Start menu and taskbar**. - - **Description**: Enter a description for the profile. This setting is optional, but recommended. - -1. Select **Next**. - -1. In **Configuration settings**, select **Start**: - - - If you're using an XML file, select **Start menu layout**. Browse to and select your Start layout XML file. - - If you don't have an XML file, configure the others settings. For more information on these settings, see [Start settings in Microsoft Intune](/mem/intune/configuration/device-restrictions-windows-10#start). - -1. Select **Next**. -1. In **Scope tags**, select **Next**. For more information about scope tags, see [Use RBAC and scope tags for distributed IT](/mem/intune/fundamentals/scope-tags). -1. In **Assignments**, select the user or groups that will receive your profile. Select **Next**. For more information on assigning profiles, see [Assign user and device profiles](/mem/intune/configuration/device-profile-assign). -1. In **Review + create**, review your settings. When you select **Create**, your changes are saved, and the profile is assigned. The policy is also shown in the profiles list. - -> [!NOTE] -> For third party partner MDM solutions, you may need to use an OMA-URI setting for Start layout, based on the [Policy configuration service provider (CSP)](/windows/client-management/mdm/policy-configuration-service-provider). The OMA-URI setting is `./User/Vendor/MSFT/Policy/Config/Start/StartLayout`. - -#### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg) - -You can use a provisioning package that you create with Windows Configuration Designer to deploy a customized Start and taskbar layout to users. No reimaging is required, and the Start and taskbar layout can be updated by overwriting the .xml file that contains the layout. The provisioning package can be applied to a running device. This enables you to customize Start and taskbar layouts for different departments or organizations, with minimal management overhead. - -> [!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 unpins that app, the user's change will be overwritten the next time the configuration is applied. To apply a taskbar configuration and allow users to make changes that will persist, apply your configuration by using Group Policy. - -**Before you begin**: [Customize and export Start layout](customize-and-export-start-layout.md) for desktop editions. - -Three features enable Start and taskbar layout control: - -- The **Export-StartLayout** cmdlet in Windows PowerShell exports a description of the current Start layout in .xml file format. - - > [!NOTE] - > To import the layout of Start to a mounted Windows image, use the [Import-StartLayout](/powershell/module/startlayout/import-startlayout) cmdlet. - -- [You can modify the Start .xml file](../taskbar/configure.md) to include `` or create an .xml file just for the taskbar configuration. - -- In Windows Configuration Designer, you use the **Policies/Start/StartLayout** setting to provide the contents of the .xml file that defines the Start and taskbar layout. - - - -## Prepare the Start layout XML file - -The **Export-StartLayout** cmdlet produces an XML file. Because Windows Configuration Designer produces a customizations.xml file that contains the configuration settings, adding the Start layout section to the customizations.xml file directly would result in an XML file embedded in an XML file. Before you add the Start layout section to the customizations.xml file, you must replace the markup characters in your layout.xml with escape characters. - -1. Copy the contents of layout.xml into an online tool that escapes characters. - -1. During the procedure to create a provisioning package, you will copy the text with the escape characters and paste it in the customizations.xml file for your project. - -## Create a provisioning package that contains a customized Start layout - -Use the Windows Configuration Designer tool to create a provisioning package. [Learn how to install Windows Configuration Designer.](../provisioning-packages/provisioning-install-icd.md) - -> [!IMPORTANT] -> When you build a provisioning package, you may include sensitive information in the project files and in the provisioning package (.ppkg) file. Although you have the option to encrypt the .ppkg file, project files are not encrypted. You should store the project files in a secure location and delete the project files when they are no longer needed. - -1. Open Windows Configuration Designer (by default, %systemdrive%\\Program Files (x86)\\Windows Kits\\10\\Assessment and Deployment Kit\\Imaging and Configuration Designer\\x86\\ICD.exe). - -1. Choose **Advanced provisioning**. - -1. Name your project, and click **Next**. - -1. Choose **All Windows desktop editions** and click **Next**. - -1. On **New project**, click **Finish**. The workspace for your package opens. - -1. Expand **Runtime settings** > **Policies** > **Start**, and click **StartLayout**. - - > [!TIP] - > If **Start** is not listed, check the type of settings you selected in step 1. You must create the project using settings for **All Windows desktop editions**. - -1. Enter **layout.xml**. This value creates a placeholder in the customizations.xml file that you will replace with the contents of the layout.xml file in a later step. - -1. Save your project and close Windows Configuration Designer. - -1. In File Explorer, open the project's directory. (The default location is C:\Users\\*user name*\Documents\Windows Imaging and Configuration Designer (WICD)\\*project name*) - -1. Open the customizations.xml file in a text editor. - -1. Replace **layout.xml** with the text from the layout.xml file, [with markup characters replaced with escape characters](#escape). - -1. Save and close the customizations.xml file. - -1. Open Windows Configuration Designer and open your project. - -1. On the **File** menu, select **Save.** - -1. On the **Export** menu, select **Provisioning package**. - -1. Change **Owner** to **IT Admin**, which will set the precedence of this provisioning package higher than provisioning packages applied to this device from other sources, and then select **Next.** - -1. Optional. In the **Provisioning package security** window, you can choose to encrypt the package and enable package signing. - - - **Enable package encryption** - If you select this option, an auto-generated password will be shown on the screen. - - - **Enable package signing** - If you select this option, you must select a valid certificate to use for signing the package. You can specify the certificate by clicking **Browse** and choosing the certificate you want to use to sign the package. - -1. Click **Next** to specify the output location where you want the provisioning package to go when it's built. By default, Windows Imaging and Configuration Designer (ICD) uses the project folder as the output location. - - Optionally, you can click **Browse** to change the default output location. - -1. Click **Next**. - -1. Click **Build** to start building the package. The provisioning package doesn't take long to build. The project information is displayed in the build page and the progress bar indicates the build status. - - If you need to cancel the build, click **Cancel**. This cancels the current build process, closes the wizard, and takes you back to the **Customizations Page**. - -1. If your build fails, an error message will show up that includes a link to the project folder. You can scan the logs to determine what caused the error. Once you fix the issue, try building the package again. - - If your build is successful, the name of the provisioning package, output directory, and project directory will be shown. - - - If you choose, you can build the provisioning package again and pick a different path for the output package. To do this, click **Back** to change the output package name and path, and then click **Next** to start another build. - - If you are done, click **Finish** to close the wizard and go back to the **Customizations Page**. - -1. Copy the provisioning package to the target device. -1. Double-click the ppkg file and allow it to install. - -#### [:::image type="icon" source="../images/icons/group-policy.svg"::: **GPO**](#tab/gpo) - -You can use a Group Policy Object (GPO) to deploy a customized Start and taskbar layout to users in a domain. No reimaging is required, and the layout can be updated simply by overwriting the .xml file that contains the layout. This enables you to customize Start and taskbar layouts for different departments or organizations, with minimal management overhead. - -This topic describes how to update Group Policy settings to display a customized Start and taskbar layout when the users sign in. By creating a domain-based GPO with these settings, you can deploy a customized Start and taskbar layout to users in a domain. - ->[!WARNING] ->When a full Start layout is applied with this method, the users cannot pin, unpin, or uninstall apps from Start. Users can view and open all apps in the **All Apps** view, but they cannot pin any apps to Start. When a partial Start layout is applied, the contents of the specified tile groups cannot be changed, but users can move those groups, and can also create and customize their own groups. When you apply a taskbar layout, users will still be able to pin and unpin apps, and change the order of pinned apps. - -**Before you begin**: [Customize and export Start layout](customize-and-export-start-layout.md) - -## Operating system requirements - -The GPO can be configured from any computer on which the necessary ADMX and ADML files (StartMenu.admx and StartMenu.adml) for Windows 10 are installed. In Group Policy, ADMX files are used to define Registry-based policy settings in the Administrative Templates category. To find out how to create a central store for Administrative Templates files, see [article 929841, written for Windows Vista and still applicable](/troubleshoot/windows-server/group-policy/create-central-store-domain-controller) in the Microsoft Knowledge Base. - -Three features enable Start and taskbar layout control: - -- The [Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet in Windows PowerShell exports a description of the current Start layout in .xml file format. - >[!NOTE] - >To import the layout of Start to a mounted Windows image, use the [Import-StartLayout](/powershell/module/startlayout/import-startlayout) cmdlet. -- [You can modify the Start .xml file](../taskbar/configure.md) to include `` or create an .xml file just for the taskbar configuration. -- In Group Policy, you use the **Start Layout** settings for the **Start Menu and Taskbar** administrative template to set a Start and taskbar layout from an .xml file when the policy is applied. The Group Policy object doesn't support an empty tile layout, so the default tile layout for Windows is loaded in that case. - ->[!NOTE] ->To learn how customize Start to include your line-of-business apps when you deploy Windows 10, see [Customize the Windows 10 Start layout]( https://go.microsoft.com/fwlink/p/?LinkId=620863). - -## Use Group Policy to apply a customized Start layout in a domain - -To apply the Start and taskbar layout to users in a domain, use the Group Policy Management Console (GPMC) to configure a domain-based Group Policy Object (GPO) that sets **Start Layout** policy settings in the **Start Menu and Taskbar** administrative template for users in a domain. - -The GPO applies the Start and taskbar layout at the next user sign-in. Each time the user signs in, the timestamp of the .xml file with the Start and taskbar layout is checked and if a newer version of the file is available, the settings in the latest version of the file are applied. - -The GPO can be configured from any computer on which the necessary ADMX and ADML files (StartMenu.admx and StartMenu.adml) for Windows 10 are installed. - -The .xml file with the Start and taskbar layout must be located on shared network storage that is available to the users' computers when they sign in and the users must have Read-only access to the file. If the file is not available when the first user signs in, Start and the taskbar are not customized during the session, but the user will be prevented from making changes to Start. On subsequent sign-ins, if the file is available at sign-in, the layout it contains will be applied to the user's Start and taskbar. - -For information about deploying GPOs in a domain, see [Working with Group Policy Objects](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc731212(v=ws.11)). - -## Use Group Policy to apply a customized Start layout on the local computer - -You can use the Local Group Policy Editor to provide a customized Start and taskbar layout for any user who signs in on the local computer. To display the customized Start and taskbar layout for any user who signs in, configure **Start Layout** policy settings for the **Start Menu and Taskbar** administrative template. You can use the **Start Menu and Taskbar** administrative template in **User Configuration** or **Computer Configuration**. - ->[!NOTE] ->This procedure applies the policy settings on the local computer only. For information about deploying the Start and taskbar layout to users in a domain, see [Use Group Policy to deploy a customized Start layout in a domain](#bkmk-domaingpodeployment). -> ->This procedure creates a Local Group Policy that applies to all users on the computer. To configure Local Group Policy that applies to a specific user or group on the computer, see [Step-by-Step Guide to Managing Multiple Local Group Policy Objects](/previous-versions/windows/it-pro/windows-vista/cc766291(v=ws.10)). The guide was written for Windows Vista and the procedures still apply to Windows 10. - -This procedure adds the customized Start and taskbar layout to the user configuration, which overrides any Start layout settings in the local computer configuration when a user signs in on the computer. - -To configure Start Layout policy settings in Local Group Policy Editor: - -1. On the test computer, press the Windows key, type **gpedit**, and then select **Edit group policy (Control panel)**. -1. Go to **User Configuration** or **Computer Configuration** > **Administrative Templates** >**Start Menu and Taskbar**. - ![start screen layout policy settings.](images/starttemplate.jpg) -1. Right-click **Start Layout** in the right pane, and click **Edit**. - This opens the **Start Layout** policy settings. - ![policy settings for start screen layout.](images/startlayoutpolicy.jpg) -1. Enter the following settings, and then click **OK**: - 1. Select **Enabled**. - 1. Under **Options**, specify the path to the .xml file that contains the Start and taskbar layout. For example, type **C:\\Users\\Test01\\StartScreenMarketing.xml**. - 1. Optionally, enter a comment to identify the Start and taskbar layout. - - > [!IMPORTANT] - > If you disable Start Layout policy settings that have been in effect and then re-enable the policy, users will not be able to make changes to Start, however the layout in the .xml file will not be reapplied unless the file has been updated. In Windows PowerShell, you can update the timestamp on a file by running the following command: - > - > `(ls ).LastWriteTime = Get-Date` - -## Update a customized Start layout - -After you use Group Policy to apply a customized Start and taskbar layout on a computer or in a domain, you can update the layout simply by replacing the .xml file that is specified in the Start Layout policy settings with a file with a newer timestamp. - -::: zone-end diff --git a/windows/configuration/start/images/customization-start-edge.PNG b/windows/configuration/start/images/customization-start-edge.PNG deleted file mode 100644 index 333833d8c0..0000000000 Binary files a/windows/configuration/start/images/customization-start-edge.PNG and /dev/null differ diff --git a/windows/configuration/start/images/customization-start.PNG b/windows/configuration/start/images/customization-start.PNG deleted file mode 100644 index 4942338181..0000000000 Binary files a/windows/configuration/start/images/customization-start.PNG and /dev/null differ diff --git a/windows/configuration/start/images/edge-with-logo.png b/windows/configuration/start/images/edge-with-logo.png deleted file mode 100644 index cc3504a678..0000000000 Binary files a/windows/configuration/start/images/edge-with-logo.png and /dev/null differ diff --git a/windows/configuration/start/images/edge-without-logo.png b/windows/configuration/start/images/edge-without-logo.png deleted file mode 100644 index 52085a2d68..0000000000 Binary files a/windows/configuration/start/images/edge-without-logo.png and /dev/null differ diff --git a/windows/configuration/start/images/endpoint-manager-admin-center-custom-oma-uri-start-layout.png b/windows/configuration/start/images/endpoint-manager-admin-center-custom-oma-uri-start-layout.png deleted file mode 100644 index cd508b3dea..0000000000 Binary files a/windows/configuration/start/images/endpoint-manager-admin-center-custom-oma-uri-start-layout.png and /dev/null differ diff --git a/windows/configuration/start/images/start-pinned-app.png b/windows/configuration/start/images/start-pinned-app.png deleted file mode 100644 index e1e4a24a00..0000000000 Binary files a/windows/configuration/start/images/start-pinned-app.png and /dev/null differ diff --git a/windows/configuration/start/images/start-windows-11.png b/windows/configuration/start/images/start-windows-11.png deleted file mode 100644 index 9cafb224bf..0000000000 Binary files a/windows/configuration/start/images/start-windows-11.png and /dev/null differ diff --git a/windows/configuration/start/images/startannotated.png b/windows/configuration/start/images/startannotated.png deleted file mode 100644 index 9261fd9078..0000000000 Binary files a/windows/configuration/start/images/startannotated.png and /dev/null differ diff --git a/windows/configuration/start/images/startlayoutpolicy.jpg b/windows/configuration/start/images/startlayoutpolicy.jpg deleted file mode 100644 index d3c8d054fe..0000000000 Binary files a/windows/configuration/start/images/startlayoutpolicy.jpg and /dev/null differ diff --git a/windows/configuration/start/images/starttemplate.jpg b/windows/configuration/start/images/starttemplate.jpg deleted file mode 100644 index 900eed08c5..0000000000 Binary files a/windows/configuration/start/images/starttemplate.jpg and /dev/null differ diff --git a/windows/configuration/start/images/taskbar-generic.png b/windows/configuration/start/images/taskbar-generic.png deleted file mode 100644 index 6d47a6795a..0000000000 Binary files a/windows/configuration/start/images/taskbar-generic.png and /dev/null differ diff --git a/windows/configuration/start/images/windows-10-partial-layout.png b/windows/configuration/start/images/windows-10-partial-layout.png new file mode 100644 index 0000000000..4650cc42cf Binary files /dev/null and b/windows/configuration/start/images/windows-10-partial-layout.png differ diff --git a/windows/configuration/start/images/windows-10-secondary-tile.png b/windows/configuration/start/images/windows-10-secondary-tile.png new file mode 100644 index 0000000000..01e25ef3bc Binary files /dev/null and b/windows/configuration/start/images/windows-10-secondary-tile.png differ diff --git a/windows/configuration/start/images/windows-10-settings.png b/windows/configuration/start/images/windows-10-settings.png new file mode 100644 index 0000000000..496c2a62c2 Binary files /dev/null and b/windows/configuration/start/images/windows-10-settings.png differ diff --git a/windows/configuration/start/images/windows-10.png b/windows/configuration/start/images/windows-10.png new file mode 100644 index 0000000000..98db149a77 Binary files /dev/null and b/windows/configuration/start/images/windows-10.png differ diff --git a/windows/configuration/start/images/windows-11-secondary-tile.png b/windows/configuration/start/images/windows-11-secondary-tile.png new file mode 100644 index 0000000000..7e7600dcc3 Binary files /dev/null and b/windows/configuration/start/images/windows-11-secondary-tile.png differ diff --git a/windows/configuration/start/images/windows-11-settings.png b/windows/configuration/start/images/windows-11-settings.png new file mode 100644 index 0000000000..18150b3ff8 Binary files /dev/null and b/windows/configuration/start/images/windows-11-settings.png differ diff --git a/windows/configuration/start/images/windows-11.png b/windows/configuration/start/images/windows-11.png new file mode 100644 index 0000000000..32925b625e Binary files /dev/null and b/windows/configuration/start/images/windows-11.png differ diff --git a/windows/configuration/start/includes/allow-pinned-folder-documents.md b/windows/configuration/start/includes/allow-pinned-folder-documents.md new file mode 100644 index 0000000000..85de1af61c --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-documents.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Documents + +This policy controls the visibility of the Documents shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Documents shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Documents shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderDocuments](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderdocuments) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-downloads.md b/windows/configuration/start/includes/allow-pinned-folder-downloads.md new file mode 100644 index 0000000000..b10fa9128e --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-downloads.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Downloads + +This policy controls the visibility of the Downloads shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Downloads shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Downloads shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderDownloads](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderdownloads) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-file-explorer.md b/windows/configuration/start/includes/allow-pinned-folder-file-explorer.md new file mode 100644 index 0000000000..2c0fb926a3 --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-file-explorer.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder File Explorer + +This policy controls the visibility of the File Explorer shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the File Explorer shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the File Explorer shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderFileExplorer](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderfileexplorer) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-home-group.md b/windows/configuration/start/includes/allow-pinned-folder-home-group.md new file mode 100644 index 0000000000..933eb328aa --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-home-group.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Home Group + +This policy controls the visibility of the Home Group shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Home Group shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Home Group shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderHomeGroup](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderhomegroup) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-music.md b/windows/configuration/start/includes/allow-pinned-folder-music.md new file mode 100644 index 0000000000..b70d8557ba --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-music.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Music + +This policy controls the visibility of the Music shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Music shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Music shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderMusic](/windows/client-management/mdm/policy-csp-start#allowpinnedfoldermusic) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-network.md b/windows/configuration/start/includes/allow-pinned-folder-network.md new file mode 100644 index 0000000000..b9e3defc32 --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-network.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Network + +This policy controls the visibility of the Network shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Network shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Network shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderNetword](/windows/client-management/mdm/policy-csp-start#allowpinnedfoldernetwork) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-personal-folder.md b/windows/configuration/start/includes/allow-pinned-folder-personal-folder.md new file mode 100644 index 0000000000..c80c7e6a09 --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-personal-folder.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Personal Folder + +This policy controls the visibility of the Personal Folder shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Personal Folder shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Personal Folder shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderPersonalFolder](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderpersonalfolder) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-pictures.md b/windows/configuration/start/includes/allow-pinned-folder-pictures.md new file mode 100644 index 0000000000..07c10b8014 --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-pictures.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Pictures + +This policy controls the visibility of the Pictures shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Pictures shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Pictures shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderPictures](/windows/client-management/mdm/policy-csp-start#allowpinnedfolderpictures) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-settings.md b/windows/configuration/start/includes/allow-pinned-folder-settings.md new file mode 100644 index 0000000000..0cf19f323f --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-settings.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Settings + +This policy controls the visibility of the Settings shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Settings shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Settings shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderSettings](/windows/client-management/mdm/policy-csp-start#allowpinnedfoldersettings) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/allow-pinned-folder-videos.md b/windows/configuration/start/includes/allow-pinned-folder-videos.md new file mode 100644 index 0000000000..0d8ccdca7c --- /dev/null +++ b/windows/configuration/start/includes/allow-pinned-folder-videos.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Allow pinned folder Videos + +This policy controls the visibility of the Videos shortcut on the *Pinned folder* section of the Start menu: + +- When enabled, the Videos shortcut is displayed in the Pinned folder section of the Start menu +- When disabled, the Videos shortcut is not displayed in the Pinned folder section of the Start menu + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[AllowPinnedFolderVideos](/windows/client-management/mdm/policy-csp-start#allowpinnedfoldervideos) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/clear-history-of-recently-opened-documents-on-exit.md b/windows/configuration/start/includes/clear-history-of-recently-opened-documents-on-exit.md new file mode 100644 index 0000000000..a81f028057 --- /dev/null +++ b/windows/configuration/start/includes/clear-history-of-recently-opened-documents-on-exit.md @@ -0,0 +1,23 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Clear history of recently opened documents on exit + +If you enable this policy setting, shortcuts to recently used files are deleted when the user signs out: + +- The **Recent Items** section on the Start menu is cleared +- Recently and frequently used items in the jump lists of programs in the Start menu and Taskbar are cleared + +If you disable or don't configure this policy setting, the system retains document shortcuts. When a user signs in, the **Recent Items** menu and the jump lists appear as when the user logged off. + +> [!NOTE] +> The system saves document shortcuts in the user profile in the System-drive\Users\User-name\Recent folder. + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Clear history of recently opened documents on exit** | diff --git a/windows/configuration/start/includes/clear-the-recent-programs-list-for-new-users.md b/windows/configuration/start/includes/clear-the-recent-programs-list-for-new-users.md new file mode 100644 index 0000000000..cb6caaaf10 --- /dev/null +++ b/windows/configuration/start/includes/clear-the-recent-programs-list-for-new-users.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Clear the recent programs list for new users + +If you enable this policy setting, the recent programs list in the start menu is empty for each new user. If you disable or don't configure this policy setting, the start menu *recent programs list* is prepopulated with programs for each new user. + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Clear the recent programs list for new users** | diff --git a/windows/configuration/start/includes/clear-tile-notifications-during-log-on.md b/windows/configuration/start/includes/clear-tile-notifications-during-log-on.md new file mode 100644 index 0000000000..59c2b07132 --- /dev/null +++ b/windows/configuration/start/includes/clear-tile-notifications-during-log-on.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Clear tile notifications during log on + +If you enable this policy setting, the system deletes tile notifications when the user signs on. As a result, the tiles in the Start menu always show their default content when a user signs in. Any cached versions of the notifications are cleared when the user signs in. If you disable or don't configure this setting, the system retains notifications, and when a user signs in, the tiles appear just as they did when the user signed out, including the history of previous notifications for each tile. This policy setting doesn't prevent new notifications from appearing. + +| | Path | +|--|--| +| **CSP** | ./Device/Vendor/MSFT/[Setting]() | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** | diff --git a/windows/configuration/start/includes/configure-start-layout.md b/windows/configuration/start/includes/configure-start-layout.md new file mode 100644 index 0000000000..fca0c5315d --- /dev/null +++ b/windows/configuration/start/includes/configure-start-layout.md @@ -0,0 +1,17 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Configure Start layout + +This policy setting lets you specify the Start layout for users, preventing them from changing its configuration. The Start layout you specify must be stored in an XML file that was generated by the `Export-StartLayout` PowerShell cmdlet. To use this setting, you must first manually configure a device's Start layout to the desired look and feel. Then, run the `Export-StartLayout` PowerShell cmdlet on that same device. The cmdlet generates an XML file representing the layout you configured. Once the XML file is generated and moved to the desired file path, use the fully qualified path and name of the XML file. You can use a local path, or a UNC path. If the specified file isn't available when the user signs in, the layout isn't changed. Users can't customize the Start layout while this setting is enabled. If you disable this setting or don't configure it, the Start screen layout isn't changed and users can customize it. + +| | Path | +|--|--| +| **CSP** | [Configure start layout](/windows/client-management/mdm/policy-csp-start#startlayout) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** | + +For more information, see [Customize the Start layout](../layout.md). diff --git a/windows/configuration/start/includes/configure-start-pins.md b/windows/configuration/start/includes/configure-start-pins.md new file mode 100644 index 0000000000..9f24b17c31 --- /dev/null +++ b/windows/configuration/start/includes/configure-start-pins.md @@ -0,0 +1,19 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 10/30/2023 +ms.topic: include +--- + +### Configure Start pins + +This policy setting lets you specify a new list of pinned apps to override the default/current list of pinned apps in the Windows Start menu. + +The policy setting accepts a JSON file that contains the list of items to pin, and their order. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[ConfigureStartPins](/windows/client-management/mdm/policy-csp-start#configurestartpins)

`./User/Vendor/MSFT/Policy/Config/Start/`[ConfigureStartPins](/windows/client-management/mdm/policy-csp-start#configurestartpins)| +| **GPO** | Not available | + +For more information, see [Customize the Start layout](../layout.md). diff --git a/windows/configuration/start/includes/disable-context-menus.md b/windows/configuration/start/includes/disable-context-menus.md new file mode 100644 index 0000000000..e502478b6f --- /dev/null +++ b/windows/configuration/start/includes/disable-context-menus.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Disable context menus + +With this policy setting you can prevent users from opening the context menus in the Start menu. If you enable this policy, then invocations of context menus within the Start menu is ignored. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[DisableContextMenus](/windows/client-management/mdm/policy-csp-start#disablecontextmenus)

`./User/Vendor/MSFT/Policy/Config/Start/`[DisableContextMenus](/windows/client-management/mdm/policy-csp-start#disablecontextmenus)| +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Disable context menus in the Start Menu** | diff --git a/windows/configuration/start/includes/disable-search.md b/windows/configuration/start/includes/disable-search.md new file mode 100644 index 0000000000..5de3b6fa11 --- /dev/null +++ b/windows/configuration/start/includes/disable-search.md @@ -0,0 +1,16 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Disable search + +When you enable this policy setting, the Search UI and all its entry points are disabled, such as keyboard shortcuts, touchpad gestures, and type-to-search in the Start menu. The Start menu's search box and Search Taskbar buttons are hidden. If you disable or don't configure this policy setting, users can open the Search UI and its different entry points are available. + + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Search/`[DisableSearch](/windows/client-management/mdm/policy-csp-search#disablesearch)| +| **GPO** | **Computer Configuration** > **Windows Components** > **Search** > **Fully disable Search UI** | diff --git a/windows/configuration/start/includes/do-not-use-the-search-based-method-when-resolving-shell-shortcuts.md b/windows/configuration/start/includes/do-not-use-the-search-based-method-when-resolving-shell-shortcuts.md new file mode 100644 index 0000000000..55a74cc190 --- /dev/null +++ b/windows/configuration/start/includes/do-not-use-the-search-based-method-when-resolving-shell-shortcuts.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Don't use the search-based method when resolving shell shortcuts + +This policy setting prevents the system from conducting a comprehensive search of the target drive to resolve a shortcut. If you enable this policy setting, the system doesn't conduct the final drive search. It just displays a message explaining that the file isn't found. If you disable or don't configure this policy setting, by default, when the system can't find the target file for a shortcut (.lnk), it searches all paths associated with the shortcut. If the target file is located on an NTFS partition, the system then uses the target's file ID to find a path. If the resulting path isn't correct, it conducts a comprehensive search of the target drive in an attempt to find the file. Note: This policy setting only applies to target files on NTFS partitions. FAT partitions don't have this ID tracking and search capability. + +| | Path | +|--|--| +| **CSP** | ./Device/Vendor/MSFT/[Setting]() | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Do not use the search-based method when resolving shell shortcuts** | diff --git a/windows/configuration/start/includes/do-not-use-the-tracking-based-method-when-resolving-shell-shortcuts.md b/windows/configuration/start/includes/do-not-use-the-tracking-based-method-when-resolving-shell-shortcuts.md new file mode 100644 index 0000000000..a877effc15 --- /dev/null +++ b/windows/configuration/start/includes/do-not-use-the-tracking-based-method-when-resolving-shell-shortcuts.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Don't use the tracking-based method when resolving shell shortcuts + +This policy setting prevents the system from using NTFS tracking features to resolve a shortcut. If you enable this policy setting, the system doesn't try to locate the file by using its file ID. It skips this step and begins a comprehensive search of the drive specified in the target path. If you disable or don't configure this policy setting, by default, when the system can't find the target file for a shortcut (.lnk), it searches all paths associated with the shortcut. If the target file is located on an NTFS partition, the system then uses the target's file ID to find a path. If the resulting path isn't correct, it conducts a comprehensive search of the target drive in an attempt to find the file. Note: This policy setting only applies to target files on NTFS partitions. FAT partitions don't have this ID tracking and search capability. + +| | Path | +|--|--| +| **CSP** | ./Device/Vendor/MSFT/[Setting]() | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Do not use the tracking-based method when resolving shell shortcuts** | diff --git a/windows/configuration/start/includes/example-assets.md b/windows/configuration/start/includes/example-assets.md new file mode 100644 index 0000000000..1a9db2bdb8 --- /dev/null +++ b/windows/configuration/start/includes/example-assets.md @@ -0,0 +1,21 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 03/13/2024 +ms.topic: include +--- + +Example of the output of the PowerShell cmdlet `Export-StartLayoutEdgeAssets`: + +```xml + + + + Base64 encoded value of the logo + + + + Base64 encoded value of the logo + + +``` \ No newline at end of file diff --git a/windows/configuration/start/includes/example-secondary-tiles.md b/windows/configuration/start/includes/example-secondary-tiles.md new file mode 100644 index 0000000000..1f1a7197b5 --- /dev/null +++ b/windows/configuration/start/includes/example-secondary-tiles.md @@ -0,0 +1,24 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 03/13/2024 +ms.topic: include +--- + +Example of secondary tiles in XML generated by the PowerShell cmdlet `Export-StartLayout`: + +```xml + +``` diff --git a/windows/configuration/start/includes/example-start-layout.md b/windows/configuration/start/includes/example-start-layout.md new file mode 100644 index 0000000000..94957b8fa9 --- /dev/null +++ b/windows/configuration/start/includes/example-start-layout.md @@ -0,0 +1,57 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 03/13/2024 +ms.topic: include +--- + +::: zone pivot="windows-10" + +```xml + + + + + + + + + + + + + + + + + + + + + + +``` + +::: zone-end + +::: zone pivot="windows-11" + +```json +{ + "pinnedList": [ + {"desktopAppLink": "%ALLUSERSPROFILE%\\Microsoft\\Windows\\Start Menu\\Programs\\Microsoft Edge.lnk" }, + { "packagedAppId": "windows.immersivecontrolpanel_cw5n1h2txyewy!microsoft.windows.immersivecontrolpanel" }, + { "desktopAppLink": "%APPDATA%\\Microsoft\\Windows\\Start Menu\\Programs\\File Explorer.lnk" }, + { "desktopAppLink": "%APPDATA%\\Microsoft\\Windows\\Start Menu\\Programs\\Windows PowerShell\\Windows PowerShell.lnk" }, + { "packagedAppId": "Microsoft.WindowsTerminal_8wekyb3d8bbwe!App" }, + { "packagedAppId": "Microsoft.Paint_8wekyb3d8bbwe!App" }, + { "packagedAppId": "Microsoft.Windows.Photos_8wekyb3d8bbwe!App" }, + { "packagedAppId": "MicrosoftCorporationII.QuickAssist_8wekyb3d8bbwe!App" }, + { "packagedAppId": "Microsoft.MicrosoftStickyNotes_8wekyb3d8bbwe!App" }, + { "packagedAppId": "Microsoft.SecHealthUI_8wekyb3d8bbwe!SecHealthUI" }, + { "packagedAppId": "Microsoft.OutlookForWindows_8wekyb3d8bbwe!Microsoft.OutlookforWindows"} + ] +} +``` + +::: zone-end diff --git a/windows/configuration/start/includes/force-start-size.md b/windows/configuration/start/includes/force-start-size.md new file mode 100644 index 0000000000..2f1dda1496 --- /dev/null +++ b/windows/configuration/start/includes/force-start-size.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Force Start size + +If you enable this policy and set it to Start menu or full screen Start, Start is set to that size and users can't change the size of Start in Settings. If you disable or don't configure this policy setting, Windows automatically selects the size based on hardware form factor and users can change the size of Start in Settings. + +| | Path | +|--|--| +| **CSP** | `./User/Vendor/MSFT/Policy/Config/Start/`[ForceStartSize](/windows/client-management/mdm/policy-csp-start#forcestartsize)

`./Device/Vendor/MSFT/Policy/Config/Start/`[ForceStartSize](/windows/client-management/mdm/policy-csp-start#forcestartsize) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Force Start to be either full screen size or menu size** | diff --git a/windows/configuration/start/includes/hide-app-list.md b/windows/configuration/start/includes/hide-app-list.md new file mode 100644 index 0000000000..6185e19f8f --- /dev/null +++ b/windows/configuration/start/includes/hide-app-list.md @@ -0,0 +1,20 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide app list + +If you enable this setting, the Start Menu will either collapse or remove the all apps list from the Start menu: + +- **Collapse** doesn't display the app list next to the pinned tiles in Start. An **All apps** button is displayed on Start to open the all apps list. This is equivalent to setting the **Show app list in Start** in Settings to **Off** +- **Collapse and disable setting** is the same as the collapse option and disable the **Show app list in Start menu** in Settings, so users can't turn it to On +- **Remove and disable setting** removes the all apps list from Start and disable the **Show app list in Start menu** in Settings, so users can't turn it to On +- If you disable or don't configure this setting, the all apps list is visible by default, and the user can change **Show app list in Start** in Settings + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideAppList](/windows/client-management/mdm/policy-csp-start#hideapplist)

`./User/Vendor/MSFT/Policy/Config/Start/`[HideAppList](/windows/client-management/mdm/policy-csp-start#hideapplist) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove All Programs list from the Start menu**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove All Programs list from the Start menu** | diff --git a/windows/configuration/start/includes/hide-change-account-settings.md b/windows/configuration/start/includes/hide-change-account-settings.md new file mode 100644 index 0000000000..4e0e563b3e --- /dev/null +++ b/windows/configuration/start/includes/hide-change-account-settings.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 10/30/2023 +ms.topic: include +--- + +### Hide change account settings + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideChangeAccountSettings](/windows/client-management/mdm/policy-csp-start#hidechangeaccountsettings)| +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-frequently-used-apps.md b/windows/configuration/start/includes/hide-frequently-used-apps.md new file mode 100644 index 0000000000..65ff38d497 --- /dev/null +++ b/windows/configuration/start/includes/hide-frequently-used-apps.md @@ -0,0 +1,17 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide frequently used apps + +If you enable this setting, the frequently used programs list is removed from the Start menu. + +If you disable this setting or don't configure it, the frequently used programs list remains on the simple Start menu. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideFrequentlyUsedApps](/windows/client-management/mdm/policy-csp-start#hidefrequentlyusedapps)

`./User/Vendor/MSFT/Policy/Config/Start/`[HideFrequentlyUsedApps](/windows/client-management/mdm/policy-csp-start#hidefrequentlyusedapps) | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove frequent programs from the Start Menu** | diff --git a/windows/configuration/start/includes/hide-hibernate.md b/windows/configuration/start/includes/hide-hibernate.md new file mode 100644 index 0000000000..e7b39cbb1d --- /dev/null +++ b/windows/configuration/start/includes/hide-hibernate.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Hibernate + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideHibernate](/windows/client-management/mdm/policy-csp-start#hidehibernate) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-lock.md b/windows/configuration/start/includes/hide-lock.md new file mode 100644 index 0000000000..e43dff0cfa --- /dev/null +++ b/windows/configuration/start/includes/hide-lock.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Lock + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideSignOut](/windows/client-management/mdm/policy-csp-start#hidelock) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-most-used-lists.md b/windows/configuration/start/includes/hide-most-used-lists.md new file mode 100644 index 0000000000..e6f6eb2231 --- /dev/null +++ b/windows/configuration/start/includes/hide-most-used-lists.md @@ -0,0 +1,23 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide most used lists + +If you enable this policy setting, you can configure Start menu to show or hide the list of user's most used apps, regardless of user settings: + +- Selecting **Show** forces the *Most used* list in the Start menu, and users can't change to hide it using the Settings app +- Selecting **Hide** disables the *Most used* list, and users can't change to show it using the Settings app +- Selecting **Not Configured**, allow users to turn on or off the display of **Most used** list using the Settings app. This is default behavior. + +> [!NOTE] +> +> This policy setting has the precedence over the *Hide frequently used apps* policy setting. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[ShowOrHideMostUsedApps](/windows/client-management/mdm/policy-csp-start#showorhidemostusedapps)

`./User/Vendor/MSFT/Policy/Config/Start/`[ShowOrHideMostUsedApps](/windows/client-management/mdm/policy-csp-start#showorhidemostusedapps)| +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Show or hide "Most used" list from Start menu**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Show or hide "Most used" list from Start menu** | diff --git a/windows/configuration/start/includes/hide-power-button.md b/windows/configuration/start/includes/hide-power-button.md new file mode 100644 index 0000000000..2c5fb58ca9 --- /dev/null +++ b/windows/configuration/start/includes/hide-power-button.md @@ -0,0 +1,17 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Power button + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HidePowerButton](/windows/client-management/mdm/policy-csp-start#hidepowerbutton) | +| **GPO** | Not available. | + +hiderestart +hideshutdown +hidesleep \ No newline at end of file diff --git a/windows/configuration/start/includes/hide-recent-jumplists.md b/windows/configuration/start/includes/hide-recent-jumplists.md new file mode 100644 index 0000000000..6e9a6b15ac --- /dev/null +++ b/windows/configuration/start/includes/hide-recent-jumplists.md @@ -0,0 +1,25 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide recent jumplists + +Prevents the operating system and installed programs from creating and displaying shortcuts to recently opened documents. + +- If you enable this setting: + - The system and apps don't create shortcuts to documents opened + - The system empties the Recent Items menu on the Start menu, and apps don't display shortcuts at the bottom of the File menu + - The Jump Lists in the Start Menu and Taskbar don't show lists of recently or frequently used files, folders, or websites +If you disable or don't configure this setting + - The system stores and displays shortcuts to recently and frequently used files, folders, and websites + +If you enable this setting but don't enable the "Remove Recent Items menu from Start Menu" setting, the Recent Items menu appears on the Start menu, but it's empty. If you enable this setting, but then later disable it or set it to *Not Configured*, the document shortcuts saved before the setting was enabled reappear in the Recent Items menu and program File menus, and Jump Lists. This setting doesn't hide or prevent the user from pinning files, folders, or websites to the Jump Lists. This setting doesn't hide document shortcuts displayed in the Open dialog box. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideRecentJumplists](/windows/client-management/mdm/policy-csp-start#hiderecentjumplists)

`./User/Vendor/MSFT/Policy/Config/Start/`[HideRecentJumplists](/windows/client-management/mdm/policy-csp-start#hiderecentjumplists) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Do not keep history of recently opened documents**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Do not keep history of recently opened documents**| + diff --git a/windows/configuration/start/includes/hide-recently-added-apps.md b/windows/configuration/start/includes/hide-recently-added-apps.md new file mode 100644 index 0000000000..43c642e888 --- /dev/null +++ b/windows/configuration/start/includes/hide-recently-added-apps.md @@ -0,0 +1,17 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide recently added apps + +With this policy setting, you can prevent the Start menu from displaying a list of recently installed applications. + +If you enable this policy, the Start menu doesn't display the **Recently added** list. The corresponding setting is also disabled in Settings. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideRecentlyAddedApps](/windows/client-management/mdm/policy-csp-start#hiderecentlyaddedapps)

`./User/Vendor/MSFT/Policy/Config/Start/`[HideRecentlyAddedApps](/windows/client-management/mdm/policy-csp-start#hiderecentlyaddedapps) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove "Recently added" list from Start Menu** | diff --git a/windows/configuration/start/includes/hide-recommended-personalized-sites.md b/windows/configuration/start/includes/hide-recommended-personalized-sites.md new file mode 100644 index 0000000000..899e17d18a --- /dev/null +++ b/windows/configuration/start/includes/hide-recommended-personalized-sites.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide recommended personalized sites + +Remove Personalized Website Recommendations from the Recommended section in the Start Menu. + +| | Path | +|--|--| +| **CSP** | `./User/Vendor/MSFT/Policy/Config/Start/`[HideRecommendedPersonalizedSites](/windows/client-management/mdm/policy-csp-start#hiderecommendedpersonalizedsites)

`./Device/Vendor/MSFT/Policy/Config/Start/`[HideRecommendedPersonalizedSites](/windows/client-management/mdm/policy-csp-start#hiderecommendedpersonalizedsites) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove Personalized Website Recommendations from the Recommended section in the Start Menu**| \ No newline at end of file diff --git a/windows/configuration/start/includes/hide-recommended-section.md b/windows/configuration/start/includes/hide-recommended-section.md new file mode 100644 index 0000000000..0331a54e2e --- /dev/null +++ b/windows/configuration/start/includes/hide-recommended-section.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide recommended section + +This policy setting prevents the Start menu from displaying a list of recommended applications and files. If you enable this policy setting, the Start menu doesn't show the section containing a list of recommended files and apps. + +| | Path | +|--|--| +| **CSP** | `./User/Vendor/MSFT/Policy/Config/Start/`[HideRecommendedSection](/windows/client-management/mdm/policy-csp-start#hiderecommendedsection)

`./Device/Vendor/MSFT/Policy/Config/Start/`[HideRecommendedSection](/windows/client-management/mdm/policy-csp-start#hiderecommendedsection) | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove Recommended section from Start Menu** | diff --git a/windows/configuration/start/includes/hide-restart.md b/windows/configuration/start/includes/hide-restart.md new file mode 100644 index 0000000000..b62480ae4b --- /dev/null +++ b/windows/configuration/start/includes/hide-restart.md @@ -0,0 +1,16 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Restart + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideRestart](/windows/client-management/mdm/policy-csp-start#hiderestart) | +| **GPO** | Not available. | + +hideshutdown +hidesleep \ No newline at end of file diff --git a/windows/configuration/start/includes/hide-shut-down.md b/windows/configuration/start/includes/hide-shut-down.md new file mode 100644 index 0000000000..ff8957dcf0 --- /dev/null +++ b/windows/configuration/start/includes/hide-shut-down.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Shut down + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideShutDown](/windows/client-management/mdm/policy-csp-start#hideshutdown) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-signout.md b/windows/configuration/start/includes/hide-signout.md new file mode 100644 index 0000000000..9a6ef3d422 --- /dev/null +++ b/windows/configuration/start/includes/hide-signout.md @@ -0,0 +1,22 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Sign out + +With this policy setting you can remove the **Sign out** item from the Start menu and prevents users from restoring it: + +- If you enable this policy setting, the **Sign out** item doesn't appear in the Start menu +- If you disable or don't configure this policy setting, users can use the **Sign out** item in the Start menu + +> [!NOTE] +> +> This policy setting affects the Start menu only. It doesn't affect the **Sign out** item on the Windows Security dialog box that appears when you press CTRL+ALT+DEL, and it doesn't prevent users from using other methods to sign out. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideSignOut](/windows/client-management/mdm/policy-csp-start#hidesignout) | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove Logoff on the Start Menu** | diff --git a/windows/configuration/start/includes/hide-sleep.md b/windows/configuration/start/includes/hide-sleep.md new file mode 100644 index 0000000000..dd866139e3 --- /dev/null +++ b/windows/configuration/start/includes/hide-sleep.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Sleep + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideSleep](/windows/client-management/mdm/policy-csp-start#hidesleep) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-switch-account.md b/windows/configuration/start/includes/hide-switch-account.md new file mode 100644 index 0000000000..5bbe1c5e7a --- /dev/null +++ b/windows/configuration/start/includes/hide-switch-account.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Hide Switch account + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideSwitchAccount](/windows/client-management/mdm/policy-csp-start#hideswitchaccount) | +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/hide-user-tile.md b/windows/configuration/start/includes/hide-user-tile.md new file mode 100644 index 0000000000..18e35f9e1f --- /dev/null +++ b/windows/configuration/start/includes/hide-user-tile.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 10/30/2023 +ms.topic: include +--- + +### Hide User tile + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[HideUserTile](/windows/client-management/mdm/policy-csp-start#hideusertile)| +| **GPO** | Not available. | diff --git a/windows/configuration/start/includes/import-edge-assets.md b/windows/configuration/start/includes/import-edge-assets.md new file mode 100644 index 0000000000..c74bd471b5 --- /dev/null +++ b/windows/configuration/start/includes/import-edge-assets.md @@ -0,0 +1,13 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 10/30/2023 +ms.topic: include +--- + +### Import Edge assets + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[ImportEdgeAssets](/windows/client-management/mdm/policy-csp-start#importedgeassets)| +| **GPO** | Not available | diff --git a/windows/configuration/start/includes/prevent-changes-to-taskbar-and-start-menu-settings.md b/windows/configuration/start/includes/prevent-changes-to-taskbar-and-start-menu-settings.md new file mode 100644 index 0000000000..59b825838b --- /dev/null +++ b/windows/configuration/start/includes/prevent-changes-to-taskbar-and-start-menu-settings.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Prevent changes to Taskbar and Start Menu settings + +With this policy setting you can prevent changes to Taskbar and Start menu settings: + +- If you enable this policy setting, users can't change the Taskbar or Start properties +- If you disable or don't configure this policy setting, the Taskbar and Start Menu items are available from Settings on the Start menu + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Prevent changes to Taskbar and Start Menu Settings**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Prevent changes to Taskbar and Start Menu Settings**| diff --git a/windows/configuration/start/includes/prevent-users-from-customizing-their-start.md b/windows/configuration/start/includes/prevent-users-from-customizing-their-start.md new file mode 100644 index 0000000000..eeeaae273e --- /dev/null +++ b/windows/configuration/start/includes/prevent-users-from-customizing-their-start.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Prevent users from customizing their Start + +With this policy setting you can prevent users from changing their Start menu layout: + +- If you enable this setting, users can't pin/unpin a Start menu element, and rearrange elements +- If you disable or don't configure this setting, users can pin/unpin elements, and rearrange elements + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Prevent users from customizing their Start**| diff --git a/windows/configuration/start/includes/prevent-users-from-uninstalling-applications-from-start.md b/windows/configuration/start/includes/prevent-users-from-uninstalling-applications-from-start.md new file mode 100644 index 0000000000..53add991f5 --- /dev/null +++ b/windows/configuration/start/includes/prevent-users-from-uninstalling-applications-from-start.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Prevent users from uninstalling applications from Start + +If you enable this setting, users can't uninstall apps from Start. If you disable this setting or don't configure it, users can access the uninstall command from Start. + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Prevent users from uninstalling applications from Start**| diff --git a/windows/configuration/start/includes/remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands.md b/windows/configuration/start/includes/remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands.md new file mode 100644 index 0000000000..324fe427b0 --- /dev/null +++ b/windows/configuration/start/includes/remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Remove and prevent access to the Shut Down, Restart, Sleep, and Hibernate commands + +With this policy setting, you can prevent users from performing the following commands from the Windows security screen, the sign in screen, and the Start menu: Shut Down, Restart, Sleep, and Hibernate. This policy setting doesn't prevent users from running Windows-based programs that perform these functions: + +- If you enable this policy setting, the shutdown, restart, sleep, and hibernate commands are removed from the Start menu. The Power button is also removed from the Windows Security screen, which appears when you press CTRL+ALT+DELETE, and from the sign in screen +- If you disable or don't configure this policy setting, the Power button and the Shut Down, Restart, Sleep, and Hibernate commands are available on the Start menu. The Power button on the Windows Security and sign in screens is also available + +| | Path | +|--|--| +| **CSP** | Not available | +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**

**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove and prevent access to the Shut Down, Restart, Sleep, and Hibernate commands** | diff --git a/windows/configuration/start/includes/remove-common-program-groups.md b/windows/configuration/start/includes/remove-common-program-groups.md new file mode 100644 index 0000000000..3c0479536c --- /dev/null +++ b/windows/configuration/start/includes/remove-common-program-groups.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Remove common program groups + +This policy setting removes items in the *All Users* profile from the Programs menu on the Start menu. By default, the Programs menu contains items from the *All Users* profile and items from the user's profile. If you enable this setting, only items in the user's profile appear in the Programs menu. + +| | Path | +|--|--| +| **CSP** | Not available. | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Remove common program groups from Start Menu** | diff --git a/windows/configuration/start/includes/show-run-as-different-user-command.md b/windows/configuration/start/includes/show-run-as-different-user-command.md new file mode 100644 index 0000000000..edd8c3f2c4 --- /dev/null +++ b/windows/configuration/start/includes/show-run-as-different-user-command.md @@ -0,0 +1,18 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 04/10/2024 +ms.topic: include +--- + +### Show *Run as different user* command + +With this policy setting, you can hide the *Run as different user* command on the Start application bar. If you enable it, users can access the **Run as different user** command from Start. If you disable or don't configure this setting, users can't access the **Run as different user** command from Start for any applications. + +> [!NOTE] +> This setting doesn't prevent users from using other methods, such as the SHIFT right-click menu on application's jumplists in the taskbar to issue the *Run as different user* command. + +| | Path | +|--|--| +| **CSP** | Not available | +| **GPO** | **User Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Show "Run as different user" command on Start** | diff --git a/windows/configuration/start/index.md b/windows/configuration/start/index.md new file mode 100644 index 0000000000..c78ef0401d --- /dev/null +++ b/windows/configuration/start/index.md @@ -0,0 +1,85 @@ +--- +title: Configure the Start menu +description: Learn how to configure the Windows Start menu to provide quick access to the tools and applications that users need most. +ms.topic: overview +ms.date: 04/10/2024 +zone_pivot_groups: windows-versions-11-10 +appliesto: +--- + +# Configure the Start menu + +The Windows Start menu is a pivotal element in the Windows operating system, serving as a central hub for launching applications and managing tasks. For organizations, the ability to configure the Start menu's behavior through policy settings can be highly beneficial, particularly in environments where certain roles or functions necessitate tailored access to applications and tools. + +For instance, in kiosk settings, organizations can configure the Start menu to limit access to a single application or a specific set of applications, ensuring that the kiosk serves its intended purpose without allowing for unnecessary or potentially disruptive interactions. This is useful in public spaces or in scenarios where devices are intended for a single function, such as information stands or check-in counters. + +Frontline workers, who often operate in fast-paced and dynamic environments, can benefit from a Start menu that is configured to provide quick access to the tools and applications they need most. This streamlined approach can enhance productivity and reduce the time spent navigating through unnecessary options. + +In educational settings, students can benefit from a Start menu that is customized to provide access to educational tools and resources while restricting distractions. By configuring policy settings, educational institutions can create a focused and conducive learning environment. + +## Start structure + +The Start menu structure consists five main areas, which you can configure to meet your organization's needs. These areas are as follows: + +:::row::: +:::column span="2"::: +::: zone pivot="windows-10" +1. **Start layout**: contains the arrangement of tiles that link to applications, folders, websites, or files +1. **All apps**: contains an alphabetical list of all installed applications. The list can include dynamic sections, such as *Most used* and *Recently added* +1. **Account**: contains links to change user account settings, sign out, lock the device, or switch user +1. **Pinned folders**: contains a customizable list of folders for quick access +1. **Power**: contains links to power options, such as shutdown, restart, and sleep +::: zone-end +::: zone pivot="windows-11" +1. **Start layout**: the *Pinned* section contains the arrangement of pins that link to applications, folders, websites, or files. The *Recommended* section is designed to enhance user productivity by providing quick access to frequently used apps, documents, or websites +1. **All apps**: contains an alphabetical list of all installed applications. The list can include dynamic sections, such as *Most used* and *Recently added* +1. **Account**: contains links to change user account settings, sign out, lock the device, or switch user +1. **Pinned folders**: contains a customizable list of folders for quick access +1. **Power**: contains links to power options, such as shutdown, restart, and sleep +::: zone-end +:::column-end::: +:::column span="2"::: +::: zone pivot="windows-10" + :::image type="content" source="./images/windows-10-settings.png" alt-text="Sample start menu layout with its components highlighted." border="false" lightbox="./images/windows-10-settings.png"::: +::: zone-end +::: zone pivot="windows-11" + :::image type="content" source="./images/windows-11-settings.png" alt-text="Sample start menu layout with its components highlighted." border="false" lightbox="./images/windows-11-settings.png"::: +::: zone-end + :::column-end::: +:::row-end::: + +## Configuration options + +There are several options to configure the Windows Start menu. + +If you need to configure a device for a single user, you can pin/unpin applications to Start and rearrange them. Start can be further customized from Settings. Go to **Settings** > **Personalization** > **[Start](ms-settings:personalization-start)**. + +For advanced customizations and when you need to configure multiple devices, you can use one of the following options: + +- Configuration Service Provider (CSP): commonly used for devices managed by a Mobile Device Management (MDM) solution, like Microsoft Intune. CSPs can also be configured with [provisioning packages](../provisioning-packages/how-it-pros-can-use-configuration-service-providers.md#csps-in-windows-configuration-designer), which are used at deployment time or for unmanaged devices. To configure Start, use the [Start Policy CSP][WIN-1] +- Group policy (GPO): used for devices that are Active Directory joined or Microsoft Entra hybrid joined, and not managed by a device management solution. Group policy can also be used for devices that aren't joined to an Active Directory domain, using the local group policy editor + +> [!NOTE] +> While many of the Start menu policy settings can be configured using both CSP and GPO, there are some settings that are only available using the Start Policy CSP. To learn about the available policy settings to configure the Start menu via CSP and GPO, see [Start menu policy settings](policy-settings.md). + +::: zone pivot="windows-10" +The configuration of the Start layout requires the use of an XML file that specifies the layout. To learn more about how to create and apply an XML file to configure the Start layout, see [Customize the Start layout](layout.md). +::: zone-end + +::: zone pivot="windows-11" +The configuration of the Start layout requires the use of a JSON file that specifies the layout. To learn more about how to create and apply a JSON file to configure the Start layout, see [Customize the Start layout](layout.md). + +> [!IMPORTANT] +> The JSON file can be applied to devices using the [Start policy CSP][WIN-1] only. It's not possible to apply the JSON file using group policy. +::: zone-end + +## Next steps + +In the next sections, you can learn more about the options available to configure Start menu settings using the Configuration Service Provider (CSP) and Group Policy (GPO): + +- [Customize the Start layout](layout.md) +- [Start menu policy settings](policy-settings.md) + + + +[WIN-1]: /windows/client-management/mdm/policy-csp-start \ No newline at end of file diff --git a/windows/configuration/start/layout.md b/windows/configuration/start/layout.md new file mode 100644 index 0000000000..32c9952e4a --- /dev/null +++ b/windows/configuration/start/layout.md @@ -0,0 +1,694 @@ +--- +title: Customize the Start layout +description: Learn how to customize the Windows Start layout, export its configuration, and deploy the customization to other devices. +ms.topic: how-to +ms.date: 04/10/2024 +zone_pivot_groups: windows-versions-11-10 +appliesto: +--- + +# Customize the Start layout + +Implementing a customized Start layout across your organization's devices empowers administrators with direct control over the Start menu configuration. With this capability, you can specify a tailored set of pinned applications, arranged according to preference. Utilize this feature to strategically pin desired apps, eliminate default pinned apps, and organize the application display to align with operational requirements. + +This article describes how to customize the Start layout, export its configuration, and deploy the customization to other devices. + +> [!NOTE] +> If you are looking for OEM information, see the article [Customize the Start layout](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). + +## Customization process + +To customize the Windows Start layout and deploy its configuration to other devices, follow these steps: + +1. Configure the Start layout to meet your requirements from a reference device +1. Export the Start layout configuration to a configuration file +1. Deploy the configuration file using one of the available options + +> [!TIP] +> While you can create your own configuration file, it's easier and faster to export the layout from an existing device. + +### Customize the Start layout on a reference device + +To prepare a Start layout for export, customize the Start layout on a reference device. To prepare a reference device: + +1. Set up a device on which to customize the Start layout, which should have the operating system that is installed on the users' devices +1. Install all apps and services that the Start layout should display +1. Create a new user account that you use to customize the Start layout + +To customize Start: + +::: zone pivot="windows-10" + +1. Sign in to the reference device with the user account that you created +1. Customize the Start layout as you want users to see it by using the following techniques: + + - **Pin apps to Start**. From Start, type the name of the app. When the app appears in the search results, right-click the app and select **Pin to Start** + To view all apps, select **All apps**. Right-click any app, and pin or unpin it from Start + - **Unpin apps** that you don't want to display. To unpin an app, right-click the app, and then select **Unpin from Start** + - **Drag existing apps** on Start to reorder or group them + - **Resize tiles**. To resize tiles, right-click the tile and then select **Resize** + - **Create your own app groups**. Drag the apps to an empty area. To name a group, select above the group of tiles and then type the name in the **Name group** field that appears above the group + +> [!IMPORTANT] +> If the Start layout includes tiles for apps that are not installed on the target device, the tiles for those apps will be blank. The blank tiles persist until the next time the user signs in, at which time the blank tiles are removed. + +::: zone-end + +::: zone pivot="windows-11" + +1. Sign in to the reference device with the user account that you created +1. Customize the **Pinned** section of the Start layout as you want users to see it by using the following techniques: + + - **Pin apps to Start**. From Start, type the name of the app. When the app appears in the search results, right-click the app and select **Pin to Start** + To view all apps, select **All apps**. Right-click any app, and pin or unpin it from Start + - **Unpin apps** that you don't want to display. To unpin an app, right-click the app, and then select **Unpin from Start** + - **Drag existing apps** on Start to reorder them + +> [!IMPORTANT] +> If the Start layout includes pins for apps that aren't installed on the target device, the pins for those apps aren't created until the apps are installed. + +::: zone-end + +### Export the Start layout configuration + +Once the Start layout is configured to meet your requirements, use the Windows PowerShell [Export-StartLayout][PS-1] cmdlet to export the existing layout to a configuration file. + +::: zone pivot="windows-10" +The exported customization consists of an XML file containing a list of tiles that define the Start layout. + +> [!NOTE] +> You can find the default Start layout template in `%LOCALAPPDATA%\Microsoft\windows\Shell\DefaultLayouts.xml`. + +To export the Start layout to an XML file: + +1. While signed in with the same account that you used to customize Start, create a folder to save the `.xml` file. For example, create the `C:\Layouts` folder +1. Open Windows PowerShell +1. Run the following cmdlet: + + ```powershell + Export-StartLayout -UseDesktopApplicationID -Path "C:\Layouts\LayoutModification.xml" + ``` + +1. (Optional) Edit the XML file to add [a taskbar configuration](../taskbar/configure.md) or to make any modifications to the Start layout + +::: zone-end + +::: zone pivot="windows-11" + +The exported customization consists of a JSON file containing a list of pins that define the Start layout. + +To export the Start layout to a JSON file: + +1. While signed in with the same account that you used to customize Start, create a folder to save the `.json` file. For example, create the `C:\Layouts` folder +1. Open Windows PowerShell +1. Run the following cmdlet: + + ```powershell + Export-StartLayout -Path "C:\Layouts\LayoutModification.json" + ``` + +::: zone-end + +### Start layout example + +Here you can find an example of Start layout that you can use as a reference: + +[!INCLUDE [example-start-layout](includes/example-start-layout.md)] + +### Change the configuration file + +::: zone pivot="windows-10" + +> [!CAUTION] +> When you make changes to the exported layout, be aware that the XML file must adhere to an [XML schema definition (XSD)](xsd.md). +> +> The XML file requires the following order for tags directly under the `LayoutModificationTemplate` node: +> +> 1. `LayoutOptions` +> 1. `DefaultLayoutOverride` +> 1. `RequiredStartGroupsCollection` +> 1. `AppendDownloadOfficeTile` - OR - `AppendOfficeSuite` (only one Office option can be used at a time) +> 1. `AppendOfficeSuiteChoice` +> 1. `TopMFUApps` +> 1. `CustomTaskbarLayoutCollection` +> 1. `InkWorkspaceTopApps` +> 1. `StartLayoutCollection` +> +> Comments are not supported in the `LayoutModification.xml` file. + +> [!NOTE] +> `RequiredStartGroupsCollection` and `AppendGroup` syntax only apply when the `Import-StartLayout` method is used for building and deploying Windows images. + +You can edit the XML file to make any modifications to the Start layout. For example, you can include `` to include the Taskbar customization. + +If the Start layout that you export contains tiles for desktop apps or URL links, `Export-StartLayout` uses `DesktopApplicationLinkPath` in the resulting file. Use a text or XML editor to change `DesktopApplicationLinkPath` to `DesktopApplicationID`. + +For scripts and application tile pins to work correctly, follow these rules: + +- Executable files and scripts should be listed in `%ProgramFiles%` or wherever the installer of the app places them +- Shortcuts that pin to Start should be placed in `%ProgramData%\Microsoft\Windows\Start Menu\Programs` +- If you place executable files or scripts in the `%ProgramData%\Microsoft\Windows\Start Menu\Programs` folder, they don't pin to Start + +> [!NOTE] +> All devices that you apply the Start layout to, must have the apps and other shortcuts present on the local system in the same location as the source for the Start layout. + +After you export the layout, decide whether you want to apply a *full* Start layout or a *partial* Start layout: + +- When a full Start layout is applied, the users can't pin, unpin, or uninstall apps from Start. Users can view and open all apps in the **All Apps** view, but they can't pin any apps to Start +- When a partial Start layout is applied, the contents of the specified tile groups can't be changed, but users can move those groups, and can also create and customize their own groups + +### Supported elements and attributes + +| Element | Description | +|--|--| +| `LayoutModificationTemplate` | Use to describe the changes to the default Start layout | +| [LayoutOptions](#layoutoptions) | Use to specify:
- Whether to use full screen Start on the desktop
- The number of tile columns in the Start menu | +| `RequiredStartGroupsCollection` | Use to contain collection of `RequiredStartGroups` | +| [RequiredStartGroups](#requiredstartgroups) | Use to contain the `AppendGroup` tags, which represent groups that can be appended to the default Start layout | +| [AppendGroup](#appendgroup) | Use to specify the tiles that need to be appended to the default Start layout | +| [start:Tile](#specify-start-tiles) | Use to specify a UWP app | +| `start:Folder`| Use to specify a folder of icons; can include [Tile](#starttile), [SecondaryTile](#startsecondarytile), and [DesktopApplicationTile](#startdesktopapplicationtile) | +| [start:DesktopApplicationTile](#startdesktopapplicationtile) | Use to specify any of the following:
- A Windows desktop application with a known AppUserModelID
- An application in a known folder with a link in a legacy Start Menu folder
- A Windows desktop application link in a legacy Start Menu folder
- A Web link tile with an associated `.url` file that is in a legacy Start Menu folder | +| [start:SecondaryTile](#startsecondarytile) | Use to pin a Web link through a Microsoft Edge secondary tile | +| [AppendOfficeSuite](#appendofficesuite) | Use to add the in-box installed Office suite to Start. For more information, see [Customize the Office suite of tiles](/windows-hardware/customize/desktop/customize-start-layout#customize-the-office-suite-of-tiles).

Don't use this tag with `AppendDownloadOfficeTile` | +| [AppendDownloadOfficeTile](#appenddownloadofficetile) | Use to add a specific **Download Office** tile to a specific location in Start

Do not use this tag with `AppendOfficeSuite` | + +#### LayoutOptions + +New devices running Windows 10 for desktop editions default to a Start menu with two columns of tiles unless boot to tablet mode is enabled. Devices with screens that are under 10" have boot to tablet mode enabled by default. For these devices, users see the full screen Start on the desktop. You can adjust the following features: + +- Boot to tablet mode can be set on or off +- Set full screen Start on desktop to on or off + To do this, add the `LayoutOptions` element in your LayoutModification.xml file and set the FullScreenStart attribute to true or false +- Specify the number of columns in the Start menu to 1 or 2 + To do this, add the `LayoutOptions` element in your LayoutModification.xml file and set the StartTileGroupsColumnCount attribute to 1 or 2 + +The following example shows how to use the `LayoutOptions` element to specify full screen Start on the desktop and to use one column in the Start menu: + +```xml + +``` + +#### RequiredStartGroups + +The `RequiredStartGroups` tag contains `AppendGroup` tags that represent groups that you can append to the default Start layout. + +The groups have the following constraints: + +- Two groups that are six columns wide, or equivalent to the width of three medium tiles +- Two medium-sized tile rows in height. Windows ignores any tiles that are pinned beyond the second row +- No limit to the number of apps that can be pinned. There's a theoretical limit of 24 tiles per group (four small tiles per medium square x three columns x two rows) + +>[!IMPORTANT] +>You can add a maximum of two `AppendGroup` tags per `RequiredStartGroups` tag. + +You can also assign regions to the append groups in the `RequiredStartGroups` tag's using the optional `Region` attribute or you can use the multivariant capabilities in Windows provisioning. If you're using the `Region` attribute, you must use a two-letter country code to specify the country/region that the append group(s) apply to. To specify more than one country/region, use a pipe (`|`) delimiter as shown in the following example: + +```XML + +``` + +- If the country/region setting for the Windows device matches a `RequiredStartGroups`, then the tiles laid out within the `RequiredStartGroups` is applied to Start +- If you specify a region-agnostic `RequiredStartGroups` (or one without the optional Region attribute), then the region-agnostic `RequiredStartGroups` is applied to Start + +#### AppendGroup + +`AppendGroup` tags specify a group of tiles to append to Start. There's a maximum of two `AppendGroup` tags allowed per `RequiredStartGroups` tag. + +For Windows 10 for desktop editions, AppendGroup tags contain `start:Tile`, `start:DesktopApplicationTile`, or `start:SecondaryTile` tags. + +You can specify any number of tiles in an `AppendGroup`, but you can't specify a tile with a `Row` attribute greater than one. The Start layout doesn't support overlapping tiles. + +#### Specify Start tiles + +To pin tiles to Start, partners must use the right tile depending on what you want to pin. + +#### Tile size and coordinates + +All tile types require a size (`Size`) and coordinates (`Row` and `Column`) attributes, regardless of the tile type that you use when prepinning items to Start. + +The following table describes the attributes that you must use to specify the size and location for the tile. + +| Attribute | Description | +| --- | --- | +| `Size` | Determines how large the tile is.

- 1x1 - small tile
- 2x2 - medium tile
- 4x2 - wide tile
- 4x4 - large tile | +| `Row` | Specifies the row where the tile appears. | +| `Column` | Specifies the column where the tile appears. | + +For example, a tile with `Size="2x2"`, `Row="2"`, and `Column="2"` results in a tile located at (2,2) where (0,0) is the top-left corner of a group. + +#### start:Tile + +You can use the `start:Tile` tag to pin a UWP app to Start. You must set the `AppUserModelID` attribute to the application user model ID (AUMID) of the corresponding app. + +#### start:DesktopApplicationTile + +You can use the `start:DesktopApplicationTile` tag to pin a Windows desktop application to Start. There are two ways you can specify a Windows desktop application: + +- Use a path to a shortcut link (.lnk file) to a Windows desktop application. + + >[!NOTE] + >Use `DesktopApplicationID` rather than `DesktopApplicationLinkPath` if the application is installed after the user's first sign-in. + + To pin a Windows desktop application through this method, you must first add the `.lnk` file in the specified location when the device first boots. + + The following example shows how to pin the Command Prompt: + + ```XML + + ``` + + You must set the `DesktopApplicationLinkPath` attribute to the .lnk file that points to the Windows desktop application. The path also supports environment variables. + + If you're pointing to a third-party Windows desktop application and the layout is being applied before the first boot, you must put the `.lnk` file in a legacy Start Menu directory before first boot. For example, `%APPDATA%\Microsoft\Windows\Start Menu\Programs\` or the all users profile `%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\`. + +- Use the AUMID, if this is known. If the Windows desktop application doesn't have one, use the shortcut link option. + +Learn how to [Find the Application User Model ID of an installed app](../store/find-aumid.md). + + The following example shows how to pin the File Explorer Windows desktop application: + + ```XML + + ``` + +You can also use the `start:DesktopApplicationTile` tag as one of the methods for pinning a Web link to Start. The other method is to use a Microsoft Edge secondary tile. + +To pin a legacy `.url` shortcut to Start, you must create a `.url` file (right-click on the desktop, select **New** > **Shortcut**, and then type a Web URL). You must add this `.url` file in a legacy Start Menu directory before first boot; for example, `%APPDATA%\Microsoft\Windows\Start Menu\Programs\` or the all users profile `%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\`. + +The following example shows how to create a tile of the Web site's URL, which you can treat similarly to a Windows desktop application tile: + +```XML + +``` + +>[!NOTE] +>In Windows 10, version 1703, `Export-StartLayout` will use `DesktopApplicationLinkPath` for the .url shortcut. You must change `DesktopApplicationLinkPath` to `DesktopApplicationID` and provide the URL. + +#### start:SecondaryTile + +You can use the **start:SecondaryTile** tag to pin a Web link through a Microsoft Edge secondary tile. This method doesn't require more actions compared to the method of using legacy `.url` shortcuts (through the start:DesktopApplicationTile tag). + +The following example shows how to create a tile of the Web site's URL using the Microsoft Edge secondary tile: + +```XML + +``` + +The following table describes the other attributes that you can use with the `start:SecondaryTile` tag in addition to `Size`, `Row`, and `Column`. + +| Attribute | Required/optional | Description | +| --- | --- | --- | +| `AppUserModelID` | Required | Must point to Microsoft Edge. | +| `TileID` | Required | Must uniquely identify your Web site tile. | +| `Arguments` | Required | Must contain the URL of your Web site. | +| `DisplayName` | Required | Must specify the text that you want users to see. | +| `Square150x150LogoUri` | Required | Specifies the logo to use on the 2x2 tile. | +| `Wide310x150LogoUri` | Optional | Specifies the logo to use on the 4x2 tile. | +| `ShowNameOnSquare150x150Logo` | Optional | Specifies whether the display name is shown on the 2x2 tile. The values you can use for this attribute are true or false. | +| `ShowNameOnWide310x150Logo` | Optional | Specifies whether the display name is shown on the 4x2 tile. The values you can use for this attribute are true or false. | +| `BackgroundColor` | Optional | Specifies the color of the tile. You can specify the value in ARGB hexadecimal (for example, `#FF112233`) or specify `transparent`. | +| `ForegroundText` | Optional | Specifies the color of the foreground text. Set the value to either `light` or `dark`. | + +Secondary Microsoft Edge tiles have the same size and location behavior as a Universal Windows app, Windows 8 app, or Windows 8.1 app. + +#### AppendOfficeSuite + +You can use the `AppendOfficeSuite` tag to add the in-box installed Office suite of apps to Start. + +>[!NOTE] +>The OEM must have installed Office for this tag to work. + +The following example shows how to add the `AppendOfficeSuite` tag to your `LayoutModification.xml` file to append the Office suite to Start: + +```XML + + + +``` + +#### AppendOfficeSuiteChoice + +You have two options in this tag: + +- `` +- `` + +Use `Choice=DesktopBridgeSubscription` on devices that have Office 365 preinstalled. This sets the heading of the Office suite of tiles to `Office 365`, to highlight the Office 365 apps that you've made available on the device. + +Use `Choice=DesktopBridge` on devices shipping with [perpetual licenses for Office](/archive/blogs/ausoemteam/choosing-the-right-office-version-for-your-customers). This sets the heading of the Office suite of tiles to **Create**. + +For more information, see [Customize the Office suite of tiles](/windows-hardware/customize/desktop/customize-start-layout#customize-the-office-suite-of-tiles). + +#### AppendDownloadOfficeTile + +You can use the `AppendDownloadOfficeTile` tag to append the Office trial installer to Start. This tag adds the **Download Office** tile to Start and the download tile will appear at the bottom right-hand side of the second group. + +>[!NOTE] +>The OEM must have installed the Office trial installer for this tag to work. + +The following example shows how to add the `AppendDownloadOfficeTile` tag to your LayoutModification.xml file: + +```XML + + + +``` + +#### Configure a partial Start layout + +:::row::: +:::column span="2"::: + +A partial Start layout enables you to add one or more customized tile groups to users' Start screens or menus, while still allowing users to make changes to other parts of the Start layout. All groups that you add are *locked*, meaning users can't change the contents of those tile groups, however users can change the location of those groups. Locked groups are identified with an icon, as shown in the following image. + +:::column-end::: +:::column span="2"::: + +:::image type="content" source="images/windows-10-partial-layout.png" alt-text="Screenshot of the Windows 10 Start menu with partial layout." lightbox="images/windows-10-partial-layout.png"::: + +:::column-end::: +:::row-end::: + +When a partial Start layout is applied for the first time, the new groups are added to the users' existing Start layouts. If an app tile is in both an existing group and in a new locked group, the duplicate app tile is removed from the existing (unlocked) group. + +If you apply a partial Start layout to a device with an existing Start layout applied, groups that were added previously are removed, and the groups in the new layout are added. + +> [!NOTE] +> If you remove the policy setting, the groups remain on the devices but become unlocked. + +To configure a partial Start screen layout, modify the `` element as follows: + +```xml + +``` + +::: zone-end + +::: zone pivot="windows-11" + +You can edit the JSON file to make any modifications to the **Pinned** section of the Start layout. For example, you can change the order of the pinned elements, or add new apps. + +1. Open the `LayoutModification.json` file in a JSON editor, such as Visual Studio Code or Notepad +1. The `pinnedList` section includes all the pins that are applied to the Start layout + +You can add more apps to the section using the following keys: + +| Key | Description | +|--|--| +| `packagedAppID` | Used for Universal Windows Platform (UWP) apps. To pin a UWP app, use the app's AUMID. | +| `desktopAppID` | Used for desktop apps. To pin a desktop app, use the app's AUMID. If the app doesn't have an AUMID, use the `desktopAppLink` instead. | +| `desktopAppLink` | Used for desktop apps that don't have an associated AUMID. To pin this type of app, use the path to the `.lnk` shortcut that points to the app. | + +::: zone-end + +Learn how to [Find the Application User Model ID of an installed app](../store/find-aumid.md). + +### Deploy the Start layout configuration + +[!INCLUDE [tab-intro](../../../includes/configure/tab-intro.md)] + +::: zone pivot="windows-10" + +#### [:::image type="icon" source="../images/icons/intune.svg"::: **Intune/CSP**](#tab/intune-10) + +To configure devices with Microsoft Intune, [create a Settings catalog policy](/mem/intune/configuration/settings-catalog) and use one of the following settings: + +| Category | Setting name | Value | +|--|--|--| +| **Start** | Start Layout | Content of the XML file| +| **Start** | Start Layout (User) | Content of the XML file| + +[!INCLUDE [intune-settings-catalog-2](../../../includes/configure/intune-settings-catalog-2.md)] + +Alternatively, you can configure devices using a [custom policy][MEM-1] with the [Start CSP][WIN-1]. Use one of the following settings: + +| Setting | +|--| +| - **OMA-URI:** `./User/Vendor/MSFT/Policy/Config/Start/`[StartLayout](/windows/client-management/mdm/policy-csp-Start#startlayout)
- **String:**
- **Value:** content of the XML file | +| - **OMA-URI:** `./Device/Vendor/MSFT/Policy/Config/Start/`[StartLayout](/windows/client-management/mdm/policy-csp-Start#startlayout)
- **Data type:**
- **Value:** content of the XML file | + +[!INCLUDE [intune-custom-settings-2](../../../includes/configure/intune-custom-settings-2.md)] + +#### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg-10) + +[!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)] + +- **Path:** `Policies/Start/StartLayout` +- **Value:** content of the XML file + +> [!NOTE] +> The content of the file must be entered as a single line in the `Value` field. Use a text editor to remove any line breaks from the XML file, usually with a function called *join lines*. + +[!INCLUDE [provisioning-package-2](../../../includes/configure/provisioning-package-2.md)] + +### Use Windows Provisioning multivariant support + +The Windows Provisioning multivariant capability allows you to declare target conditions that, when met, supply specific customizations for each variant condition. For Start customization, you can create specific layouts for each variant that you have. To do this, you must create a separate LayoutModification.xml file for each variant that you want to support and then include these in your provisioning package. For more information on how to do this, see [Create a provisioning package with multivariant settings](../provisioning-packages/provisioning-multivariant.md). + +The provisioning engine chooses the right customization file based on the target conditions that were met, adds the file in the location that's specified for the setting, and then uses the specific file to customize Start. To differentiate between layouts, you can add modifiers to the LayoutModification.xml filename such as "LayoutCustomization1". Regardless of the modifier that you use, the provisioning engine will always output "LayoutCustomization.xml" so that the operating system has a consistent file name to query against. + +For example, if you want to ensure that there's a specific layout for a certain condition, you can: + +1. Create a specific layout customization file and then name it LayoutCustomization1.xml +1. Include the file as part of your provisioning package +1. Create your multivariant target and reference the XML file within the target condition in the main customization XML file + +The following example shows what the overall customization file might look like with multivariant support for Start: + +```XML + + + + {6aaa4dfa-00d7-4aaa-8adf-73c6a7e2501e} + My Provisioning Package + 1.0 + OEM + 50 + + + + + + + + + + + + + + + + + 1 + 1 + 1 + + + 1 + + + + + + + + + c:\users\\appdata\local\Microsoft\Windows\Shell\LayoutCustomization1.XML + + 1 + + + + + + +``` + +When the condition is met, the provisioning engine takes the XML file and places it in the location that the operating system has set and then the Start subsystem reads the file and applies the specific customized layout. + +You must repeat this process for all variants that you want to support so that each variant can have a distinct layout for each of the conditions and targets that need to be supported. For example, if you add a `Language` condition, you can create a Start layout that has its own localized group. + +#### [:::image type="icon" source="../images/icons/group-policy.svg"::: **GPO**](#tab/gpo) + +To configure a device with group policy, use the [Local Group Policy Editor](/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc731745(v=ws.10)). To configure multiple devices joined to Active Directory, [create or edit](/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc754740(v=ws.11)) a group policy object (GPO) and use one of the following settings: + +| Group policy path | Group policy setting | Value | +| - | - | - | +|**Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**| Start Layout | Path to the XML file | +|**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar**| Start Layout | Path to the XML file | + +[!INCLUDE [gpo-settings-2](../../../includes/configure/gpo-settings-2.md)] + +The GPO applies the Start and taskbar layout at the next user sign-in. Each time the user signs in, the timestamp of the .xml file with the Start and taskbar layout is checked and if a newer version of the file is available, the settings in the latest version of the file are applied. + +--- + +>[!NOTE] +>You can apply a Start layout to a mounted Windows image, with the PowerShell [Import-StartLayout](/powershell/module/startlayout/import-startlayout) cmdlet. +>Don't include XML Prologs like \ in the Start layout XML file. + +::: zone-end + +::: zone pivot="windows-11" + +> [!IMPORTANT] +> The JSON file can be applied to devices using the [Start policy CSP][WIN-1] only. It's not possible to apply the JSON file using group policy. + +#### [:::image type="icon" source="../images/icons/intune.svg"::: **Intune/CSP**](#tab/intune-11) + +To configure devices with Microsoft Intune, [create a Settings catalog policy](/mem/intune/configuration/settings-catalog) and use one of the following settings: + +| Category | Setting name | Value | +|--|--|--| +| **Start** | Configure Start Pins | Content of the JSON file| +| **Start** | Configure Start Pins (User) | Content of the JSON file| + +[!INCLUDE [intune-settings-catalog-2](../../../includes/configure/intune-settings-catalog-2.md)] + +Alternatively, you can configure devices using a [custom policy][MEM-1] with the [Start CSP][WIN-1]. Use one of the following settings: + +| Setting | +|--| +| - **OMA-URI:** `./User/Vendor/MSFT/Policy/Config/Start/`[ConfigureStartPins](/windows/client-management/mdm/policy-csp-Start#configurestartpins)
- **String:**
- **Value:** content of the JSON file | +| - **OMA-URI:** `./Device/Vendor/MSFT/Policy/Config/Start/`[ConfigureStartPins](/windows/client-management/mdm/policy-csp-Start#configurestartpins)
- **Data type:**
- **Value:** content of the JSON file | + +[!INCLUDE [intune-custom-settings-2](../../../includes/configure/intune-custom-settings-2.md)] + +#### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg-11) + +[!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)] + +- **Path:** `Policies/Start/ConfigureStartPins` +- **Value:** content of the JSON file + +> [!NOTE] +> The content of the file must be entered as a single line in the `Value` field. Use a text editor to remove any line breaks from the JSON file, usually with a function called *join lines*. + +[!INCLUDE [provisioning-package-2](../../../includes/configure/provisioning-package-2.md)] + +--- + +::: zone-end + +## User experience + +:::row::: +:::column span="2"::: + +After the settings are applied, sign in to the device. The Start layout that you configured is applied to the Start menu. + +::: zone pivot="windows-10" + +When a full Start layout is applied with policy settings, users can't pin, unpin, or uninstall apps from Start. Users can view and open all apps in the **All Apps** view, but they can't change the Start layout. When you apply a partial Start layout, the content of the specified tile groups can't be changed, but users can move the groups, and can create and customize their own groups. + +::: zone-end + +::: zone pivot="windows-11" + +When you configure the Start layout with policy settings, you overwrite the entire layout. Users can change the order of the pinned elements, pin, or unpin items. When a user signs in again, the Start layout specified in the policy setting is reapplied, without retaining any user changes. + +::: zone-end + +:::column-end::: +:::column span="2"::: +::: zone pivot="windows-10" + :::image type="content" source="images/windows-10.png" alt-text="Screenshot of the Windows 10 Start menu." border="false" lightbox="images/windows-10.png"::: +::: zone-end + +::: zone pivot="windows-11" + :::image type="content" source="images/windows-11.png" alt-text="Screenshot of the Windows 11 Start menu." border="false" lightbox="images/windows-11.png"::: +::: zone-end + +:::column-end::: +:::row-end::: + +## Next steps + +- To learn more about the policy settings available to configure the Start menu using the Configuration Service Provider (CSP) and Group Policy (GPO), see [Start menu policy settings](policy-settings.md). +- To learn how to configure the taskbar, see [Configure the Windows taskbar](../taskbar/index.md). + + + +[MEM-1]: /mem/intune/configuration/custom-settings-windows-10 +[PS-1]: /powershell/module/startlayout/export-startlayout +[WIN-1]: /windows/client-management/mdm/policy-csp-start + + + diff --git a/windows/configuration/start/policy-settings.md b/windows/configuration/start/policy-settings.md new file mode 100644 index 0000000000..f978ff31a8 --- /dev/null +++ b/windows/configuration/start/policy-settings.md @@ -0,0 +1,195 @@ +--- +title: Start policy settings +description: Learn about the policy settings to configure the Windows Start menu. +ms.topic: reference +ms.date: 04/10/2024 +appliesto: +zone_pivot_groups: windows-versions-11-10 +--- + +# Start menu policy settings + +This reference article outlines the policy settings available for customizing the Start menu experience, using Configuration Service Provider (CSP) or group policy (GPO). For information about how to configure these settings, see [Configure the Start menu](index.md). + +The settings are categorized and presented in alphabetical order to facilitate navigation and configuration. + +:::row::: +:::column span="2"::: + +1. **Start layout**: settings to control the Start menu appearance and its behavior +1. **All apps options**: settings to control the All apps list +1. **Account options**: settings to control the options exposed when selecting the user account icon +1. **Pinned folders**: settings to control the folders pinned for quick access +1. **Power options**: settings to control the options exposed when selecting the power button + +:::column-end::: +:::column span="2"::: +::: zone pivot="windows-10" + :::image type="content" source="./images/windows-10-settings.png" alt-text="Sample start menu layout with its components highlighted." border="false" lightbox="./images/windows-10-settings.png"::: +::: zone-end + +::: zone pivot="windows-11" + :::image type="content" source="./images/windows-11-settings.png" alt-text="Sample start menu layout with its components highlighted." border="false" lightbox="./images/windows-11-settings.png"::: +::: zone-end + + :::column-end::: +:::row-end::: + +Select one of the tabs to see the list of available settings: + +#### [:::image type="icon" source="../images/icons/start.svg"::: **Layout**](#tab/start) + +::: zone pivot="windows-11" +|Policy name| CSP | GPO | +|-|-|-| +|[Configure Start pins](#configure-start-pins)|✅|❌| +|[Disable context menus](#disable-context-menus)|✅|✅| +|[Disable search](#disable-search)|✅|✅| +|[Don't use the search-based method when resolving shell shortcuts](#dont-use-the-search-based-method-when-resolving-shell-shortcuts)|❌|✅| +|[Don't use the tracking-based method when resolving shell shortcuts](#dont-use-the-tracking-based-method-when-resolving-shell-shortcuts)|❌|✅| +|[Prevent changes to Taskbar and Start Menu Settings](#prevent-changes-to-taskbar-and-start-menu-settings)|❌|✅| +|[Prevent users from customizing their Start](#prevent-users-from-customizing-their-start)|❌|✅| +|[Prevent users from uninstalling applications from Start](#prevent-users-from-uninstalling-applications-from-start)|❌|✅| +|[Remove common program groups](#remove-common-program-groups)|❌|✅| +|[Show **Run as different user** command](#show-run-as-different-user-command)|❌|✅| + +### Recommended section + +|Policy name| CSP | GPO | +|-|-|-| +|[Clear history of recently opened documents on exit](#clear-history-of-recently-opened-documents-on-exit)|❌|✅| +|[Hide recently added apps](#hide-recently-added-apps)|✅|✅| +|[Hide recent jumplists](#hide-recent-jumplists)|✅|✅| +|[Hide recommended personalized sites](#hide-recommended-personalized-sites)|✅|✅| +|[Hide recommended section](#hide-recommended-section)|✅|✅| + +::: zone-end + +::: zone pivot="windows-10" +|Policy name| CSP | GPO | +|-|-|-| +|[Clear history of recently opened documents on exit](#clear-history-of-recently-opened-documents-on-exit)|❌|✅| +|[Clear tile notifications during log on](#clear-tile-notifications-during-log-on)|❌|✅| +|[Configure Start layout](#configure-start-layout)|✅|✅| +|[Disable context menus](#disable-context-menus)|✅|✅| +|[Don't use the search-based method when resolving shell shortcuts](#dont-use-the-search-based-method-when-resolving-shell-shortcuts)|❌|✅| +|[Don't use the tracking-based method when resolving shell shortcuts](#dont-use-the-tracking-based-method-when-resolving-shell-shortcuts)|❌|✅| +|[Force Start size](#force-start-size)|✅|✅| +|[Hide recently added apps](#hide-recently-added-apps)|✅|✅| +|[Import Edge assets](#import-edge-assets)|✅|❌| +|[Prevent changes to Taskbar and Start Menu Settings](#prevent-changes-to-taskbar-and-start-menu-settings)|❌|✅| +|[Prevent users from customizing their Start](#prevent-users-from-customizing-their-start)|❌|✅| +|[Prevent users from uninstalling applications from Start](#prevent-users-from-uninstalling-applications-from-start)|❌|✅| +|[Remove common program groups](#remove-common-program-groups)|❌|✅| +|[Show "Run as different user" command](#show-run-as-different-user-command)|❌|✅| +::: zone-end + +[!INCLUDE [clear-history-of-recently-opened-documents-on-exit](includes/clear-history-of-recently-opened-documents-on-exit.md)] +::: zone pivot="windows-10" +[!INCLUDE [clear-tile-notifications-during-log-on](includes/clear-tile-notifications-during-log-on.md)] +[!INCLUDE [configure-start-layout](includes/configure-start-layout.md)] +::: zone-end +::: zone pivot="windows-11" +[!INCLUDE [configure-start-pins](includes/configure-start-pins.md)] +::: zone-end +[!INCLUDE [disable-context-menus](includes/disable-context-menus.md)] +::: zone pivot="windows-11" +[!INCLUDE [disable-search](includes/disable-search.md)] +::: zone-end +[!INCLUDE [do-not-use-the-search-based-method-when-resolving-shell-shortcuts](includes/do-not-use-the-search-based-method-when-resolving-shell-shortcuts.md)] +[!INCLUDE [do-not-use-the-tracking-based-method-when-resolving-shell-shortcuts](includes/do-not-use-the-tracking-based-method-when-resolving-shell-shortcuts.md)] +::: zone pivot="windows-10" +[!INCLUDE [force-start-size](includes/force-start-size.md)] +::: zone-end +[!INCLUDE [hide-recently-added-apps](includes/hide-recently-added-apps.md)] +[!INCLUDE [hide-recent-jumplists](includes/hide-recent-jumplists.md)] +::: zone pivot="windows-11" +[!INCLUDE [hide-recommended-personalized-sites](includes/hide-recommended-personalized-sites.md)] +[!INCLUDE [hide-recommended-section](includes/hide-recommended-section.md)] +::: zone-end +::: zone pivot="windows-10" +[!INCLUDE [import-edge-assets](includes/import-edge-assets.md)] +::: zone-end +[!INCLUDE [prevent-changes-to-taskbar-and-start-menu-settings](includes/prevent-changes-to-taskbar-and-start-menu-settings.md)] +[!INCLUDE [prevent-users-from-customizing-their-start](includes/prevent-users-from-customizing-their-start.md)] +[!INCLUDE [prevent-users-from-uninstalling-applications-from-start](includes/prevent-users-from-uninstalling-applications-from-start.md)] +[!INCLUDE [remove-common-program-groups](includes/remove-common-program-groups.md)] +[!INCLUDE [show-run-as-different-user-command](includes/show-run-as-different-user-command.md)] + + +#### [:::image type="icon" source="../images/icons/allapps.svg"::: **All apps**](#tab/allapps) + +|Policy name| CSP | GPO | +|-|-|-| +|[Clear the recent programs list for new users](#clear-the-recent-programs-list-for-new-users)|❌|✅| +|[Hide app list](#hide-app-list)|✅|✅| +|[Hide frequently used apps](#hide-frequently-used-apps)|✅|✅| +|[Hide most used lists](#hide-most-used-lists)|✅|✅| + +[!INCLUDE [clear-the-recent-programs-list-for-new-users](includes/clear-the-recent-programs-list-for-new-users.md)] +[!INCLUDE [hide-app-list](includes/hide-app-list.md)] +[!INCLUDE [hide-frequently-used-apps](includes/hide-frequently-used-apps.md)] +[!INCLUDE [hide-most-used-lists](includes/hide-most-used-lists.md)] + +#### [:::image type="icon" source="../images/icons/user.svg"::: **Account options**](#tab/user) + +|Policy name| CSP | GPO | +|-|-|-| +|[Hide **Change account settings**](#hide-change-account-settings)|✅|❌| +|[Hide **Lock**](#hide-lock)|✅|❌| +|[Hide **Sign out**](#hide-sign-out)|✅|✅| +|[Hide **Switch account**](#hide-switch-account)|✅|❌| +|[Hide user tile](#hide-user-tile)|✅|❌| + +[!INCLUDE [hide-change-account-settings](includes/hide-change-account-settings.md)] +[!INCLUDE [hide-lock](includes/hide-lock.md)] +[!INCLUDE [hide-signout](includes/hide-signout.md)] +[!INCLUDE [hide-switch-user](includes/hide-switch-account.md)] +[!INCLUDE [hide-switch-user](includes/hide-user-tile.md)] + +#### [:::image type="icon" source="../images/icons/folder.svg"::: **Pinned folders**](#tab/folders) + +|Policy name| CSP | GPO | +|-|-|-| +|[Allow pinned folder Documents](#allow-pinned-folder-documents)|✅|❌| +|[Allow pinned folder Downloads](#allow-pinned-folder-downloads)|✅|❌| +|[Allow pinned folder File Explorer](#allow-pinned-folder-file-explorer)|✅|❌| +|[Allow pinned folder Home Group](#allow-pinned-folder-home-group)|✅|❌| +|[Allow pinned folder Music](#allow-pinned-folder-music)|✅|❌| +|[Allow pinned folder Network](#allow-pinned-folder-network)|✅|❌| +|[Allow pinned folder Personal Folder](#allow-pinned-folder-personal-folder)|✅|❌| +|[Allow pinned folder Pictures](#allow-pinned-folder-pictures)|✅|❌| +|[Allow pinned folder Settings](#allow-pinned-folder-settings)|✅|❌| +|[Allow pinned folder Videos](#allow-pinned-folder-videos)|✅|❌| + +[!INCLUDE [allow-pinned-folder-documents](includes/allow-pinned-folder-documents.md)] +[!INCLUDE [allow-pinned-folder-downloads](includes/allow-pinned-folder-downloads.md)] +[!INCLUDE [allow-pinned-folder-file-explorer](includes/allow-pinned-folder-file-explorer.md)] +[!INCLUDE [allow-pinned-folder-home-group](includes/allow-pinned-folder-home-group.md)] +[!INCLUDE [allow-pinned-folder-music](includes/allow-pinned-folder-music.md)] +[!INCLUDE [allow-pinned-folder-network](includes/allow-pinned-folder-network.md)] +[!INCLUDE [allow-pinned-folder-personal-folder](includes/allow-pinned-folder-personal-folder.md)] +[!INCLUDE [allow-pinned-folder-pictures](includes/allow-pinned-folder-pictures.md)] +[!INCLUDE [allow-pinned-folder-settings](includes/allow-pinned-folder-settings.md)] +[!INCLUDE [allow-pinned-folder-videos](includes/allow-pinned-folder-videos.md)] + +#### [:::image type="icon" source="../images/icons/power.svg"::: **Power options**](#tab/power) + +|Policy name| CSP | GPO | +|-|-|-| +|[Hide **Hibernate** ](#hide-hibernate)|✅|❌| +|[Hide **Power** button](#hide-power-button)|✅|❌| +|[Hide **Restart**](#hide-restart)|✅|❌| +|[Hide **Shut down**](#hide-shut-down)|✅|❌| +|[Hide **Sleep**](#hide-sleep)|✅|❌| +|[Remove and prevent access to the shut down restart sleep and hibernate commands](#remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands)|❌|✅| + +[!INCLUDE [hide-hibernate](includes/hide-hibernate.md)] +[!INCLUDE [hide-power-button](includes/hide-power-button.md)] +[!INCLUDE [hide-restart](includes/hide-restart.md)] +[!INCLUDE [hide-shut-down](includes/hide-shut-down.md)] +[!INCLUDE [hide-sleep](includes/hide-sleep.md)] + +[!INCLUDE [remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands](includes/remove-and-prevent-access-to-the-shut-down-restart-sleep-and-hibernate-commands.md)] + +--- diff --git a/windows/configuration/start/start-layout-xml-desktop.md b/windows/configuration/start/start-layout-xml-desktop.md deleted file mode 100644 index a0c742fc52..0000000000 --- a/windows/configuration/start/start-layout-xml-desktop.md +++ /dev/null @@ -1,526 +0,0 @@ ---- -title: Start layout XML for desktop editions of Windows 10 -description: This article describes the options for customizing Start layout in LayoutModification.xml for Windows 10 desktop editions. -ms.topic: reference -ms.date: 10/02/2018 -appliesto: -- ✅ Windows 10 ---- - -# Start layout XML for desktop editions of Windows 10 (reference) - ->**Looking for consumer information?** See [Customize the Start menu](https://go.microsoft.com/fwlink/p/?LinkId=623630) - -On Windows 10 for desktop editions, the customized Start works by: - -- Windows 10 checks the chosen base default layout, such as the desktop edition and whether Cortana is supported for the country/region. -- Windows 10 reads the LayoutModification.xml file and allows groups to be appended to Start. The groups have the following constraints: - - Two groups that are six columns wide, or equivalent to the width of three medium tiles. - - Two medium-sized tile rows in height. Windows 10 ignores any tiles that are pinned beyond the second row. - - No limit to the number of apps that can be pinned. There's a theoretical limit of 24 tiles per group (four small tiles per medium square x 3 columns x 2 rows). - ->[!NOTE] ->To use the layout modification XML to configure Start with roaming user profiles, see [Deploying Roaming User Profiles](/windows-server/storage/folder-redirection/deploy-roaming-user-profiles#step-7-optionally-specify-a-start-layout-for-windows-10-pcs). - -## LayoutModification XML - -IT admins can provision the Start layout using a LayoutModification.xml file. This file supports several mechanisms to modify or replace the default Start layout and its tiles. The easiest method for creating a LayoutModification.xml file is by using the Export-StartLayout cmdlet; see [Customize and export Start layout](customize-and-export-start-layout.md) for instructions. - -### Required order - -The XML schema for `LayoutModification.xml` requires the following order for tags directly under the LayoutModificationTemplate node: - -1. LayoutOptions -1. DefaultLayoutOverride -1. RequiredStartGroupsCollection -1. AppendDownloadOfficeTile - OR - AppendOfficeSuite (only one Office option can be used at a time) -1. AppendOfficeSuiteChoice -1. TopMFUApps -1. CustomTaskbarLayoutCollection -1. InkWorkspaceTopApps -1. StartLayoutCollection - -Comments are not supported in the `LayoutModification.xml` file. - -### Supported elements and attributes - ->[!NOTE] ->To make sure the Start layout XML parser processes your file correctly, follow these guidelines when working with your LayoutModification.xml file: -> ->- Do not leave spaces or white lines in between each element. ->- Do not add comments inside the StartLayout node or any of its children elements. ->- Do not add multiple rows of comments. - -The following table lists the supported elements and attributes for the LayoutModification.xml file. - -> [!NOTE] -> RequiredStartGroupsCollection and AppendGroup syntax only apply when the Import-StartLayout method is used for building and deploying Windows images. - -| Element | Attributes | Description | -| --- | --- | --- | -| LayoutModificationTemplate | xmlns
xmlns:defaultlayout
xmlns:start
Version | Use to describe the changes to the default Start layout | -| [LayoutOptions](#layoutoptions)

Parent:
LayoutModificationTemplate | StartTileGroupsColumnCount
FullScreenStart | Use to specify:
- Whether to use full screen Start on the desktop
- The number of tile columns in the Start menu | -| RequiredStartGroupsCollection

Parent:
LayoutModificationTemplate | n/a | Use to contain collection of RequiredStartGroups | -| [RequiredStartGroups](#requiredstartgroups)

Parent:
RequiredStartGroupsCollection | Region | Use to contain the AppendGroup tags, which represent groups that can be appended to the default Start layout | -| [AppendGroup](#appendgroup)

Parent:
RequiredStartGroups | Name | Use to specify the tiles that need to be appended to the default Start layout | -| [start:Tile](#specify-start-tiles)

Parent:
AppendGroup | AppUserModelID
Size
Row
Column | Use to specify any of the following:
- A Universal Windows app
- A Windows 8 or Windows 8.1 app

Note that AppUserModelID is case-sensitive. | -| start:Folder

Parent:
start:Group | Name (in Windows 10, version 1809 and later only)
Size
Row
Column
LocalizedNameResourcetag | Use to specify a folder of icons; can include [Tile](#start-tile), [SecondaryTile](#start-secondarytile), and [DesktopApplicationTile](#start-desktopapplicationtile). | -| start:DesktopApplicationTile

Parent:
AppendGroup | DesktopApplicationID
DesktopApplicationLinkPath
Size
Row
Column | Use to specify any of the following:
- A Windows desktop application with a known AppUserModelID
- An application in a known folder with a link in a legacy Start Menu folder
- A Windows desktop application link in a legacy Start Menu folder
- A Web link tile with an associated `.url` file that is in a legacy Start Menu folder | -| start:SecondaryTile

Parent:
AppendGroup | AppUserModelID
TileID
Arguments
DisplayName
Square150x150LogoUri
ShowNameOnSquare150x150Logo
ShowNameOnWide310x150Logo
Wide310x150LogoUri
BackgroundColor
ForegroundText
IsSuggestedApp
Size
Row
Column | Use to pin a Web link through a Microsoft Edge secondary tile. Note that AppUserModelID is case-sensitive. | -| TopMFUApps

Parent:
LayoutModificationTemplate | n/a | Use to add up to three default apps to the frequently used apps section in the system area.

**Note**: Only applies to versions of Windows 10 earlier than version 1701. In Windows 10, version 1709, you can no longer pin apps to the Most Frequently Used apps list in Start. | -| Tile

Parent:
TopMFUApps | AppUserModelID | Use with the TopMFUApps tags to specify an app with a known AppUserModelID.

**Note**: Only applies to versions of Windows 10 earlier than version 1701. In Windows 10, version 1709, you can no longer pin apps to the Most Frequently Used apps list in Start. | -| DesktopApplicationTile

Parent:
TopMFUApps | LinkFilePath | Use with the TopMFUApps tags to specify an app without a known AppUserModelID.

**Note**: Only applies to versions of Windows 10 earlier than version 1701. In Windows 10, version 1709, you can no longer pin apps to the Most Frequently Used apps list in Start. | -| AppendOfficeSuite

Parent:
LayoutModificationTemplate | n/a | Use to add the in-box installed Office suite to Start. For more information, see [Customize the Office suite of tiles](/windows-hardware/customize/desktop/customize-start-layout#customize-the-office-suite-of-tiles).

Don't use this tag with AppendDownloadOfficeTile. | -| AppendDownloadOfficeTile

Parent:
LayoutModificationTemplate | n/a | Use to add a specific **Download Office** tile to a specific location in Start

Do not use this tag with AppendOfficeSuite | - -### LayoutOptions - -New devices running Windows 10 for desktop editions will default to a Start menu with two columns of tiles unless boot to tablet mode is enabled. Devices with screens that are under 10" have boot to tablet mode enabled by default. For these devices, users see the full screen Start on the desktop. You can adjust the following features: - -- Boot to tablet mode can be set on or off -- Set full screen Start on desktop to on or off - To do this, add the LayoutOptions element in your LayoutModification.xml file and set the FullScreenStart attribute to true or false -- Specify the number of columns in the Start menu to 1 or 2 - To do this, add the LayoutOptions element in your LayoutModification.xml file and set the StartTileGroupsColumnCount attribute to 1 or 2 - -The following example shows how to use the LayoutOptions element to specify full screen Start on the desktop and to use one column in the Start menu: - -```XML - - - -``` - -For devices being upgraded to Windows 10 for desktop editions: - -- Devices being upgraded from Windows 7 will default to a Start menu with one column. -- Devices being upgraded from Windows 8.1 or Windows 8.1 Upgrade will default to a Start menu with two columns. - -### RequiredStartGroups - -The **RequiredStartGroups** tag contains **AppendGroup** tags that represent groups that you can append to the default Start layout. - ->[!IMPORTANT] ->For Windows 10 for desktop editions, you can add a maximum of two (2) **AppendGroup** tags per **RequiredStartGroups** tag. - -You can also assign regions to the append groups in the **RequiredStartGroups** tag's using the optional **Region** attribute or you can use the multivariant capabilities in Windows provisioning. If you're using the **Region** attribute, you must use a two-letter country code to specify the country/region that the append group(s) apply to. To specify more than one country/region, use a pipe ("|") delimiter as shown in the following example: - -```XML - -``` - -If the country/region setting for the Windows device matches a **RequiredStartGroups**, then the tiles laid out within the **RequiredStartGroups** is applied to Start. - -If you specify a region-agnostic **RequiredStartGroups** (or one without the optional Region attribute), then the region-agnostic **RequiredStartGroups** is applied to Start. - -### AppendGroup - -**AppendGroup** tags specify a group of tiles that will be appended to Start. There is a maximum of two **AppendGroup** tags allowed per **RequiredStartGroups** tag. - -For Windows 10 for desktop editions, AppendGroup tags contain start:Tile, start:DesktopApplicationTile, or start:SecondaryTile tags. - -You can specify any number of tiles in an **AppendGroup**, but you can't specify a tile with a **Row** attribute greater than 1. The Start layout doesn't support overlapping tiles. - -### Specify Start tiles - -To pin tiles to Start, partners must use the right tile depending on what you want to pin. - -#### Tile size and coordinates - -All tile types require a size (**Size**) and coordinates (**Row** and **Column**) attributes regardless of the tile type that you use when prepinning items to Start. - -The following table describes the attributes that you must use to specify the size and location for the tile. - -| Attribute | Description | -| --- | --- | -| Size | Determines how large the tile will be.

- 1x1 - small tile
- 2x2 - medium tile
- 4x2 - wide tile
- 4x4 - large tile | -| Row | Specifies the row where the tile will appear. | -| Column | Specifies the column where the tile will appear. | - -For example, a tile with Size="2x2", Row="2", and Column="2" results in a tile located at (2,2) where (0,0) is the top-left corner of a group. - - -#### start:Tile - -You can use the **start:Tile** tag to pin any of the following apps to Start: - -- A Universal Windows app -- A Windows 8 app or Windows 8.1 app - -To specify any one of these apps, you must set the **AppUserModelID** attribute to the application user model ID that's associated with the corresponding app. - ->[!IMPORTANT] ->**AppUserModelID** (AUMID) is case-sensitive. - -The following example shows how to pin the Microsoft Edge Universal Windows app: - - ```XML - - ``` - - -#### start:DesktopApplicationTile - -You can use the **start:DesktopApplicationTile** tag to pin a Windows desktop application to Start. There are two ways you can specify a Windows desktop application: - -- Use a path to a shortcut link (.lnk file) to a Windows desktop application. - - >[!NOTE] - >In Start layouts for Windows 10, version 1703, you should use **DesktopApplicationID** rather than **DesktopApplicationLinkPath** if you are using Group Policy or MDM to apply the start layout and the application was installed after the user's first sign-in. - - To pin a Windows desktop application through this method, you must first add the .lnk file in the specified location when the device first boots. - - The following example shows how to pin the Command Prompt: - - ```XML - - ``` - - You must set the **DesktopApplicationLinkPath** attribute to the .lnk file that points to the Windows desktop application. The path also supports environment variables. - - If you are pointing to a third-party Windows desktop application and the layout is being applied before the first boot, you must put the .lnk file in a legacy Start Menu directory before first boot; for example, "%APPDATA%\Microsoft\Windows\Start Menu\Programs\" or the all users profile "%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\". - -- Use the application's application user model ID, if this is known. If the Windows desktop application doesn't have one, use the shortcut link option. - - You can use the [Get-StartApps cmdlet](/powershell/module/startlayout/get-startapps) on a PC that has the application pinned to Start to obtain the app ID. - - To pin a Windows desktop application through this method, you must set the **DesktopApplicationID** attribute to the application user model ID that's associated with the corresponding app. - - The following example shows how to pin the File Explorer Windows desktop application: - - ```XML - - ``` - -You can also use the **start:DesktopApplicationTile** tag as one of the methods for pinning a Web link to Start. The other method is to use a Microsoft Edge secondary tile. - -To pin a legacy `.url` shortcut to Start, you must create a `.url` file (right-click on the desktop, select **New** > **Shortcut**, and then type a Web URL). You must add this `.url` file in a legacy Start Menu directory before first boot; for example, `%APPDATA%\Microsoft\Windows\Start Menu\Programs\` or the all users profile `%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\`. - -The following example shows how to create a tile of the Web site's URL, which you can treat similarly to a Windows desktop application tile: - -```XML - -``` - ->[!NOTE] ->In Windows 10, version 1703, **Export-StartLayout** will use **DesktopApplicationLinkPath** for the .url shortcut. You must change **DesktopApplicationLinkPath** to **DesktopApplicationID** and provide the URL. - - -#### start:SecondaryTile - -You can use the **start:SecondaryTile** tag to pin a Web link through a Microsoft Edge secondary tile. This method doesn't require any additional action compared to the method of using legacy `.url` shortcuts (through the start:DesktopApplicationTile tag). - -The following example shows how to create a tile of the Web site's URL using the Microsoft Edge secondary tile: - -```XML - -``` - -The following table describes the other attributes that you can use with the **start:SecondaryTile** tag in addition to **Size**, **Row**, and **Column**. - -| Attribute | Required/optional | Description | -| --- | --- | --- | -| AppUserModelID | Required | Must point to Microsoft Edge. Note that AppUserModelID is case-sensitive. | -| TileID | Required | Must uniquely identify your Web site tile. | -| Arguments | Required | Must contain the URL of your Web site. | -| DisplayName | Required | Must specify the text that you want users to see. | -| Square150x150LogoUri | Required | Specifies the logo to use on the 2x2 tile. | -| Wide310x150LogoUri | Optional | Specifies the logo to use on the 4x2 tile. | -| ShowNameOnSquare150x150Logo | Optional | Specifies whether the display name is shown on the 2x2 tile. The values you can use for this attribute are true or false. | -| ShowNameOnWide310x150Logo | Optional | Specifies whether the display name is shown on the 4x2 tile. The values you can use for this attribute are true or false. | -| BackgroundColor | Optional | Specifies the color of the tile. You can specify the value in ARGB hexadecimal (for example, #FF112233) or specify "transparent". | -| ForegroundText | Optional | Specifies the color of the foreground text. Set the value to either "light" or "dark". | - -Secondary Microsoft Edge tiles have the same size and location behavior as a Universal Windows app, Windows 8 app, or Windows 8.1 app. - -#### TopMFUApps - ->[!NOTE] ->Only applies to versions of Windows 10 earlier than version 1701. In Windows 10, version 1709, you can no longer pin apps to the Most Frequently Used apps list in Start. - -You can use the **TopMFUApps** tag to add up to 3 default apps to the frequently used apps section in the system area, which delivers system-driven lists to the user including important or frequently accessed system locations and recently installed apps. - -You can use this tag to add: - -- Apps with an **AppUserModelID** attribute - This includes Windows desktop applications that have a known application user model ID. Use a **Tile** tag with the **AppUserModelID** attribute set to the app's application user model ID. -- Apps without a **AppUserModelID** attribute - For these apps, you must create a .lnk file that points to the installed app and place the .lnk file in the `%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs` directory. Use a **DesktopApplicationTile** tag with the **LinkFilePath** attribute set to the .lnk file name and path. - -The following example shows how to modify your LayoutModification.xml file to add both kinds of apps to the system area in Start: - - ```XML - - - - - - - -``` - -#### AppendOfficeSuite - -You can use the **AppendOfficeSuite** tag to add the in-box installed Office suite of apps to Start. - ->[!NOTE] ->The OEM must have installed Office for this tag to work. - -The following example shows how to add the **AppendOfficeSuite** tag to your LayoutModification.xml file to append the full Universal Office suite to Start: - -```XML - - - -``` - -#### AppendOfficeSuiteChoice - -This tag is added in Windows 10, version 1801. You have two options in this tag: - -- `` -- `` - -Use `Choice=DesktopBridgeSubscription` on devices running Windows 10, version 1803, that have Office 365 preinstalled. This will set the heading of the Office suite of tiles to **Office 365**, to highlight the Office 365 apps that you've made available on the device. - -Use `Choice=DesktopBridge` on devices running versions of Windows 10 earlier than version 1803, and on devices shipping with [perpetual licenses for Office](/archive/blogs/ausoemteam/choosing-the-right-office-version-for-your-customers). This will set the heading of the Office suite of tiles to **Create**. - -For more information, see [Customize the Office suite of tiles](/windows-hardware/customize/desktop/customize-start-layout#customize-the-office-suite-of-tiles). - -#### AppendDownloadOfficeTile - -You can use the **AppendDownloadOfficeTile** tag to append the Office trial installer to Start. This tag adds the **Download Office** tile to Start and the download tile will appear at the bottom right-hand side of the second group. - ->[!NOTE] ->The OEM must have installed the Office trial installer for this tag to work. - -The following example shows how to add the **AppendDownloadOfficeTile** tag to your LayoutModification.xml file: - -```XML - - - -``` - -## Sample LayoutModification.xml - -The following sample LayoutModification.xml shows how you can configure the Start layout for devices running Windows 10 for desktop editions: - -```XML - - - - - - - - - - - - - - - - - - - - - - - - - -``` - -## Use Windows Provisioning multivariant support - -The Windows Provisioning multivariant capability allows you to declare target conditions that, when met, supply specific customizations for each variant condition. For Start customization, you can create specific layouts for each variant that you have. To do this, you must create a separate LayoutModification.xml file for each variant that you want to support and then include these in your provisioning package. For more information on how to do this, see [Create a provisioning package with multivariant settings](../provisioning-packages/provisioning-multivariant.md). - -The provisioning engine chooses the right customization file based on the target conditions that were met, adds the file in the location that's specified for the setting, and then uses the specific file to customize Start. To differentiate between layouts, you can add modifiers to the LayoutModification.xml filename such as "LayoutCustomization1". Regardless of the modifier that you use, the provisioning engine will always output "LayoutCustomization.xml" so that the operating system has a consistent file name to query against. - -For example, if you want to ensure that there's a specific layout for a certain condition, you can: - -1. Create a specific layout customization file and then name it LayoutCustomization1.xml. -1. Include the file as part of your provisioning package. -1. Create your multivariant target and reference the XML file within the target condition in the main customization XML file. - -The following example shows what the overall customization file might look like with multivariant support for Start: - -```XML - - - - {6aaa4dfa-00d7-4aaa-8adf-73c6a7e2501e} - My Provisioning Package - 1.0 - OEM - 50 - - - - - - - - - - - - - - - - - - - - - - 1 - - 1 - - 1 - - - - - - 1 - - - - - - - - - - - - c:\users\\appdata\local\Microsoft\Windows\Shell\LayoutCustomization1.XML - - 1 - - - - - - -``` - -When the condition is met, the provisioning engine takes the XML file and places it in the location that the operating system has set and then the Start subsystem reads the file and applies the specific customized layout. - -You must repeat this process for all variants that you want to support so that each variant can have a distinct layout for each of the conditions and targets that need to be supported. For example, if you add a **Language** condition, you can create a Start layout that has its own localized group. - -## Add the LayoutModification.xml file to the device - -Once you have created your LayoutModification.xml file to customize devices that will run Windows 10 for desktop editions, you can use Windows ICD methods to add the XML file to the device. - -1. In the **Available customizations** pane, expand **Runtime settings**, select **Start** > Select the **StartLayout** setting. -1. In the middle pane, click **Browse** to open File Explorer. -1. In the File Explorer window, navigate to the location where you saved your LayoutModification.xml file. - -1. Select the file and then click **Open**. - -This should set the value of **StartLayout**. The setting appears in the **Selected customizations** pane. - ->[!NOTE] ->There is currently no way to add the .url and .lnk files through Windows ICD. - -Once you have created the LayoutModification.xml file and it is present in the device, the system overrides the base default layout and any Unattend settings used to customize Start. diff --git a/windows/configuration/start/start-secondary-tiles.md b/windows/configuration/start/start-secondary-tiles.md deleted file mode 100644 index 17a578d2dd..0000000000 --- a/windows/configuration/start/start-secondary-tiles.md +++ /dev/null @@ -1,192 +0,0 @@ ---- -title: Add image for secondary Microsoft Edge tiles -description: Add app tiles on Windows 10 that's a secondary tile. -ms.topic: how-to -ms.date: 12/31/2017 ---- - -# Add image for secondary Microsoft Edge tiles - -App tiles are the Start screen tiles that represent and launch an app. A tile that allows a user to go to a specific location in an app is a *secondary tile*. Some examples of secondary tiles include: - -- Weather updates for a specific city in a weather app -- A summary of upcoming events in a calendar app -- Status and updates from an important contact in a social app -- A website in Microsoft Edge - -Suppose that the [Start layout that you export](customize-and-export-start-layout.md) had two secondary tiles, such as in the following image: - -![tile for MSN and for a SharePoint site.](images/edge-with-logo.png) - -By using the PowerShell cmdlet `export-StartLayoutEdgeAssets` and the policy setting `ImportEdgeAssets`, the tiles display the same as they did on the device from which you exported the Start layout. - -![tile for MSN and for a SharePoint site.](images/edge-with-logo.png) - -Example of secondary tiles in XML generated by Export-StartLayout: - -```xml - -``` - -## Export Start layout and assets - -1. Follow the instructions in [Customize and export Start layout](customize-and-export-start-layout.md#customize-the-start-screen-on-your-test-computer) to customize the Start screen on your test computer. -1. Open Windows PowerShell as an administrator and enter the following command: - - ```powershell - Export-StartLayout -path .xml - ``` - - In the previous command, `-path` is a required parameter that specifies the path and file name for the export file. You can specify a local path or a UNC path (for example, \\\\FileServer01\\StartLayouts\\StartLayoutMarketing.xml). - - Use a file name of your choice—for example, StartLayoutMarketing.xml. Include the .xml file name extension. The [Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet doesn't append the file name extension, and the policy settings require the extension. - -1. If you'd like to change the image for a secondary tile to your own custom image, open the layout.xml file, and look for the images that the tile references. - - For example, your layout.xml contains `Square150x150LogoUri="ms-appdata:///local/PinnedTiles/21581260870/hires.png" Wide310x150LogoUri="ms-appx:///"` - - - Open `C:\Users\\AppData\Local\Packages\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\LocalState\PinnedTiles\21581260870\` and replace those images with your customized images. - -1. In Windows PowerShell, enter the following command: - - ```powershell - Export-StartLayoutEdgeAssets assets.xml - ``` - -## Configure policy settings - -You can apply the customized Start layout with images for secondary tiles by using mobile device management (MDM) or a provisioning package. However, because you're including the images for secondary tiles, you must configure another setting to import the Edge assets. - -### Using MDM - -In Microsoft Intune, you create a device restrictions policy to apply to device group. For other MDM solutions, you may need to use an OMA-URI setting for Start layout, based on the [Policy configuration service provider (CSP)](/windows/client-management/mdm/policy-configuration-service-provider). The OMA-URI setting is `./User/Vendor/MSFT/Policy/Config/Start/StartLayout`. - -1. Sign in to the [Intune admin center](https://go.microsoft.com/fwlink/?linkid=2109431). -1. Select **Devices** > **Configuration profiles** > **Create profile**. -1. Enter the following properties: - - - **Platform**: Select **Windows 10 and later**. - - **Profile**: Select **Templates** > **Device restrictions**. - -1. Select **Create**. -1. In **Basics**, enter the following properties: - - - **Name**: Enter a descriptive name for the policy. Name your policies so you can easily identify them later. - - **Description**: Enter a description for the policy. This setting is optional, but recommended. - -1. Select **Next**. - -1. In **Configuration settings**, select **Start**. Configure the following properties: - - - **Start menu layout**: Browse to, and select your Start layout XML file. - - **Pin websites to tiles in Start menu**: Browse to, and select your assets XML file. - - There are more Start menu settings you can configure. For more information on these settings, see [Start settings in Intune](/intune/device-restrictions-windows-10#start) - -1. Select **Next**. -1. In **Scope tags** (optional), assign a tag to filter the profile to specific IT groups, such as `US-NC IT Team` or `JohnGlenn_ITDepartment`. For more information about scope tags, see [Use RBAC and scope tags for distributed IT](/mem/intune/fundamentals/scope-tags). - - Select **Next**. - -1. In **Assignments**, select the users or groups that will receive your profile. For more information on assigning profiles, see [Assign user and device profiles](/mem/intune/configuration/device-profile-assign). - - Select **Next**. - -1. In **Review + create**, review your settings. When you select **Create**, your changes are saved, and the profile is assigned. The policy is also shown in the profiles list. - -### Using a provisioning package - -#### Prepare the Start layout and Edge assets XML files - -The **export-StartLayout** and **export-StartLayoutEdgeAssets** cmdlets produce XML files. Because Windows Configuration Designer produces a customizations.xml file that contains the configuration settings, adding the Start layout and Edge assets sections to the customizations.xml file directly would result in an XML file embedded in an XML file. Before you add the Start layout and Edge assets sections to the customizations.xml file, you must replace the markup characters in your layout.xml with escape characters. - -1. Copy the contents of layout.xml into an online tool that escapes characters. - -1. Copy the contents of assets.xml into an online tool that escapes characters. - -1. When you create a provisioning package, you'll copy the text with the escape characters and paste it in the customizations.xml file for your project. - -#### Create a provisioning package that contains a customized Start layout - -Use the Windows Configuration Designer tool to create a provisioning package. [Learn how to install Windows Configuration Designer.](../provisioning-packages/provisioning-install-icd.md) - ->[!IMPORTANT] ->When you build a provisioning package, you may include sensitive information in the project files and in the provisioning package (.ppkg) file. Although you have the option to encrypt the .ppkg file, project files are not encrypted. You should store the project files in a secure location and delete the project files when they are no longer needed. - -1. Open Windows Configuration Designer (by default, %systemdrive%\\Program Files (x86)\\Windows Kits\\10\\Assessment and Deployment Kit\\Imaging and Configuration Designer\\x86\\ICD.exe). - -1. Choose **Advanced provisioning**. - -1. Name your project, and select **Next**. - -1. Choose **All Windows desktop editions** and select **Next**. - -1. On **New project**, select **Finish**. The workspace for your package opens. - -1. Expand **Runtime settings** > **Policies** > **Start**, and select **StartLayout**. - - >[!TIP] - >If **Start** is not listed, check the type of settings you selected in step 1. You must create the project using settings for **All Windows desktop editions**. - -1. Enter **layout.xml**. This value creates a placeholder in the customizations.xml file that you'll replace with the contents of the layout.xml file in a later step. - -1. In the **Available customizations** pane, select **ImportEdgeAssets**. - -1. Enter **assets.xml**. This value creates a placeholder in the customizations.xml file that you'll replace with the contents of the assets.xml file in a later step. - -1. Save your project and close Windows Configuration Designer. - -1. In File Explorer, open the project's directory. (The default location is C:\Users\\*user name*\Documents\Windows Imaging and Configuration Designer (WICD)\\*project name*) - -1. Open the customizations.xml file in a text editor. - -1. Replace **layout.xml** with the text from the layout.xml file, [with markup characters replaced with escape characters](#escape). - -1. Replace **assets.xml** with the text from the assets.xml file, [with markup characters replaced with escape characters](#escape). - -1. Save and close the customizations.xml file. - -1. Open Windows Configuration Designer and open your project. - -1. On the **File** menu, select **Save.** - -1. On the **Export** menu, select **Provisioning package**. - -1. Change **Owner** to **IT Admin**, which will set the precedence of this provisioning package higher than provisioning packages applied to this device from other sources, and then select **Next.** - -1. Optional. In the **Provisioning package security** window, you can choose to encrypt the package and enable package signing. - - - **Enable package encryption** - If you select this option, an auto-generated password will be shown on the screen. - - - **Enable package signing** - If you select this option, you must select a valid certificate to use for signing the package. You can specify the certificate by clicking **Select...** and choosing the certificate you want to use to sign the package. - -1. Select **Next** to specify the output location where you want the provisioning package to go when it's built. By default, Windows Imaging and Configuration Designer (ICD) uses the project folder as the output location. - - Optionally, you can select **Browse** to change the default output location. - -1. Select **Next**. - -1. Select **Build** to start building the package. The provisioning package doesn't take long to build. The project information is displayed in the build page and the progress bar indicates the build status. - - If you need to cancel the build, select **Cancel**. It cancels the current build process, closes the wizard, and takes you back to the **Customizations Page**. - -1. If your build fails, an error message will show up that includes a link to the project folder. You can scan the logs to determine what caused the error. Once you fix the issue, try building the package again. - - If your build is successful, the name of the provisioning package, output directory, and project directory will be shown. - - - If you choose, you can build the provisioning package again and pick a different path for the output package. To change the path, select **Back** to change the output package name and path, and then select **Next** to start another build. - - If you're done, select **Finish** to close the wizard and go back to the **Customizations Page**. - -1. Copy the provisioning package to the target device. -1. Double-click the ppkg file and allow it to install. diff --git a/windows/configuration/start/supported-csp-start-menu-layout-windows.md b/windows/configuration/start/supported-csp-start-menu-layout-windows.md deleted file mode 100644 index a42bb23a00..0000000000 --- a/windows/configuration/start/supported-csp-start-menu-layout-windows.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: Supported CSP policies to customize Start menu on Windows 11 | Microsoft Docs -description: See a list of the Policy CSP - Start items that are supported on Windows 11 to customize the Start menu. -ms.date: 12/31/2017 -ms.topic: reference -appliesto: -- ✅ Windows 11 ---- - -# Supported configuration service provider (CSP) policies for Windows 11 Start menu - -The Windows OS exposes CSPs that are used by MDM providers, like [Microsoft Intune](/mem/intune/fundamentals/what-is-intune). In an MDM policy, these CSPs are settings that you configure in a policy. When the policy is ready, you deploy the policy to your devices. - -This article lists the CSPs that are available to customize the Start menu for Windows 11 devices. Windows 11 uses the [Policy CSP - Start](/windows/client-management/mdm/policy-csp-start). For more general information, see [Configuration service provider (CSP) reference](/windows/client-management/mdm/configuration-service-provider-reference). - -For information on customizing the Start menu layout using policy, see [Customize the Start menu layout](customize-and-export-start-layout.md). - -## Existing Windows CSP policies that Windows 11 supports - -- [Start/AllowPinnedFolderDocuments](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderdocuments) -- [Start/AllowPinnedFolderDownloads](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderfileexplorer) -- [Start/AllowPinnedFolderFileExplorer](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderhomegroup) -- [Start/AllowPinnedFolderHomeGroup](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderhomegroup) -- [Start/AllowPinnedFolderMusic](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfoldermusic) -- [Start/AllowPinnedFolderNetwork](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfoldernetwork) -- [Start/AllowPinnedFolderPersonalFolder](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderpersonalfolder) -- [Start/AllowPinnedFolderPictures](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfolderpictures) -- [Start/AllowPinnedFolderSettings](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfoldersettings) -- [Start/AllowPinnedFolderVideos](/windows/client-management/mdm/policy-csp-start#start-allowpinnedfoldervideos) -- [Start/HideChangeAccountSettings](/windows/client-management/mdm/policy-csp-start#start-hidechangeaccountsettings) -- [Start/HideHibernate](/windows/client-management/mdm/policy-csp-start#start-hidehibernate) -- [Start/HideLock](/windows/client-management/mdm/policy-csp-start#start-hidelock) -- [Start/HidePowerButton](/windows/client-management/mdm/policy-csp-start#start-hidepowerbutton) -- [Start/HideRestart](/windows/client-management/mdm/policy-csp-start#start-hiderestart) -- [Start/HideShutDown](/windows/client-management/mdm/policy-csp-start#start-hideshutdown) -- [Start/HideSignOut](/windows/client-management/mdm/policy-csp-start#start-hidesignout) -- [Start/HideSleep](/windows/client-management/mdm/policy-csp-start#start-hidesleep) -- [Start/HideSwitchAccount](/windows/client-management/mdm/policy-csp-start#start-hideswitchaccount) -- [Start/HideUserTile](/windows/client-management/mdm/policy-csp-start#start-hideusertile) -- [Start/HideRecentJumplists](/windows/client-management/mdm/policy-csp-start#start-hiderecentjumplists) -- [Start/NoPinningToTaskbar](/windows/client-management/mdm/policy-csp-start#start-nopinningtotaskbar) -- **Start/ShowOrHideMostUsedApps**: New policy starting with Windows 11. This policy enforces always showing Most Used Apps, or always hiding Most Used Apps in the Start menu. If you use this policy, the [Start/HideFrequentlyUsedApps](/windows/client-management/mdm/policy-csp-start#start-hidefrequentlyusedapps) policy is ignored. - - The [Start/HideFrequentlyUsedApps](/windows/client-management/mdm/policy-csp-start#start-hidefrequentlyusedapps) policy enforces hiding Most Used Apps on the Start menu. You can't use this policy to enforce always showing Most Used Apps on the Start menu. - -**The following policies are supported starting with Windows 11, version 22H2:** - -- [Start/HideAppList](/windows/client-management/mdm/policy-csp-start#start-hideapplist) -- [Start/DisableContextMenus](/windows/client-management/mdm/policy-csp-start#start-disablecontextmenus) - -## Existing CSP policies that Windows 11 doesn't support - -- [Start/StartLayout](/windows/client-management/mdm/policy-csp-start#start-startlayout) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Start Layout` - -- [Start/HideRecentlyAddedApps](/windows/client-management/mdm/policy-csp-start#start-hiderecentlyaddedapps) -- Group policy: `Computer Configuration\Administrative Templates\Start Menu and Taskbar\Remove "Recently added" list from Start Menu` - -> [!NOTE] -> The following two policies are supported starting in Windows 11, version 22H2 - -- [Start/HideAppList](/windows/client-management/mdm/policy-csp-start#start-hideapplist) - - Group policy: - - `Computer Configuration\Administrative Templates\Start Menu and Taskbar\Remove All Programs list from the Start menu` - - `User Configuration\Administrative Templates\Start Menu and Taskbar\Remove All Programs list from the Start menu` - -- [Start/DisableContextMenus](/windows/client-management/mdm/policy-csp-start#start-disablecontextmenus) - - Group policy: - - - `Computer Configuration\Administrative Templates\Start Menu and Taskbar\Disable context menus in the Start Menu` - - `User Configuration\Administrative Templates\Start Menu and Taskbar\Disable context menus in the Start Menu` diff --git a/windows/configuration/start/toc.yml b/windows/configuration/start/toc.yml index 77492cb6fe..13f6bda470 100644 --- a/windows/configuration/start/toc.yml +++ b/windows/configuration/start/toc.yml @@ -1,15 +1,12 @@ items: -- name: Customize and export the Start layout - href: customize-and-export-start-layout.md -- name: Supported Start menu CSPs - href: supported-csp-start-menu-layout-windows.md -- name: Start layout and taskbar - href: windows-10-start-layout-options-and-policies.md -- name: Use XML - items: - - name: Add image for secondary Microsoft Edge tiles - href: start-secondary-tiles.md - - name: Start layout XML for Windows 10 desktop editions (reference) - href: start-layout-xml-desktop.md +- name: Overview + href: index.md + displayName: Configure the Start menu +- name: Customize the Start layout + href: layout.md +- name: Policy settings + href: policy-settings.md +- name: XML schema definition (XSD) + href: xsd.md - name: Troubleshoot Start menu errors 🔗 href: /troubleshoot/windows-client/shell-experience/troubleshoot-start-menu-errors diff --git a/windows/configuration/start/windows-10-start-layout-options-and-policies.md b/windows/configuration/start/windows-10-start-layout-options-and-policies.md deleted file mode 100644 index aa22d3e5da..0000000000 --- a/windows/configuration/start/windows-10-start-layout-options-and-policies.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Customize and manage the Windows 10 Start and taskbar layout -description: On Windows devices, customize the start menu layout and taskbar using XML, group policy, provisioning package, or MDM policy. You can add pinned folders, add a start menu size, pin apps to the taskbar, and more. -ms.topic: how-to -ms.date: 08/05/2021 -appliesto: -- ✅ Windows 10 ---- - -# Customize the Start menu and taskbar layout on Windows 10 and later devices - -> **Looking for consumer information?** [See what's on the Start menu](https://support.microsoft.com/help/17195/windows-10-see-whats-on-the-menu) -> -> **Looking for OEM information?** See [Customize the Taskbar](/windows-hardware/customize/desktop/customize-the-windows-11-taskbar) and [Customize the Start layout](/windows-hardware/customize/desktop/customize-the-windows-11-start-menu). - -Your organization can deploy a customized Start and taskbar to Windows 10 Professional, Enterprise, or Education devices. Use a standard, customized Start layout on devices that are common to multiple users, and devices that are locked down. Configuring the taskbar allows you to pin useful apps for your users, and remove apps that are pinned by default. - ->[!NOTE] ->Support for applying a customized taskbar using MDM is added in Windows 10, version 1701. - -As administrator, you can use these features to customize Start and taskbar to meet your organization needs. This article describes the different ways you can customize Start and taskbar, and lists the Start policies. It also includes taskbar information on a clean operating system (OS) installation, and when an OS is upgraded. - ->[!NOTE] ->For information on using the layout modification XML to configure Start with roaming user profiles, see [Deploy Roaming User Profiles](/windows-server/storage/folder-redirection/deploy-roaming-user-profiles#step-7-optionally-specify-a-start-layout-for-windows-10-pcs). -> ->Using CopyProfile for Start menu customization in Windows 10 isn't supported. For more information [Customize the Default User Profile by Using CopyProfile](/windows-hardware/manufacture/desktop/customize-the-default-user-profile-by-using-copyprofile) - -## Use XML - -On an existing Windows device, you can set up the **Start** screen, and then export the layout to an XML file. When you have the XML file, add this file to a group policy, a Windows Configuration Designer provisioning package, or a mobile device management (MDM) policy. Using these methods, you can deploy the XML file to your devices. When the devices receive your policy, they'll use the layout configured in the XML file. - -For more information, see [Customize and export Start layout](customize-and-export-start-layout.md). - -For the **taskbar**, you can use the same XML file as the start screen. Or, you can create a new XML file. When you have the XML file, add this file to a group policy or a provisioning package. Using these methods, you can deploy the XML file to your devices. When the devices receive your policy, they'll use the taskbar settings you configured in the XML file. - -For more information, see [Configure Windows 10 taskbar](../taskbar/configure.md). - -## Use group policy - -Using group policy objects (GPO), you can manage different parts of the Start menu and taskbar. You don't need to reimage the devices. Using administrative templates, you configure settings in a policy, and then deploy this policy to your devices. [Start menu policy settings](#start-menu-policy-settings) (in this article) lists the policies you can configure. - -## Use provisioning packages - -Provisioning packages are containers that include a set of configuration settings. They're designed to configure a device quickly, without installing a new image. For more information on what provisioning packages are, and what they do, see [Provisioning packages](../provisioning-packages/provisioning-packages.md). - -Using a provisioning package, you can customize the Start and taskbar. - -## Use a mobile device management (MDM) solution - -Using an MDM solution, you add an XML file to a policy, and then deploy this policy to your devices. - -If you use Microsoft Intune for your MDM solution, then you can use settings to configure Start and the taskbar. For more information on the settings you can configure, see [Start settings in Microsoft Intune](/mem/intune/configuration/device-restrictions-windows-10#start). - -## Start menu policy settings - -![start layout sections.](images/startannotated.png) - -The following list includes the different Start options, and any policy or local settings. The settings in the list can also be used in a provisioning package. If you use a provisioning package, see the [Windows Configuration Designer reference](../wcd/wcd-policies.md#start). - -- **User tile** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Remove Logoff on the Start menu` - - **Local setting**: None - - **MDM policy**: - - Start/HideUserTile - - Start/HideSwitchAccount - - Start/HideSignOut - - Start/HideLock - - Start/HideChangeAccountSettings - -- **Most used** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Remove frequent programs from the Start menu` - - **Local setting**: Settings > Personalization > Start > Show most used apps - - **MDM policy**: Start/HideFrequentlyUsedApps - -- **Suggestions, Dynamically inserted app tile** - - **Group policy**: `Computer Configuration\Administrative Templates\Windows Components\Cloud Content\Turn off Microsoft consumer experiences` - - This policy also enables or disables notifications for: - - - A user's Microsoft account - - App tiles that Microsoft dynamically adds to the default Start menu - - - **Local setting**: Settings > Personalization > Start > Occasionally show suggestions in Start - - **MDM policy**: Allow Windows Consumer Features - -- **Recently added** - - **Group policy**: `Computer configuration\Administrative Template\Start Menu and Taskbar\Remove "Recently Added" list from Start Menu` - - This policy applies to: - - - Windows 10 version 1803 and later - - - **Local setting**: Settings > Personalization > Start > Show recently added apps - - **MDM policy**: Start/HideRecentlyAddedApps - -- **Pinned folders** - - **Local setting**: Settings > Personalization > Start > Choose which folders appear on Start - - **MDM policy**: AllowPinnedFolder - -- **Power** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Remove and prevent access to the Shut Down, Restart, Sleep, and Hibernate commands` - - **Local setting**: None - - **MDM policy**: - - Start/HidePowerButton - - Start/HideHibernate - - Start/HideRestart - - Start/HideShutDown - - Start/HideSleep - -- **Start layout** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from customizing their Start screen` - - When a full Start screen layout is imported with Group Policy or MDM, users can't pin, unpin, or uninstall apps from the Start screen. Users can see and open all apps in the **All Apps** view, but they can't pin any apps to the Start screen. When a partial Start screen layout is imported, users can't change the tile groups applied by the partial layout. They can change other tile groups, and create their own tile groups. - - **Start layout** policy can be used to pin apps to the taskbar based on an XML File you provide. Users can change the order of pinned apps, unpin apps, and pin more apps to the taskbar. - - - **Local setting**: None - - **MDM policy**: - - Start layout - - ImportEdgeAssets - -- **Jump lists** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Do not keep history of recently opened documents` - - **Local setting**: Settings > Personalization > Start > Show recently opened items in Jump Lists on Start or the taskbar - - **MDM policy**: Start/HideRecentJumplists - -- **Start size** - - **Group policy**: `User Configuration\Administrative Templates\Start Menu and Taskbar\Force Start to be either full screen size or menu size` - - **Local setting**: Settings > Personalization > Start > Use Start full screen - - **MDM policy**: Force Start size - -- **App list** - - **Local setting**: Settings > Personalization > Start > Show app list in Start menu - - **MDM policy**: Start/HideAppList - -- **All settings** - - **Group policy**: `User Configuration\Administrative Templates\Prevent changes to Taskbar and Start Menu Settings` - - **Local setting**: None - -- **Taskbar** - - **Local setting**: None - - **MDM policy**: Start/NoPinningToTaskbar - -> [!NOTE] -> In the **Settings** app > **Personalization** > **Start**, there is a **Show more tiles on Start** option. The default tile layout for Start tiles is 3 columns of medium sized tiles. **Show more tiles on Start** enables 4 columns. To configure the 4-column layout when you [customize and export a Start layout](customize-and-export-start-layout.md), turn on the **Show more tiles** setting, and then arrange your tiles. - -## Taskbar options - -Starting in Windows 10 version 1607, you can pin more apps to the taskbar, and remove default pinned apps from the taskbar. You can select different taskbar configurations based on device locale or region. - -There are three app categories that could be pinned to a taskbar: - -- Apps pinned by the user -- Default Windows apps pinned during the OS installation, such as Microsoft Edge, File Explorer, and Store -- Apps pinned by your organization, such as in an unattended Windows setup - - In an unattended Windows setup file, it's recommended to use the [layoutmodification.xml method](../taskbar/configure.md) to configure the taskbar options. It's not recommended to use [TaskbarLinks](/windows-hardware/customize/desktop/unattend/microsoft-windows-shell-setup-taskbarlinks). - -The following example shows how apps are pinned. In OS configured to use a right-to-left language, the taskbar order is reversed: - -- Windows default apps to the left (blue circle) -- Apps pinned by the user in the center (orange triangle) -- Apps that you pin using XML to the right (green square) - -![Windows left, user center, enterprise to the right.](images/taskbar-generic.png) - -If you apply the taskbar configuration to a clean install or an update, users can still: - -- Pin more apps -- Change the order of pinned apps -- Unpin any app - -> [!TIP] -> In Windows 10 version 1703, you can apply the `Start/NoPinningToTaskbar` MDM policy. This policy prevents users from pinning and unpinning apps on the taskbar. - -### Taskbar configuration applied to clean install of Windows 10 - -In a clean install, if you apply a taskbar layout, only the following apps are pinned to the taskbar: - -- Apps you specifically add -- Any default apps you don't remove - -After the layout is applied, users can pin more apps to the taskbar. - -## Start layout configuration errors - -If your Start layout customization isn't applied as you expect, open the **Event Viewer**. Go to **Applications and Services Log** > **Microsoft** > **Windows** > **ShellCommon-StartLayoutPopulation** > **Operational**. Look for the following events: - -- **Event 22**: The XML is malformed. The specified file isn't valid XML. This event can happen if the file has extra spaces or unexpected characters. Or, if the file isn't saved in the UTF8 format. -- **Event 64**: The XML is valid, and has unexpected values. This event can happen when the configuration isn't understood, elements aren't in [the required order](start-layout-xml-desktop.md#required-order), or source isn't found, such as a missing or misspelled `.lnk`. diff --git a/windows/configuration/start/xsd.md b/windows/configuration/start/xsd.md new file mode 100644 index 0000000000..714f0aa70f --- /dev/null +++ b/windows/configuration/start/xsd.md @@ -0,0 +1,432 @@ +--- +title: Start XML Schema Definition (XSD) +description: Start XSD reference article. +ms.topic: reference +ms.date: 04/10/2024 +appliesto: +- ✅ Windows 10 +--- + +# Start XML Schema Definition (XSD) + +This reference article contains the Start XML schema definition (XSD). + +## StartLayout + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +## LayoutModification + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +## FullDefaultLayout + +```xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` diff --git a/windows/configuration/store/toc.yml b/windows/configuration/store/toc.yml new file mode 100644 index 0000000000..1be495bbbe --- /dev/null +++ b/windows/configuration/store/toc.yml @@ -0,0 +1,5 @@ +items: + - name: Configure access to Microsoft Store + href: index.md + - name: Find the AUMID of an installed app + href: find-aumid.md \ No newline at end of file diff --git a/windows/configuration/taskbar/includes/disable-editing-quick-settings.md b/windows/configuration/taskbar/includes/disable-editing-quick-settings.md new file mode 100644 index 0000000000..b9dea0f3a5 --- /dev/null +++ b/windows/configuration/taskbar/includes/disable-editing-quick-settings.md @@ -0,0 +1,15 @@ +--- +author: paolomatarazzo +ms.author: paoloma +ms.date: 03/18/2024 +ms.topic: include +--- + +### Disable editing quick settings + +When you enable this policy setting, users can't modify quick settings. If you disable or don't configure this policy setting, users can edit quick settings, like pinning or unpinning buttons. + +| | Path | +|--|--| +| **CSP** | `./Device/Vendor/MSFT/Policy/Config/Start/`[DisableEditingQuickSettings](/windows/client-management/mdm/policy-csp-start#disableeditingquicksettings)| +| **GPO** | **Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar** > **Disable editing quick settings** | diff --git a/windows/configuration/taskbar/index.md b/windows/configuration/taskbar/index.md index 8061acd2b6..b6ffb0bfb2 100644 --- a/windows/configuration/taskbar/index.md +++ b/windows/configuration/taskbar/index.md @@ -1,5 +1,5 @@ --- -title: Configure Windows taskbar +title: Configure the Windows taskbar description: Administrators can pin more apps to the taskbar and remove default pinned apps from the taskbar by adding a section to a layout modification XML file. ms.topic: how-to ms.date: 08/18/2023 @@ -7,7 +7,7 @@ appliesto: zone_pivot_groups: windows-versions-11-10 --- -# Configure Windows Taskbar +# Configure the Windows taskbar ::: zone pivot="windows-10" @@ -34,7 +34,7 @@ The following example shows how apps will be pinned: Windows default apps to the To configure the taskbar: 1. Create the XML file - - If you're also [customizing the Start layout](../start/customize-and-export-start-layout.md), use `Export-StartLayout` to create the XML, and then add the `` section from [the following sample](#sample-taskbar-configuration-added-to-start-layout-xml-file) to the file. + - If you're also [customizing the Start layout](../start/layout.md), use `Export-StartLayout` to create the XML, and then add the `` section from [the following sample](#sample-taskbar-configuration-added-to-start-layout-xml-file) to the file. - If you're only configuring the taskbar, use [the following sample](#sample-taskbar-configuration-xml-file) to create a layout modification XML file 1. Edit and save the XML file. You can use [AUMID](../kiosk/find-the-application-user-model-id-of-an-installed-app.md) or Desktop Application Link Path to identify the apps to pin to the taskbar - Add `xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"` to the first line of the file, before the closing \>. @@ -45,7 +45,7 @@ To configure the taskbar: >[!IMPORTANT] >If you use a provisioning package or import-startlayout 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 Group Policy. > ->If you use Group Policy and your configuration only contains a taskbar layout, the default Windows tile layout will be applied and cannot be changed by users. If you use Group Policy and your configuration includes taskbar and a full Start layout, users can only make changes to the taskbar. If you use Group Policy and your configuration includes taskbar and a [partial Start layout](../start/customize-and-export-start-layout.md#configure-a-partial-start-layout), users can make changes to the taskbar and to tile groups not defined in the partial Start layout. +>If you use Group Policy and your configuration only contains a taskbar layout, the default Windows tile layout will be applied and cannot be changed by users. If you use Group Policy and your configuration includes taskbar and a full Start layout, users can only make changes to the taskbar. If you use Group Policy and your configuration includes taskbar and a [partial Start layout](../start/layout.md), users can make changes to the taskbar and to tile groups not defined in the partial Start layout. ### Tips for finding AUMID and Desktop Application Link Path @@ -538,3 +538,52 @@ If the OS is configured to use a right-to-left language, then the taskbar order After the layout is applied, users can pin more apps, change the order, and unpin apps. ::: zone-end + + \ No newline at end of file diff --git a/windows/configuration/taskbar/policy-settings.md b/windows/configuration/taskbar/policy-settings.md index b4f8a0c732..1016be2d5b 100644 --- a/windows/configuration/taskbar/policy-settings.md +++ b/windows/configuration/taskbar/policy-settings.md @@ -5,69 +5,97 @@ ms.date: 12/31/2017 ms.topic: article appliesto: - ✅ Windows 11 ---- +--- -# Supported configuration service provider (CSP) policies for Windows 11 taskbar +# Supported configuration service provider (CSP) policies for Windows 11 taskbar -The Windows OS exposes CSPs that are used by MDM providers, like [Microsoft Intune](/mem/intune/fundamentals/what-is-intune). In an MDM policy, these CSPs are settings that you configure. When the policy is ready, you deploy the policy to your devices. This article lists the CSPs that are available to customize the Taskbar for Windows 11 devices. +The Windows OS exposes CSPs that are used by MDM providers, like [Microsoft Intune](/mem/intune/fundamentals/what-is-intune). In an MDM policy, these CSPs are settings that you configure. When the policy is ready, you deploy the policy to your devices. This article lists the CSPs that are available to customize the Taskbar for Windows 11 devices. -For more general information, see [Configuration service provider (CSP) reference](/windows/client-management/mdm/configuration-service-provider-reference). +For more general information, see [Configuration service provider (CSP) reference](/windows/client-management/mdm/configuration-service-provider-reference). -## CSP policies to customize Windows 11 taskbar buttons +## CSP policies to customize Windows 11 taskbar buttons - [Search/ConfigureSearchOnTaskbarMode](/windows/client-management/mdm/policy-csp-search#configuresearchontaskbarmode) - Group policy: `Computer Configuration\Administrative Templates\Windows Components\Search\Configures search on the taskbar` - - Local setting: Settings > Personalization > Taskbar > Search + - Local setting: Settings > Personalization > Taskbar > Search - [Start/HideTaskViewButton](/windows/client-management/mdm/policy-csp-start#hidetaskviewbutton) - Group policy: `Computer and User Configuration\Administrative Templates\Start Menu and Taskbar\Hide the TaskView button` - - Local setting: Settings > Personalization > Taskbar > Task view + - Local setting: Settings > Personalization > Taskbar > Task view - [NewsAndInterests/AllowNewsAndInterests](/windows/client-management/mdm/policy-csp-newsandinterests#allownewsandinterests) - Group policy: `Computer Configuration\Administrative Templates\Windows Components\Widgets\Allow widgets` - - Local setting: Settings > Personalization > Taskbar > Widgets + - Local setting: Settings > Personalization > Taskbar > Widgets - [Experience/ConfigureChatIcon](/windows/client-management/mdm/policy-csp-experience#configurechaticonvisibilityonthetaskbar) - Group policy: `Computer Configuration\Administrative Templates\Windows Components\Chat\Configure the Chat icon setting` - - Local setting: Settings > Personalization > Taskbar > Chat + - Local setting: Settings > Personalization > Taskbar > Chat -## Existing CSP policies that Windows 11 taskbar supports +## Existing CSP policies that Windows 11 taskbar supports - [Start/HideRecentJumplists](/windows/client-management/mdm/policy-csp-start#hiderecentjumplists) - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Do not keep history of recently opened documents` - - Local setting: Settings > Personalization > Start > Show recently opened items in Jump Lists on Start or the taskbar + - Local setting: Settings > Personalization > Start > Show recently opened items in Jump Lists on Start or the taskbar - [Start/NoPinningToTaskbar](/windows/client-management/mdm/policy-csp-start#nopinningtotaskbar) - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Do not allow pinning programs to the Taskbar` - - Local setting: None + - Local setting: None -## Existing CSP policies that Windows 11 doesn't support +## Existing CSP policies that Windows 11 doesn't support -The following list includes some of the CSP policies that aren't supported on Windows 11: +The following list includes some of the CSP policies that aren't supported on Windows 11: - [ADMX_Taskbar/TaskbarLockAll](/windows/client-management/mdm/policy-csp-admx-taskbar#taskbarlockall) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Lock all taskbar settings` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Lock all taskbar settings` - [ADMX_Taskbar/TaskbarNoAddRemoveToolbar](/windows/client-management/mdm/policy-csp-admx-taskbar#taskbarnoaddremovetoolbar) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from adding or removing toolbars` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from adding or removing toolbars` - [ADMX_Taskbar/TaskbarNoDragToolbar](/windows/client-management/mdm/policy-csp-admx-taskbar#taskbarnodragtoolbar) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from rearranging toolbars` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from rearranging toolbars` - [ADMX_Taskbar/TaskbarNoRedock](/windows/client-management/mdm/policy-csp-admx-taskbar#taskbarnoredock) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from moving taskbar to another screen dock location` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from moving taskbar to another screen dock location` - [ADMX_Taskbar/TaskbarNoResize](/windows/client-management/mdm/policy-csp-admx-taskbar#taskbarnoresize) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from resizing the taskbar` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent users from resizing the taskbar` - [ADMX_StartMenu/NoToolbarsOnTaskbar](/windows/client-management/mdm/policy-csp-admx-startmenu#notoolbarsontaskbar) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Do not display any custom toolbars in the taskbar` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Do not display any custom toolbars in the taskbar` - [ADMX_StartMenu/NoTaskGrouping](/windows/client-management/mdm/policy-csp-admx-startmenu#notaskgrouping) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent grouping of taskbar items` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Prevent grouping of taskbar items` - [ADMX_StartMenu/QuickLaunchEnabled](/windows/client-management/mdm/policy-csp-admx-startmenu#quicklaunchenabled) - - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Show QuickLaunch on Taskbar` + - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Show QuickLaunch on Taskbar` - [Start/HidePeopleBar](/windows/client-management/mdm/policy-csp-start#hidepeoplebar) - Group policy: `User Configuration\Administrative Templates\Start Menu and Taskbar\Remove the People Bar from the taskbar` + + + + +