Microsoft-Windows-Embedded-EmbeddedAppLauncher (Industry 8.1)

7/8/2014

Review the settings and examples of the Microsoft-Windows-Embedded-EmbeddedAppLauncher feature package for Windows System Image Manager (SIM) in Windows Embedded 8.1 Industry (Industry 8.1).

You can use Windows 8 Application Launcher to start a Windows Store app immediately after a user signs in to a Windows Embedded 8.1 Industry (Industry 8.1) device and to restart the app when the app exits. You can configure Windows 8 Application Launcher to launch different apps for different users.

If the Windows Store app is written specifically to work with Windows 8 Application Launcher, you can configure Windows 8 Application Launcher to perform a specified action based on an exit value returned by the app. For example, you could configure Windows 8 Application Launcher to shut down or restart the device when the app exits.

Warning

You cannot have both Shell Launcher and Windows 8 Application Launcher enabled at the same time.

Settings available in Windows SIM

Default app settings

The default app settings are used when Windows 8 Application Launcher is enabled but the user currently signed in does not match any custom defined Windows 8 Application Launcher configurations.

Setting	Description
AppUserModelId	Specifies the Application User Model ID (AUMID) of the installed app to launch.
DefaultReturnCodeAction	Specifies what default action to take, based on the return code.

CustomReturnCodeAction| LauncherAction settings

These settings are used for all users to map an exit code from the app to a Windows 8 Application Launcher action code. If the app exit code does not match a defined value, Windows 8 Application Launcher performs the default return code action.

Setting	Description
Action	Specifies the action to take when the launched app exits.
Action	Specifies whether to add, modify, or remove the custom return code configuration from the list.
ReturnCode	Specifies what application return code to map to the action.

UserSettings | User settings

The UserSettings settings are used to specify what application and what default return code action is to be used for specific users or user groups.

Setting	Description
AccountName	Specifies the user or group account the application will be launched for.
Action	Specifies whether to add, modify, or remove the custom user configuration from the list.
AppUserModelId	Specifies the Application User Model ID (AUMID) of the installed app to be launched for the specified user or user group.
DefaultReturnCodeAction	Specifies the default action to take when the application exits.
Domain	Specifies the domain for the account name.
Key	Index key for this setting in the setting list.

UserSettings | User | CustomReturnCodeAction settings

These settings are used to map an application exit code to an exit action.

Setting	Description
Action	Specifies the action to take.
Action	Specifies whether to add, modify, or remove the custom user return code configuration from the list.
ReturnCode	Specifies the application return code to map to the action.

Settings details

Default app settings

AppUserModelId

Specifies the Application User Model ID (AUMID) of the installed app to launch.

Type
String

Values

Value

Description

AppUserModelId

Specifies the Application User Model ID (AUMID) for the installed application to launch.

Value	Description
AppUserModelId	Specifies the Application User Model ID (AUMID) for the installed application to launch.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | AppUserModelID

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
       <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
    </component>
</settings>

DefaultReturnCodeAction

Specifies what default action to take, based on the return code.

Type
Int32

Values

Value

Description

0

Restart the app.

1

Restart the device.

2

Shut down the device.

3

Close Windows 8 Application Launcher.

4

Sign out.

Value	Description
0	Restart the app.
1	Restart the device.
2	Shut down the device.
3	Close Windows 8 Application Launcher.
4	Sign out.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | DefaultReturnCodeAction

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
       <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
    </component>
</settings>

CustomReturnCodeAction | LauncherAction settings

Action

Specifies the action to take when the launched app exits.

Type
Int32

Values

Value

Description

0

Restart the app.

1

Restart the device.

2

Shut down the device.

3

Close Windows 8 Application Launcher.

4

Sign out.

Value	Description
0	Restart the app.
1	Restart the device.
2	Shut down the device.
3	Close Windows 8 Application Launcher.
4	Sign out.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | CustomReturnCodeAction | LauncherAction | Action

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <CustomReturnCodeAction>
            <LauncherAction wcm:action="add">
               <Action>4</Action>
               <ReturnCode>-255</ReturnCode>
            </LauncherAction>
        </CustomReturnCodeAction>
    </component>
</settings>

Action

Specifies whether to add, modify, or remove the custom return code configuration from the list.

Values

Value

Description

AddListItem

Add a new custom configuration to the list.

Modify

Modify an existing custom configuration.

RemoveListItem

Remove a custom configuration from the list.

Value	Description
AddListItem	Add a new custom configuration to the list.
Modify	Modify an existing custom configuration.
RemoveListItem	Remove a custom configuration from the list.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | CustomReturnCodeAction | LauncherAction | Action

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <CustomReturnCodeAction>
            <LauncherAction wcm:action="add">
               <Action>4</Action>
               <ReturnCode>-255</ReturnCode>
            </LauncherAction>
        </CustomReturnCodeAction>
    </component>
</settings>

ReturnCode

Specifies what application return code to map to the action.

Type
String

Values

Value

Description

CustomReturnCode

Specifies the application return code to map to the action code.

Value	Description
CustomReturnCode	Specifies the application return code to map to the action code.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | CustomReturnCodeAction | LauncherAction | ReturnCode

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <CustomReturnCodeAction>
            <LauncherAction wcm:action="add">
               <Action>4</Action>
               <ReturnCode>-255</ReturnCode>
            </LauncherAction>
        </CustomReturnCodeAction>
    </component>
</settings>

User | UserSettings settings

AccountName

Specifies the user or group account the application will be launched for.

Type
String

Values

Value

Description

UserOrGroupName

Specifies the name of the user or user group this application will apply to.

