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.

Синтаксис

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

Подробное описание

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.

Параметры

-DisableDebugMode

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

Псевдонимы

ddm

Требуется?

false

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

True (ByPropertyName)

Принимать подстановочные знаки?

false

-PackageFullName<String>

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

Псевдонимы

pfn

Требуется?

true

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

True (ByPropertyName)

Принимать подстановочные знаки?

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.

Псевдонимы

praid

Требуется?

true

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

True (ByPropertyName)

Принимать подстановочные знаки?

false

-AsJob

Псевдонимы

отсутствуют

Требуется?

false

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-CimSession<CimSession[]>

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.

Псевдонимы

Session

Требуется?

false

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

-ThrottleLimit<Int32>

Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.

Псевдонимы

отсутствуют

Требуется?

false

Указать положение?

named

Значение по умолчанию

отсутствуют

Принимать входные данные конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Входные данные

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

  • None

Выходные данные

Тип выходных данных — это тип объектов, которые выдает командлет.

Примечания

  • None

Примеры

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; ''}}

Связанные темы

Disable-MMAgent

Enable-MMAgent

Get-MMAgent

Set-MMAgent