Partager via

Microsoft-Windows-Embedded-EmbeddedAppLauncher (Industry 8.1)

  • Article

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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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>

See Also

Concepts

Add lockdown and branding features to your image by using Windows SIM
Windows 8 Application Launcher
Find the Application User Model ID of an installed app