FirstRunTask (microsoft-windows-shell-setup-starttiles-squaretiles-squareordesktoptile1-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.
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 | SquareOrDesktopTile1 | 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>