> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciar pacotes (wdapp.exe)

> Gerenciar pacotes (wdapp.exe)

Use esta ferramenta para registrar novos locais, alterar estados de gerenciamento do tempo de vida do processo (PLM), remover e manipular configurações de pacotes em dispositivos da Plataforma Universal do Windows (UWP).

| Comando | Descrição |
| - | - |
| [registernetworkshare](#wdapp_registernetworkshare) | Registra um aplicativo que está em uma pasta compartilhada na rede |
| [verifynetworkshare](#wdapp_verifynetworkshare) | Verifica o acesso de leitura a um compartilhamento de rede |
| [registerscratch](#wdapp_registerscratch) | Registra um pacote a partir da unidade de rascunho |
| [registertitlescratch](#wdapp_registertitlescratch) | Registra um pacote a partir da unidade de rascunho do título |
| [launch](#wdapp_launch) | Inicia um aplicativo |
| [query](#wdapp_query) | Consulta o estado de execução de um pacote ou aplicativo instalado |
| [terminate](#wdapp_terminate) | Encerra todos os aplicativos de um pacote especificado |
| [suspend](#wdapp_suspend) | Simula a suspensão de um aplicativo |
| [register](#wdapp_register) | Registra um aplicativo |
| [unregister](#wdapp_unregister) | Cancela o registro de um aplicativo |
| [registerdrive](#wdapp_registerdrive) | Registra todos os aplicativos de uma unidade |
| [list](#wdapp_list) | Lista os aplicativos |
| [move](#wdapp_move) | Move um aplicativo |
| [copy](#wdapp_copy) | Copia um aplicativo |
| [movedrive](#wdapp_movedrive) | Move todos os aplicativos de uma unidade |
| [copydrive](#wdapp_copydrive) | Copia todos os aplicativos de uma unidade |
| [install](#wdapp_install) | Instala um build empacotado |
| [uninstall](#wdapp_uninstall) | Desinstala um aplicativo |
| [applyconfig](#wdapp_applyconfig) | Inicia um Game OS com as configurações especificadas |
| [queryconfig](#wdapp_queryconfig) | Imprime o número de versão de quatro partes do Game OS em execução |
| [collectxip](#wdapp_collectxip) | Coleta o rastreamento XIP |
| [queryversioninfo](#wdapp_queryversioninfo) | Consulta a versão do Game OS de um pacote especificado |
| [overlayfolder](#wdapp_overlayfolder) | Gerencia operações de pasta de sobreposição |

<a id="wdapp_registernetworkshare" />

## wdapp registernetworkshare

Registra um aplicativo que está em uma pasta compartilhada na rede.

`wdapp registernetworkshare <Network Path> [Username] [Password]`

| Opção | Descrição |
| - | - |
| `Network Path` | O caminho para o compartilhamento de rede. |
| `Username` | O nome de usuário para acessar o compartilhamento de rede. |
| `Password` | A senha para acessar o compartilhamento de rede. |
| `Verify` | Verifica se os arquivos no local de rede podem ser abertos para confirmar que todos podem ser lidos. |

<a id="wdapp_verifynetworkshare" />

## wdapp verifynetworkshare

Verifica o acesso de leitura a uma pasta compartilhada na rede.

`wdapp verifynetworkshare <Network Path>`

| Opção | Descrição |
| - | - |
| `Network Path` | O caminho para o compartilhamento de rede. |

<a id="wdapp_registerscratch" />

## wdapp registerscratch

Registra um aplicativo que está na unidade de rascunho.

`wdapp registerscratch <Relative folder path>`

| Opção | Descrição |
| - | - |
| `Relative folder path` | O caminho relativo para o aplicativo. |

<a id="wdapp_registertitlescratch" />

## wdapp registertitlescratch

Registra um aplicativo que está na unidade de rascunho do título.

`wdapp registertitlescratch <Relative folder path>`

| Opção | Descrição |
| - | - |
| `Relative folder path` | O caminho relativo para o aplicativo. |

<a id="wdapp_launch" />

## wdapp launch

Inicia o aplicativo fornecido. Se um caminho para um executável for fornecido, o aplicativo será registrado, se necessário, antes da inicialização.

`wdapp launch [/WaitToExit [:timeoutInSeconds]] <AppUserModelId/AUMID | exe | uri | unregv2>`

| Opção | Descrição |
| - | - |
| `AUMID` | A Application User Model ID (AUMID) do aplicativo a ser iniciado. |
| `exe` | O executável do título. |
| `uri` | Um URI de um protocolo personalizado registrado ou do protocolo baseado em título que especifica o título a ser iniciado e quaisquer argumentos a serem passados ao título. Por exemplo, se a ID do seu título for <i>12345abcd</i>, seu produto poderá ser iniciado usando o protocolo baseado em título com o URI <b>ms-xbl-12345abcd://default</b>. |
| `unregv2:\{InstanceId}\{PackageAlias}\{AUMID}` | O unregv2 permite iniciar um pacote não registrado instalado lado a lado com outros pacotes que compartilham uma ContentID. Use wdapp list /d /u para obter os valores de instanceID e PackageAlias |
| WaitToExit \[:timeoutInSeconds] | Inicia o aplicativo e bloqueia até que o título seja encerrado.  Quando o título é encerrado, o xbapp também é encerrado, retornando o código de saída do título. O argumento opcional timeoutInSeconds pode ser usado para forçar a saída. Se o tempo limite for atingido antes que o título seja encerrado, será retornado "The user specified /WaitToExit timeout was exceeded before the game exited.". |

<a id="wdapp_query" />

## wdapp query

Consulta o estado de execução de um pacote ou aplicativo instalado.

`wdapp query <pfn>`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote. |

<a id="wdapp_terminate" />

## wdapp terminate

Encerra todos os aplicativos que estão em um pacote especificado.

`wdapp terminate`

`wdapp terminate <pfn>`

| Opção | Descrição |
| - | - |
| `pfn` | (Opcional) O nome completo do pacote. |

<a id="wdapp_suspend" />

## wdapp suspend

Simula a suspensão de todos os aplicativos que estão em um pacote especificado.

`wdapp suspend`

`wdapp suspend <pfn>`

| Opção | Descrição |
| - | - |
| `pfn` | (Opcional) O nome completo do pacote. |

<a id="wdapp_register" />

## wdapp register

Registra o aplicativo especificado que está na unidade especificada.

`wdapp register <pfn> <drive>`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote. |
| `drive` | A unidade na qual o pacote será registrado. |
| `PackageAlias` | O alias do pacote que você está instalando. Necessário quando você está instalando vários pacotes com a mesma ContentID. |

<a id="wdapp_unregister" />

## wdapp unregister

Cancela o registro do aplicativo especificado.

`wdapp unregister <pfn>`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote. |

<a id="wdapp_registerdrive" />

## wdapp registerdrive

Registra todos os aplicativos atualmente não registrados que estão na unidade especificada.

`wdapp registerdrive <drive>`

| Opção | Descrição |
| - | - |
| `drive` | A unidade na qual os pacotes serão registrados. |

<a id="wdapp_list" />

## wdapp list

Lista todos os aplicativos ou especifica vários sinalizadores para controlar quais aplicativos são enumerados.

`wdapp list [/unregistered] [/system] [/detail] [/drive=<drive>] [/JSON]`

| Opção | Descrição |
| - | - |
| `unregistered` | Enumera os aplicativos não registrados. |
| `system` | Enumera os aplicativos do sistema. |
| `detail` | |
| `drive` | A unidade na qual os aplicativos serão enumerados. |
| `JSON` | Imprime somente o blob JSON que contém as informações do pacote |

<a id="wdapp_move" />

## wdapp move

Move um aplicativo para uma unidade diferente.

`wdapp move <pfn> <destination drive> [new folder name]`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote. |
| `destination drive` | A unidade para a qual o aplicativo será movido. |
| `new folder name` | A pasta para a qual o aplicativo será movido. |

<a id="wdapp_copy" />

## wdapp copy

Copia um aplicativo para uma unidade diferente.

`wdapp copy <pfn> <destination drive> [new folder name]`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote. |
| `destination drive` | A unidade para a qual o aplicativo será copiado. |
| `new folder name` | A pasta para a qual o aplicativo será copiado. |

<a id="wdapp_movedrive" />

## wdapp movedrive

Move todos os aplicativos de uma unidade para uma unidade diferente.

`wdapp movedrive <source drive> <destination drive>`

| Opção | Descrição |
| - | - |
| `source drive` | A unidade da qual os aplicativos serão movidos. |
| `destination drive` | A unidade para a qual os aplicativos serão movidos. |

<a id="wdapp_copydrive" />

## wdapp copydrive

Copia todos os aplicativos de uma unidade para uma unidade diferente.

`wdapp copydrive <source drive> <destination drive>`

| Opção | Descrição |
| - | - |
| `source drive` | A unidade da qual os aplicativos serão copiados. |
| `destination drive` | A unidade para a qual os aplicativos serão copiados. |

<a id="wdapp_install" />

## wdapp install

Transmite um build empacotado para o console a partir de um servidor web, um compartilhamento de rede ou um caminho de arquivo do sistema local.

`wdapp install <package filepath> [/oddsim] [/drive=<drive>] [/<languages|devices|contenttypes|tags>=<semi-colon delimited specifier list>] [/PackageAlias:<alias>]`

| Opção | Descrição |
| - | - |
| `package filepath` | |
| `oddsim` | |
| `drive` | |
| `tags` | |
| `PackageAlias` | Use o PackageAlias para habilitar a instalação lado a lado de pacotes com a mesma ContentID. O alias é o local físico do pacote. Esse valor de alias deve ser globalmente exclusivo apenas para essa instância desse pacote. |

<a id="wdapp_uninstall" />

## wdapp uninstall

Desinstala o aplicativo especificado.  Use o PackageAlias e o InstanceID opcionais (use wdapp list /d) para desinstalar um pacote instalado que não está registrado no momento.

`wdapp uninstall <pfn>`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote do aplicativo. Por padrão, isso desinstalará o título registrado no momento |

<a id="wdapp_applyconfig" />

## wdapp applyconfig

Inicia um Game OS especificado, inicia o Game OS especificado por um arquivo game.config ou inicia o Game OS usado mais recentemente com as configurações padrão.

`wdapp applyconfig [game.config | gameos.xvd]`

| Opção | Descrição |
| - | - |
| `game.config` | Um arquivo game.config usado para especificar o Game OS a ser iniciado. |
| `gameos.xvd` | O Game OS a ser iniciado. |

<a id="wdapp_installkey" />

## wdapp installkey

Instala o EKB de console (CEKB) especificado no console a partir de um compartilhamento de rede ou de um caminho de arquivo do sistema local.

`wdapp installkey [ekb filepath]`

| Opção | Descrição |
| - | - |
| `ekb filepath` | Arquivo EKB gerado quando o makepkg.exe foi executado no título. |

<a id="wdapp_queryconfig" />

## wdapp queryconfig

Imprime o número de versão de quatro partes do Game OS em execução. Se nenhum Game OS estiver em execução, será retornado um erro.

`wdapp queryconfig`

<a id="wdapp_collectxip" />

## wdapp collectxip

Se um ERA do XBOX One estiver em execução, coleta o rastreamento XIP e disponibiliza o rastreamento atual no compartilhamento de arquivos do desenvolvedor como `<output name>` ou `<guid>.pfm`.

`wdapp collectxip ["Output file name"]`

| Opção | Descrição |
| - | - |
| `output name` | O nome de saída do rastreamento XIP. |

<a id="wdapp_queryversioninfo" />

## wdapp queryversioninfo

Consulta a versão do Game OS associada ao pacote especificado. Também tenta ver se o sistema operacional corresponde a alguma informação carimbada no executável do jogo. Especifique `/b` para imprimir somente a versão do Game OS sem nenhuma outra saída. Você só pode consultar um pacote registrado; se tiver vários pacotes instalados com a mesma ContentID, precisará registrar o pacote antes de consultar suas informações de versão.

`wdapp queryversioninfo <pfn> [/b]`

| Opção | Descrição |
| - | - |
| `pfn` | O nome completo do pacote a ser consultado. |
| `/b` | Imprime somente a versão do Game OS sem nenhuma outra saída. |

<a id="wdapp_overlayfolder" />

## wdapp overlayfolder

Define ou limpa uma pasta de sobreposição para um nome completo de pacote especificado, ou use /R para limpar todas as pastas de sobreposição.

`wdapp overlayfolder [/R | <pfn> [/r | <overlay folder path>]]`

| Opção | Descrição |
| - | - |
| `/R` | Limpa todas as pastas de sobreposição. |
| `pfn` | O nome completo do pacote para o qual a pasta de sobreposição será definida ou limpa. |
| `/r` | Limpa a pasta de sobreposição especificada. |
| `path` | O caminho para a pasta de sobreposição a ser definida. |

<a id="xbapp_lastgamedetails" />

### xbapp lastgamedetails

Recupera alguns detalhes sobre o último jogo executado, incluindo o nome, a versão do sistema operacional e o código de saída

| Coluna 1 |
| - |
| **xbapp lastgamedetails** \[/X\[:]*address\[+`<accesskey>`]*] |

| Opção | Descrição |
| - | - |
| `/X[:]*address[<accesskey>]` | -  Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname).<br />-  Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconnect)). <br /> - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. <br />- Defina a chave de acesso usando o comando **xbconfig accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor.<br />- Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console.<br />- Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](/pt-BR/tools/tools-console/commandlinetools/xbconnect), a chave de acesso será armazenada como parte do endereço do console padrão.<br />- Para obter mais informações sobre chaves de acesso, veja [Configuração (xbconfig.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconfig). |

## Veja também

[Ferramentas de linha de comando do console](/pt-BR/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[Erros de transporte do XTF](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

- [Ferramentas de linha de comando baseadas no console](/pt-BR/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [Ferramentas de linha de comando baseadas no console para XBOX](/pt-BR/tools/tools-console/console_commandlinetools/index.md)
- [Testando pacotes em um PC de desenvolvimento](/pt-BR/build/core-features/common/packaging/packaging-testing-PC-install.md)
- [Registro de jogos para PC com o wdapp.exe](/pt-BR/tools/tools-pc/title-registration-pc.md)
- [Gerenciar dados do XGameSave no PC (xgamesaveutil.exe)](/pt-BR/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md)
