windows-itpro-docs/windows/configure/configure-windows-10-taskbar.md
jdeckerMS 72a3309bdf Squashed commit of the following:
commit 13f1090ee65f4a6e80ebbded8a29a5b7cc18e0ec
Merge: ff49098a b7022583
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 09:11:06 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit ff49098a8fc4e286ab2002c15fe410901afbc548
Merge: d30056bd 2a8a5861
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:54:32 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit d30056bdaa7c65fdd9292293fdd74d0067f6843c
Merge: 061aa7ff 5c840fcd
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:50:35 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit 061aa7ffa41809f11caab7c50abcfeeb66eaf765
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:49:21 2017 -0700

    got rid of redundant text

commit 28f92a6e71c7bb2c18297cbe9aa4f344b501167b
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:38:10 2017 -0700

    format

commit 9f42b3c3f6b40c333aeb0dbe269037d76e8a6681
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:36:30 2017 -0700

    numbering

commit c825690f4158baeaaf899f33c362f49ab2e0d1da
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:26:11 2017 -0700

    sync

commit d665b656bcc139af3d7a0b9c8b88c6fd4e70be0e
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 08:25:39 2017 -0700

    change escape procedure

commit 42088746e72d410a4487c46122fcd24267d4bfe9
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 06:30:32 2017 -0700

    fix typo

commit 3658391492d70b9d1eb84cd57fe92f8a5c92698f
Merge: ebd6e1c5 60e98765
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 31 06:27:07 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit ebd6e1c5b65328f7b70cea0c1daca1625620766f
Merge: 11e51f8f a45661ff
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Thu Mar 30 13:37:18 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit 11e51f8ff68689d8ee87cfd77eefc4595ce7617c
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Thu Mar 30 11:12:43 2017 -0700

    inner links

commit 22050763c07cd92931e57cecd96f5de259e1f4fb
Merge: bf9b2cbe 7db06064
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Thu Mar 30 11:06:28 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit bf9b2cbe5fcf618c3654dc8c94d3b7d28a0c4579
Merge: 7e06781a ebaa19a0
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Mon Mar 27 14:08:43 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit 7e06781a86193250b71582ea22647367131e5324
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Mon Mar 27 14:00:43 2017 -0700

    fix link

commit 265d164f59ef91e9485c69ce2ef76dc08e6d561c
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Mon Mar 27 13:49:15 2017 -0700

    secondary tiles ready for review

commit 8e0f57b38fe967a6a1c6794a4b5d97522139304a
Merge: ec1be358 3fa1f32e
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Mon Mar 27 12:27:33 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit ec1be358670661446c5600d07f5cbec47bb4cc0e
Merge: cb27a41b 0a2afbb1
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Mon Mar 27 07:57:10 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit cb27a41b907a51e5a76613143bb1c605c4fb1628
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 24 13:44:55 2017 -0700

    sync

commit 56206d7637064329783c711821c1a8f494c5a57e
Merge: 7c6d6f3c 233b34ce
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 24 11:15:49 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge

commit 7c6d6f3c481aedb01ab25633660867cf1e38400a
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Fri Mar 24 11:15:20 2017 -0700

    sync notes

commit 465871de30b4e9f470bfbe370438c35e36a9927d
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Thu Mar 23 13:23:39 2017 -0700

    notes for new secondary tile topic

commit b102a01ee80e5d73052ae273cb371ef62d127429
Merge: 24c55704 8d2cf84e
Author: jdeckerMS <jdecker@microsoft.com>
Date:   Thu Mar 23 13:10:29 2017 -0700

    Merge remote-tracking branch 'refs/remotes/origin/rs2' into jdrs2edge
2017-03-31 09:16:24 -07:00

16 KiB

title, description, keywords, ms.prod, ms.mktglfcycl, ms.sitesec, author, localizationpriority
title description keywords ms.prod ms.mktglfcycl ms.sitesec author localizationpriority
Configure Windows 10 taskbar (Windows 10) Admins can pin apps to users' taskbars.
taskbar layout
pin apps
W10 manage library jdeckerMS high

Configure Windows 10 taskbar

Starting in Windows 10, version 1607, administrators can pin additional apps to the taskbar and remove default pinned apps from the taskbar by adding a <TaskbarLayout> section to a layout modification XML file. This method never removes user-pinned apps from the taskbar.

Note

The only aspect of the taskbar that can currently be configured by the layout modification XML file is the layout.

You can specify different taskbar configurations based on device locale and region. There is no limit on the number of apps that you can pin. You specify apps using the Application User Model ID (AUMID) or Desktop Application Link Path (the local path to the application).

If you specify an app to be pinned that is not provisioned for the user on the computer, the pinned icon won't appear on the taskbar.

The order of apps in the XML file dictates the order of pinned apps on the taskbar from left to right, to the right of any existing apps pinned by the user.

Note

 In operating systems configured to use a right-to-left language, the taskbar order will be reversed.

The following example shows how apps will be pinned: Windows default apps to the left (blue circle), apps pinned by the user in the center (orange triangle), and apps that you pin using the XML file to the right (green square).

