FirstRunTask (windows-shell-setup-starttiles-regionaloverrides-regionaloverride-squaretiles-squareordesktoptile3-firstruntask)
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 | StartTiles | RegionalOverrides | RegionalOverride | SquareTiles | SquareOrDesktopTile3 | FirstRunTask
Applies To
For a list of the 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>