Debug-MMAppPrelaunch

Debug-MMAppPrelaunch

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

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

Detaillierte Beschreibung

Prelaunching is a new feature added in Windows® 8,1 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.

Parameter

-DisableDebugMode

Specifies that debug mode for the selected application is turned off.

-PackageFullName<String>

Specifies the AppX package full name containing the application to be prelaunched in debug mode.

-PackageRelativeAppId<String>

Specifies the application ID of the application within the AppX package to be prelaunched. The application ID is found in the package manifest file.

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• None

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Hinweise

• None

Beispiele

Example 1: Prelaunch an app and enable debug mode

This command prelaunches an application in debug mode.

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

Example 2: Clear debug mode from the prelaunch activated app

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

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

Example 3: Getting the PackageFullName and PackageRelativeAppId of your App

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

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

Verwandte Themen

Disable-MMAgent

Enable-MMAgent

Get-MMAgent

Set-MMAgent