Value	Description
UserOrGroupName	Specifies the name of the user or user group this application will apply to.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | AccountName

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

Action

Specifies whether to add, modify, or remove the custom user configuration from the list.

Values

Value

Description

AddListItem

Add a new custom configuration to the list.

Modify

Modify an existing custom configuration.

RemoveListItem

Remove a custom configuration from the list.

Value	Description
AddListItem	Add a new custom configuration to the list.
Modify	Modify an existing custom configuration.
RemoveListItem	Remove a custom configuration from the list.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | Action

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

AppUserModelId

Specifies the Application User Model ID (AUMID).of the installed app to be launched for this user.

Type
String

Values

Value

Description

AppUserModelId

Specifies the Application User Model ID (AUMID) for the installed application to launch.

Value	Description
AppUserModelId	Specifies the Application User Model ID (AUMID) for the installed application to launch.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | AppUserModelID

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

DefaultReturnCodeAction

Specifies the default action to take when the application exits.

Type
Int32

Values

Value

Description

0

Restart the app.

1

Restart the device.

2

Shut down the device.

3

Close Windows 8 Application Launcher.

4

Sign out.

Value	Description
0	Restart the app.
1	Restart the device.
2	Shut down the device.
3	Close Windows 8 Application Launcher.
4	Sign out.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | DefaultReturnCodeAction

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

Domain

Specifies the domain for the account name.

Type
String

Values

Value

Description

UserOrGroupDomain

Specifies the domain of the user or user group this custom application will be used for.

Value	Description
UserOrGroupDomain	Specifies the domain of the user or user group this custom application will be used for.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | Domain

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

Key

Index key for this setting in the setting list.

Type
UInt32, Min 1

Values

Value

Description

IntegerKey

Specifies the unique key of this user setting in the list.

Value	Description
IntegerKey	Specifies the unique key of this user setting in the list.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | Key

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <AccountName>MyNome</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>1</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>1</Key>
            </User>
        </UserSettings>
    </component>
</settings>

User | CustomReturnCodeAction | LauncherAction settings

Action

Specifies the action to take.

Type
Int32

Values

Value

Description

0

Restart the app.

1

Restart the device.

2

Shut down the device.

3

Close Windows 8 Application Launcher.

4

Sign out.

Value	Description
0	Restart the app.
1	Restart the device.
2	Shut down the device.
3	Close Windows 8 Application Launcher.
4	Sign out.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | CustomReturnCodeAction | LauncherAction | Action

Valid passes

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <CustomReturnCodeAction>
                    <LauncherAction wcm:action="add">
                        <Action>4</Action>
                        <ReturnCode>0</ReturnCode>
                    </LauncherAction>
                </CustomReturnCodeAction>
                <AccountName>MyName</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>4</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>3</Key>
            </User>
        </UserSettings>
        <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
    </component>
</settings>

Action

Specifies whether to add, modify, or remove the custom user return code configuration from the list.

Values

Value

Description

AddListItem

Add a new custom configuration to the list.

Modify

Modify an existing custom configuration.

RemoveListItem

Remove a custom configuration from the list.

Value	Description
AddListItem	Add a new custom configuration to the list.
Modify	Modify an existing custom configuration.
RemoveListItem	Remove a custom configuration from the list.

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | CustomReturnCodeAction | LauncherAction | Action

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <CustomReturnCodeAction>
                    <LauncherAction wcm:action="add">
                        <Action>4</Action>
                        <ReturnCode>0</ReturnCode>
                    </LauncherAction>
                </CustomReturnCodeAction>
                <AccountName>MyName</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>4</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>3</Key>
            </User>
        </UserSettings>
        <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
    </component>
</settings>

ReturnCode

Specifies the application return code to map to the action.

Type

Value

Description

CustomReturnCode

Specifies the application return code to map to the indicated action code.

Value	Description
CustomReturnCode	Specifies the application return code to map to the indicated action code.

Values

Parent hierarchy
Microsoft-Windows-Embedded-EmbeddedAppLauncher | UserSettings | User | CustomReturnCodeAction | LauncherAction | ReturnCode

Valid passes
oobeSystem

XML example

<settings pass="oobeSystem">
    <component name="Microsoft-Windows-Embedded-EmbeddedAppLauncher" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="NonSxS" xmlns:wcm="https://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <UserSettings>
            <User wcm:action="add">
                <CustomReturnCodeAction>
                    <LauncherAction wcm:action="add">
                        <Action>4</Action>
                        <ReturnCode>0</ReturnCode>
                    </LauncherAction>
                </CustomReturnCodeAction>
                <AccountName>MyName</AccountName>
                <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
                <DefaultReturnCodeAction>4</DefaultReturnCodeAction>
                <Domain>MyDomain</Domain>
                <Key>3</Key>
            </User>
        </UserSettings>
        <AppUserModelId>DefaultBrowser_NOPUBLISHERID!Microsoft.InternetExplorer.Default</AppUserModelId>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
    </component>
</settings>

Microsoft-Windows-Embedded-EmbeddedAppLauncher (Industry 8.1)

Settings available in Windows SIM

Default app settings

CustomReturnCodeAction| LauncherAction settings

UserSettings | User settings

UserSettings | User | CustomReturnCodeAction settings

Settings details

Default app settings

AppUserModelId

DefaultReturnCodeAction

CustomReturnCodeAction | LauncherAction settings

Action

Action

ReturnCode

User | UserSettings settings

AccountName

Action

AppUserModelId

DefaultReturnCodeAction

Domain

Key

User | CustomReturnCodeAction | LauncherAction settings

Action

Action

ReturnCode

See Also

Concepts

Zusätzliche Ressourcen