FirstRunTask (microsoft-windows-shell-setup-starttiles-regionaloverrides-regionaloverride-squaretiles-squaretile12-firstruntask)
FirstRunTask
设置指定用户首次登录 Windows 时针对一个磁贴默认活动或动态的后台任务。
后台任务必须在首次登录时向 Windows 通知服务注册用户,并且必须将通知发送到应用的动态磁贴。
如果当前用户帐户的区域属于“启动磁贴”区域布局中的区域,则可以使用此设置。 有关详细信息,请参阅 RegionalOverrides。
值
若要使磁贴处于动态,请执行下列操作之一:
如果后台任务是使用 JavaScript 编写的,则指定实现 IBackgroundTask 接口的 .js 文件。
如果后台任务是使用 XAML 或 C++ 编写的,则指定应用程序的类 ID。
有效配置阶段
specialize
auditUser
oobeSystem
父层次结构
Microsoft-Windows-Shell-Setup | RegionalOverrides | RegionalOverride | SquareTiles | SquareTile12 | FirstRunTask
应用于
有关此组件支持的受支持 Windows 版本和体系结构的列表,请参阅 Microsoft-Windows-Shell-Setup。
XML 示例
以下 XML 输出演示了如何使用 <SquareTiles>
组件。
<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>