deepblue/windows-itpro-docs
1
0
Fork 0
mirror of https://github.com/MicrosoftDocs/windows-itpro-docs.git synced 2025-05-12 13:27:23 +00:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity

updates

Browse Source
This commit is contained in:
Paolo Matarazzo 2024-03-21 08:27:28 -04:00
parent e4f6e04daf
commit 7ee09637da
6 changed files with 53 additions and 77 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
windows/configuration/start/images/windows-10-partial-layout.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 77 KiB

After

Width:  |  Height:  |  Size: 77 KiB

6
windows/configuration/start/index.md
View File

@ -63,11 +63,11 @@ For advanced customizations and when you need to configure multiple devices, you
> 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 and export the Start layout](layout.md).
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 and export the Start layout](layout.md).
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 layout policy CSP](policy-settings.md#start-layout) only. It's not possible to apply the JSON file using group policy.
@ -77,7 +77,7 @@ The configuration of the Start layout requires the use of a JSON file that speci
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 and export the Start layout](layout.md)
- [Customize the Start layout](layout.md)
- [Start menu policy settings](policy-settings.md)
<!--links-->

95
windows/configuration/start/layout.md
View File

@ -9,7 +9,7 @@ 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 pins, and organize the application display to align with operational requirements.
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.
@ -37,12 +37,12 @@ To prepare a Start layout for export, customize the Start layout on a reference
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:
::: zone pivot="windows-10"
- **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**.
- **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
@ -56,7 +56,10 @@ To customize Start:
::: zone pivot="windows-11"
- **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**.
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
@ -68,53 +71,45 @@ To customize Start:
### Export the Start layout configuration
Once the Start layout is configured to meet your requirements, use the Windows PowerShell [Export-StartLayout](/powershell/module/startlayout/export-startlayout) cmdlet to export the existing layout to a configuration file.
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. The XML file must adhere to an XML schema definition (XSD). Here's a link to the XSD: [Start XML Schema Definition (XSD)](xsd.md).
The exported customization consists of an XML file containing a list of tiles that define the Start layout.
> [!NOTE]
> The 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:
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 `.json` file. For example, create the `C:\Layouts` folder
1. Open Windows PowerShell
1. Run the following cmdlet:
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
```powershell
Export-StartLayout -UseDesktopApplicationID -Path "C:\Layouts\LayoutModification.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. (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)
1. (Optional) Edit the XML file to add [a taskbar configuration](../taskbar/configure.md) or to make any modifications to the Start layout
> [!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.
> When you make changes to the exported layout, be aware that the XML file must adhere to an [XML schema definition (XSD)](xsd.md).
> [!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\.
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`. 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.
After you export the layout, decide whether you want to apply a *full* Start layout or a *partial* Start layout.
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.
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.
For scripts and application tile pins to work correctly, follow these rules:
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.
- 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 won't pin to Start
### Configure a partial 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
#### 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.
@ -122,16 +117,14 @@ A partial Start layout enables you to add one or more customized tile groups to
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.
When a partial Start layout is applied to a device that already has a 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:
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 `<DefaultLayoutOverride>` element. Add `LayoutCustomizationRestrictionType="OnlySpecifiedGroups"` to the **DefaultLayoutOverride** element as follows:
Open the layout XML file and find the `<DefaultLayoutOverride>` element. Add `LayoutCustomizationRestrictionType="OnlySpecifiedGroups"` to the element. For example:
```xml
<DefaultLayoutOverride LayoutCustomizationRestrictionType="OnlySpecifiedGroups">
@ -141,7 +134,11 @@ To configure a partial Start screen layout:
::: zone pivot="windows-11"
1. Create a folder to save the `.json` file. For example, create the `C:\Layouts` folder
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:
@ -149,8 +146,6 @@ To configure a partial Start screen layout:
Export-StartLayout -Path "C:\Layouts\LayoutModification.json"
```
The exported customization consists of a JSON file containing a list of pins that define the Start layout.
1. Open the `LayoutModification.json` file in a JSON editor, such as Visual Studio Code or Notepad
1. The `pinnedList` section includes all of the pinned apps. Copy the `pinnedList` content in the JSON file
@ -179,7 +174,6 @@ Here you can find an example of Start layout that you can use as a reference:
::: zone pivot="windows-10"
#### [:::image type="icon" source="../images/icons/intune.svg"::: **Intune/CSP**](#tab/intune-10)
>[!WARNING]
@ -305,20 +299,13 @@ After the settings are applied, sign in to the device. You'll see the Start layo
::: zone-end
## Start layout configuration errors
## Next steps
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`.
- 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).
<!--links-->
[WIN-1]: /windows/client-management/mdm/policy-csp-start
[MEM-1]: /mem/intune/configuration/custom-settings-windows-10
<!--
each single backslash character \ need to be escaped as \\ per JSON syntax>
- [You can modify the Start .xml file](../taskbar/configure.md) to include `<CustomTaskbarLayoutCollection>` or create an .xml file just for the taskbar configuration.
[PS-1]: /powershell/module/startlayout/export-startlayout

15
windows/configuration/start/start-layout-xml-desktop.md
View File

@ -509,22 +509,9 @@ You must repeat this process for all variants that you want to support so that e
## 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.
# Add image for secondary Microsoft Edge tiles
## 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:

2
windows/configuration/start/toc.yml
View File

@ -8,5 +8,7 @@ items:
href: policy-settings.md
- name: XML schema definition (XSD)
href: xsd.md
- name: _🧐 XML schema
href: start-layout-xml-desktop.md
- name: Troubleshoot Start menu errors 🔗
href: /troubleshoot/windows-client/shell-experience/troubleshoot-start-menu-errors

4
windows/configuration/taskbar/index.md
View File

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