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

# Execução (xbrun.exe)

> Execução (xbrun.exe)

Use esta ferramenta para iniciar um executável (ou seja, uma ferramenta de teste) em um console remoto.

> [!NOTE]
>
> Se um executável passado para o **xbrun** chamar `XGameRuntimeInitialize`, ele encontrará a mensagem de falha "The image was not launched as a game". Para iniciar um executável que chama `XGameRuntimeInitialize` com uma ferramenta de linha de comando, use [xbapp launch](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md#xbapp_launch).

| Coluna 1 |
| - |
| **xbrun** \[/D\[:]*path*] \[/G] \[/I] \[/O] \[/W] \[/J] \[/L] \[/V] \[/X\[:]*address\[+`<accesskey>`]*] *command* |

| Opção | Descrição |
| - | - |
| /D\[:]*path* | Especifica o diretório de trabalho do comando. Se nenhum diretório for especificado, `%SystemRoot%` será usado por padrão. |
| /G | Inicia o processo como o usuário convidado. Por padrão, os processos são iniciados como o usuário do sistema. |
| /I | Redireciona a entrada para o console local. Qualquer texto inserido na janela do console atual é redirecionado para o console remoto. |
| /O | Redireciona a saída para o console local. Qualquer texto impresso na janela do console remoto é redirecionado para o console local. |
| /W | Antes de sair, aguarda o encerramento do processo remoto. Se **/I**, **/O** ou ambos forem especificados, **/W** está implícito. |
| /V | Mostra uma saída detalhada. Essa opção acrescenta informações sobre a origem dos valores de retorno (se o código de saída vem do processo executado remotamente ou do xbrun). |
| /L | Formata a saída de forma adequada para um arquivo de log. Só tem efeito quando /O é especificado. |
| /J | Inicia o novo processo dentro do objeto de trabalho das ferramentas. Isso se aplica somente à partição `title`. **OBSERVAÇÃO:** use essa opção com cuidado, porque o objeto de trabalho das ferramentas tem uma memória reservada muito limitada, compartilhada por todos os processos dentro dele. Exceder o limite geral encerra o objeto de trabalho das ferramentas, todos os processos dentro dele e a conexão das ferramentas com a partição `title` (até que ela seja reiniciada). |
| /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](https://docs.xbox.com/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname.md). - Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)). - Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - 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. - 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. - Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md). |
| *command* | O comando a ser executado e os argumentos a serem passados ao executável. O comando é o parâmetro final passado ao **xbrun**. Todos os parâmetros adicionais são acrescentados automaticamente ao comando e passados ao dispositivo remoto. Os executáveis devem ter o tipo de arquivo especificado. Por exemplo, o comando **net** teria que ser especificado como net.exe. |
| /LC | Especifica o código de localidade. Usado para substituir o código de localidade padrão |

## Comentários

* O **xbrun** é executado como o usuário convidado com privilégios de sistema na partição `exclusive`.

* O **xbrun** dá suporte a variáveis de ambiente que são expandidas no dispositivo remoto. Por exemplo, `%SystemRoot%` é expandido automaticamente para o diretório do sistema operacional do dispositivo remoto.

* As aspas em torno dos parâmetros são removidas automaticamente. Se uma aspa precisar ser preservada na linha de comando passada ao dispositivo remoto, preceda-a com uma barra invertida (\\).

* Se o comando especificado não contiver um caminho de diretório, o sistema procurará o arquivo executável na seguinte sequência.
  1. O diretório do sistema do Windows
  2. O diretório do Windows
  3. Os diretórios listados na variável de ambiente PATH

* Durante uma tentativa de carregar o executável, o **xbrun** *não* pesquisa automaticamente o diretório de trabalho especificado usando a opção **/D**.

* Muitos aplicativos de console (incluindo o cmd.exe) leem a entrada diretamente do console, e não do pipe de entrada padrão. Esses aplicativos não dão suporte à opção **/I**. Além disso, qualquer aplicativo que grave diretamente no console em vez de em **stdout** ou **stderr** não terá sua saída redirecionada pela opção **/O**.

## Exemplo

```
xbrun /O /D:%SystemRoot%\System32 CMD.EXE /C ECHO Here are some \"quotes.\"  
```

## Veja também

[Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)

[Erros de transporte do XTF](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors.md)

[Conexão (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)

[Gerenciamento de aplicativos (xbapp.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md)


## Related topics

- [Ferramentas de linha de comando para desenvolvimento em console](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)
- [Ferramentas de linha de comando](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/index.md)
- [Execução (wdRun.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/console_commandlinetools/wdrun.md)
- [Exemplo de execução de tarefa simples](https://docs.xbox.com/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
- [Reinicialização (xbreboot.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbreboot.md)