Windows left, user center, enterprise to the right

Configure taskbar (general)

To configure the taskbar:

  1. Create the XML file.
    • If you are also customizing the Start layout, use Export-StartLayout to create the XML, and then add the <CustomTaskbarLayoutCollection> section from the following sample to the file.
    • If you are only configuring the taskbar, use the following sample to create a layout modification XML file.
  2. Edit and save the XML file. You can use AUMID or Desktop Application Link Path to identify the apps to pin to the taskbar.
    • Use <taskbar:UWA> and AUMID to pin Universal Windows Platform apps.
    • Use <taskbar:DesktopApp> and Desktop Application Link Path to pin desktop applications.
  3. Apply the layout modification XML file to devices using Group Policy or a provisioning package created in Windows Imaging and Configuration Designer (Windows ICD).

Important

If you use a provisioning package to configure the taskbar, your configuration will be reapplied each time the explorer.exe process restarts. If your configuration pins an app and the user then unpins that app, the user's change will be overwritten the next time the configuration is applied. To apply a taskbar configuration that allows users to make changes that will persist, apply your configuration by using 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, users can make changes to the taskbar and to tile groups not defined in the partial Start layout.

In the layout modification XML file, you will need to add entries for applications in the XML markup. In order to pin an application, you need either its AUMID or Desktop Application Link Path.

The easiest way to find this data for an application is to:

  1. Pin the application to the Start menu on a reference or testing PC.
  2. Open Windows PowerShell and run the Export-StartLayout cmdlet.
  3. Open the generated XML file.
  4. Look for an entry corresponding to the app you pinned.
  5. Look for a property labeled AppUserModelID or DesktopApplicationLinkPath.

Sample taskbar configuration XML file

<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">
  <CustomTaskbarLayoutCollection>
    <defaultlayout:TaskbarLayout>
      <taskbar:TaskbarPinList>
        <taskbar:UWA AppUserModelID="Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\File Explorer.lnk" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
 </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>

Sample taskbar configuration added to Start layout XML file

<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">
  <LayoutOptions StartTileGroupCellWidth="6" StartTileGroupsColumnCount="1" />
  <DefaultLayoutOverride>
    <StartLayoutCollection>
      <defaultlayout:StartLayout GroupCellWidth="6" xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout">
        <start:Group Name="Life at a glance" xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout">
          <start:Tile Size="2x2" Column="0" Row="0" AppUserModelID="Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge" />
          <start:Tile Size="2x2" Column="4" Row="0" AppUserModelID="Microsoft.Windows.Cortana_cw5n1h2txyewy!CortanaUI" />
          <start:Tile Size="2x2" Column="2" Row="0" AppUserModelID="Microsoft.BingWeather_8wekyb3d8bbwe!App" />
        </start:Group>        
      </defaultlayout:StartLayout>
    </StartLayoutCollection>
  </DefaultLayoutOverride>
    <CustomTaskbarLayoutCollection>
      <defaultlayout:TaskbarLayout>
        <taskbar:TaskbarPinList>
          <taskbar:UWA AppUserModelID="Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge" />
          <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\File Explorer.lnk" />
        </taskbar:TaskbarPinList>
      </defaultlayout:TaskbarLayout>
    </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>

##Keep default apps and add your own

The <CustomTaskbarLayoutCollection> section will append listed apps to the taskbar by default. The following sample keeps the default apps pinned and adds pins for Paint, Microsoft Reader, and a command prompt.

<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">
  <CustomTaskbarLayoutCollection>
    <defaultlayout:TaskbarLayout>
      <taskbar:TaskbarPinList>
        <taskbar:DesktopApp DesktopApplicationLinkPath="%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Accessories\Paint.lnk" />
        <taskbar:UWA AppUserModelID="Microsoft.Reader_8wekyb3d8bbwe!Microsoft.Reader" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%appdata%\Microsoft\Windows\Start Menu\Programs\System Tools\Command Prompt.lnk" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
  </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>

Before:

default apps pinned to taskbar

After:

additional apps pinned to taskbar

Remove default apps and add your own

By adding PinListPlacement="Replace" to <CustomTaskbarLayoutCollection>, you remove all default pinned apps; only the apps that you specify will be pinned to the taskbar.

If you only want to remove some of the default pinned apps, you would use this method to remove all default pinned apps and then include the default app that you want to keep in your list of pinned apps.

<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">
  <CustomTaskbarLayoutCollection PinListPlacement="Replace">
    <defaultlayout:TaskbarLayout>
      <taskbar:TaskbarPinList>
        <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\Accessories\Internet Explorer.lnk"/>
        <taskbar:DesktopApp DesktopApplicationLinkPath="%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Accessories\Paint.lnk" />
        <taskbar:UWA AppUserModelID="Microsoft.Office.Word_8wekyb3d8bbwe!microsoft.word" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
  </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>

Before:

Taskbar with default apps

After:

Taskbar with default apps removed

Configure taskbar by country or region

