PowerShell Logo Small

Debug-MMAppPrelaunch



This is the built-in help made by Microsoft for the command 'Debug-MMAppPrelaunch', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Provides the ability to debug the application prelaunch of a specific application by triggering the prelaunch to occur and to exit debug mode for the application.

SYNTAX


Debug-MMAppPrelaunch [-AsJob] [-CimSession <CimSession[]>] [-DisableDebugMode] [-ThrottleLimit <Int32>] -PackageFullName <String> -PackageRelativeAppId <String>
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


Prelaunching is a new feature added in Windows® 8.1 Preview that improves the launch performance of apps from the Windows Store by proactively launching frequently used apps
in the background if they are not already running or suspended. This makes starting an app as fast as switching to a suspended app from the user’s perspective. This command
enables you to prelaunch an app into debug mode.


You identify the application to prelaunch by including the –PackageFullName and -PackageRelativeAppId parameters.


To turn off debugging, specify the application and also include the –DisableDebugMode.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=307067
Disable-MMAgent
Enable-MMAgent
Get-MMAgent
Set-MMAgent

REMARKS

<

Examples


Example 1: Prelaunch an app and enable debug mode

PS C:\>Debug-MmAppPreLaunch -PackageFullName Microsoft.ZuneMusic_2.0.94.0_x64__8wekyb3d8bbwe -PackageRelativeAppId Microsoft.ZuneMusic



This command prelaunches an application in debug mode.




Example 2: Clear debug mode from the prelaunch activated app

PS C:\>Debug-MmAppPreLaunch -PackageFullName Microsoft.ZuneMusic_2.0.94.0_x64__8wekyb3d8bbwe -PackageRelativeAppId Microsoft.ZuneMusic -DisableDebugMode



This command disables the debug mode from the app that you previously prelaunch activated.




Example 3: Getting the PackageFullName and PackageRelativeAppId of your App

PS C:\>ForEach ($Package in Get-AppxPackage) {ForEach ($AppRelativeId in (Get-AppxPackageManifest($Package)).Package.Applications.Application.Id) {'PackageFullName: ' +
$Package.PackageFullName; 'PackageRelativeId: ' + $AppRelativeID; ''}}



This command shows how you can find the PackageFullName and PackageRelativeAppId information for your package.