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.
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 | SquareTiles | SquareTile11 | 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> |