The following example shows you how to configure taskbars by country or region. When the layout is applied to a computer, if there is no <TaskbarPinList> node with a region tag for the current region, the first <TaskbarPinList> node that has no specified region will be applied. When you specify one or more countries or regions in a <TaskbarPinList> node, the specified apps are pinned on computers configured for any of the specified countries or regions.

<?xml version="1.0" encoding="utf-8"?>
<LayoutModificationTemplate
    xmlns="http://schemas.microsoft.com/Start/2014/LayoutModification"
    xmlns:defaultlayout="http://schemas.microsoft.com/Start/2014/FullDefaultLayout"
    xmlns:start="http://schemas.microsoft.com/Start/2014/StartLayout"
    xmlns:taskbar="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
    Version="1">

  <CustomTaskbarLayoutCollection PinListPlacement="Replace">
    <defaultlayout:TaskbarLayout region="US|UK">
      <taskbar:TaskbarPinList >
        <taskbar:UWA AppUserModelID="Microsoft.MicrosoftEdge_8wekyb3d8bbwe!MicrosoftEdge" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\File Explorer.lnk" />
        <taskbar:UWA AppUserModelID="Microsoft.Office.Word_8wekyb3d8bbwe!microsoft.word" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Accessories\Paint.lnk"/>
        <taskbar:UWA AppUserModelID="Microsoft.Reader_8wekyb3d8bbwe!Microsoft.Reader" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
    <defaultlayout:TaskbarLayout region="DE|FR">
      <taskbar:TaskbarPinList>
        <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\File Explorer.lnk" />
        <taskbar:UWA AppUserModelID="Microsoft.Office.Word_8wekyb3d8bbwe!microsoft.word" />
        <taskbar:UWA AppUserModelID="Microsoft.Office.Excel_8wekyb3d8bbwe!microsoft.excel" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Accessories\Paint.lnk"/>
        <taskbar:UWA AppUserModelID="Microsoft.Reader_8wekyb3d8bbwe!Microsoft.Reader" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
    <defaultlayout:TaskbarLayout>
      <taskbar:TaskbarPinList>
        <taskbar:DesktopApp DesktopApplicationLinkPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\System Tools\File Explorer.lnk" />
        <taskbar:UWA AppUserModelID="Microsoft.Office.Word_8wekyb3d8bbwe!microsoft.word" />
        <taskbar:DesktopApp DesktopApplicationLinkPath="%ALLUSERSPROFILE%\Microsoft\Windows\Start Menu\Programs\Accessories\Paint.lnk"/>
        <taskbar:UWA AppUserModelID="Microsoft.Reader_8wekyb3d8bbwe!Microsoft.Reader" />
      </taskbar:TaskbarPinList>
    </defaultlayout:TaskbarLayout>
  </CustomTaskbarLayoutCollection>
</LayoutModificationTemplate>

When the preceding example XML file is applied, the resulting taskbar for computers in the US or UK:

taskbar for US and UK locale

The resulting taskbar for computers in Germany or France:

taskbar for DE and FR locale

The resulting taskbar for computers in any other country region:

taskbar for all other regions

Note

Look up country and region codes (use the ISO Short column)

Layout Modification Template schema definition

<?xml version="1.0" encoding="utf-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:local="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
            targetNamespace="http://schemas.microsoft.com/Start/2014/TaskbarLayout"
            elementFormDefault="qualified">

  <xsd:complexType name="ct_PinnedUWA">
    <xsd:attribute name="AppUserModelID" type="xsd:string" />
  </xsd:complexType>

  <xsd:complexType name="ct_PinnedDesktopApp">
    <xsd:attribute name="DesktopApplicationID" type="xsd:string" />
    <xsd:attribute name="DesktopApplicationLinkPath" type="xsd:string" />
  </xsd:complexType>

  <xsd:complexType name="ct_TaskbarPinList">
    <xsd:sequence>
      <xsd:choice minOccurs="1" maxOccurs="unbounded">
        <xsd:element name="UWA" type="local:ct_PinnedUWA" />
        <xsd:element name="DesktopApp" type="local:ct_PinnedDesktopApp" />
      </xsd:choice>
    </xsd:sequence>
    <xsd:attribute name="Region" type="xsd:string" use="optional" />
  </xsd:complexType>

  <xsd:simpleType name="st_TaskbarPinListPlacement">
    <xsd:restriction base="xsd:string">
      <xsd:enumeration value="Append" />
      <xsd:enumeration value="Replace" />
    </xsd:restriction>
  </xsd:simpleType>

  <xsd:attributeGroup name="ag_SelectionAttributes">
    <xsd:attribute name="SKU" type="xsd:string" use="optional"/>
    <xsd:attribute name="Region" type="xsd:string" use="optional"/>
  </xsd:attributeGroup>

  <xsd:complexType name="ct_TaskbarLayout">
    <xsd:sequence>
      <xsd:element name="TaskbarPinList" type="local:ct_TaskbarPinList" minOccurs="1" maxOccurs="1" />
    </xsd:sequence>
    <xsd:attributeGroup ref="local:ag_SelectionAttributes"/>
  </xsd:complexType>

</xsd:schema>