Share via

FirstRunTask (microsoft-windows-shell-setup-starttiles-regionaloverrides-regionaloverride-squaretiles-squaretile12-firstruntask)

  • Article

The FirstRunTask setting specifies the background task that is active, or live, by default for a tile when a user signs in to Windows for the first time.

The background task must register the user with Windows Notification Service at first sign-in, and must send notifications to the app’s live tile.

If the region of the current user account is among those in the Start Tile regional layouts, you can use this setting. For more information, see RegionalOverrides.

Values

To make a tile live, do one of the following:

  • If your background task is in JavaScript, specify the .js file that implements the IBackgroundTask interface.

  • If your background task is in XAML or C++, specify the class ID for the application.

Valid Configuration Passes

specialize

auditUser

oobeSystem

Parent Hierarchy

Microsoft-Windows-Shell-Setup | RegionalOverrides | RegionalOverride | SquareTiles | SquareTile12 | FirstRunTask

Applies To

For a list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Shell-Setup.

XML Example

The following XML output shows how to use the <SquareTiles> component.

     <SquareTiles>
          <SquareOrDesktopTile1>
               <AppIdOrPath>C:\programdata\microsoft\windows\start menu\programs\desktoptile1.lnk</AppIdOrPath>
               <FirstRunTask>backgroundtask.js</FirstRunTask>
          </SquareOrDesktopTile1>
          <SquareOrDesktopTile2>
               <AppIdOrPath>67890ChannelFabrikam.channel-JKL_mnop1234789!App</AppIdOrPath>
               <FirstRunTask>Fabrikam.FirstRunTask</FirstRunTask>
          </SquareOrDesktopTile2>
          <SquareOrDesktopTile3>
               <AppIdOrPath>C:\programdata\microsoft\windows\start menu\programs\desktoptile3.lnk</AppIdOrPath>
          </SquareOrDesktopTile3>
          <SquareTile1>
               <AppId>12345ChannelFabrikam.channel-ABC_defghij6789!App</AppId>
               <FirstRunTask>backgroundtask.js</FirstRunTask>
          </SquareTile1>
          <SquareTile2>
               <AppId>34567ChannelFabrikam.channel-DEF_012ghijk345!App</AppId>
               <FirstRunTask>Fabrikam.FirstRunTask</FirstRunTask>
          </SquareTile2>
          <SquareTile3>
               <AppId>56789ChannelFabrikam.channel-GHI_67890jklmno!App</AppId>
          </SquareTile3>
     </SquareTiles>

StartTiles

RegionalOverrides

SquareTiles

SquareTiles