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.
Sintaxis
Parameter Set: Debug0
Debug-MMAppPrelaunch -PackageFullName <String> -PackageRelativeAppId <String> [-AsJob] [-CimSession <CimSession[]> ] [-DisableDebugMode] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Descripción detallada
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.
Parámetros
-DisableDebugMode
Specifies that debug mode for the selected application is turned off.
Alias |
ddm |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-PackageFullName<String>
Specifies the AppX package full name containing the application to be prelaunched in debug mode.
Alias |
pfn |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-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.
Alias |
praid |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-AsJob
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-CimSession<CimSession[]>
Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.
Alias |
Session |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-ThrottleLimit<Int32>
Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0
, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
- None
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
Notas
- None
Ejemplos
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; ''}}