> ## 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.

# 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](/pt-BR/tools/tools-console/commandlinetools/xbapp#xbapp_launch).</Note>

| 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`. <br />**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](/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 [xbconfig accesskey](/pt-BR/tools/tools-console/commandlinetools/xbconfig). |
| *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 |

<a id="remarks" />

## 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**.

<a id="ID4EIF" />

## Exemplo

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

<a id="ID4EOF" />

## Veja também

[Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/commandlinetools)

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

[Conexão (xbconnect.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconnect)

[Gerenciamento de aplicativos (xbapp.exe)](/pt-BR/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [Ferramentas de linha de comando para desenvolvimento em console](/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md)
- [Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/index.md)
- [Execução (wdRun.exe)](/pt-BR/tools/tools-console/console_commandlinetools/wdrun.md)
- [Exemplo de execução de tarefa simples](/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync-example-run-simple-task.md)
- [Exemplo de execução de tarefa de API do Microsoft Game Development Kit](/pt-BR/build/core-features/common/async/async-libraries/async-library-xasync-example-run-gdk-task.md)