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

# 執行 (xbrun.exe)

> 執行 (xbrun.exe)

使用此工具在遠端主機上啟動可執行檔 (也就是測試工具)。

<Note>如果傳入 **xbrun** 的可執行檔呼叫 `XGameRuntimeInitialize`，就會遇到失敗訊息 "The image was not launched as a game"。若要使用命令列工具啟動呼叫 `XGameRuntimeInitialize` 的可執行檔，請使用 [xbapp launch](/zh-TW/tools/tools-console/commandlinetools/xbapp#xbapp_launch)。</Note>

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

| 選項 | 描述 |
| - | - |
| /D\[:]*path* | 指定命令的工作目錄。如果未指定目錄，預設會使用 `%SystemRoot%`。 |
| /G | 以來賓使用者身分啟動處理序。根據預設，處理序會以系統使用者身分啟動。 |
| /I | 將輸入重新導向至本機主控台。在目前主控台視窗中輸入的任何文字，都會重新導向至遠端主機。 |
| /O | 將輸出重新導向至本機主控台。列印至遠端主機主控台視窗的任何文字，都會重新導向至本機主控台。 |
| /W | 結束前，等候遠端處理序終止。如果指定了 **/I**、**/O** 或兩者，則隱含 **/W**。 |
| /V | 顯示詳細輸出。此選項會附加傳回值來源的資訊 (結束代碼來自遠端執行的處理序還是 xbrun)。 |
| /L | 將輸出格式化為適用於記錄檔的格式。只有在指定 /O 時才有作用。 |
| /J | 在工具工作物件中啟動新的處理序。這只適用於 `title` 分割區。 <br />\*\*注意：\*\*請謹慎使用此選項，因為工具工作物件的保留記憶體非常有限，且由工具工作物件內的所有處理序共用。超過整體限制會結束工具工作物件、其中的所有處理序，以及與 `title` 分割區的工具連線 (直到重新啟動為止)。 |
| /X\[:]*address\[+`<accesskey>`]* | - 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 **Tools IP**)，而不需變更預設主機。如需為主機設定主機名稱的詳細資訊，請參閱[為主機 IP 位址設定主機名稱](/zh-TW/home/setup-install/dev-kit-settings/setting-a-hostname)。<br />- 如果您不使用此選項，則會使用預設主機 (先前由[連線 (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect) 設定)。 <br />- 使用 *accesskey* 字串，只為擁有存取金鑰的人員提供主機存取權。 <br />- 使用 **xbconfig** **accesskey=your-key** 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。<br />- 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。<br />- 如果在使用 [xbconnect](/zh-TW/tools/tools-console/commandlinetools/xbconnect) 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。<br />- 如需存取金鑰的詳細資訊，請參閱 [xbconfig accesskey](/zh-TW/tools/tools-console/commandlinetools/xbconfig)。 |
| *command* | 要執行的命令以及要傳遞給可執行檔的引數。命令是傳遞給 **xbrun** 的最後一個參數。所有其他參數都會自動附加至命令並傳遞至遠端裝置。可執行檔必須指定檔案類型。例如，**net** 命令必須指定為 net.exe。 |
| /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼 |

<a id="remarks" />

## 備註

* **xbrun** 會在 `exclusive` 分割區中以具有系統權限的來賓使用者身分執行。

* **xbrun** 支援在遠端裝置上展開的環境變數。例如，`%SystemRoot%` 會自動展開為遠端裝置的作業系統目錄。

* 參數周圍的引號會自動移除。如果要在傳遞至遠端裝置的命令列中保留引號，請在引號前面加上反斜線 (\\)。

* 如果您指定的命令不含目錄路徑，系統會依下列順序搜尋可執行檔。
  1. Windows 系統目錄
  2. Windows 目錄
  3. PATH 環境變數中列出的目錄

* 嘗試載入可執行檔時，**xbrun** *不會*自動搜尋使用 **/D** 參數指定的工作目錄。

* 許多主控台應用程式 (包括 cmd.exe) 會直接從主控台讀取輸入，而不是從標準輸入管道讀取。這些應用程式不支援 **/I** 參數。此外，任何直接寫入主控台而非 **stdout** 或 **stderr** 的應用程式，其輸出都不會被 **/O** 參數重新導向。

<a id="ID4EIF" />

## 範例

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

<a id="ID4EOF" />

## 另請參閱

[命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools)

[XTF 傳輸錯誤](/zh-TW/tools/tools-console/commandlinetools/xtf-transport-errors)

[連線 (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect)

[應用程式管理 (xbapp.exe)](/zh-TW/tools/tools-console/commandlinetools/xbapp)


## Related topics

- [主機開發的命令列工具](/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令列工具](/zh-TW/tools/tools-console/commandlinetools/index.md)
- [執行 (wdRun.exe)](/zh-TW/tools/tools-console/console_commandlinetools/wdrun.md)
- [連線 (xbconnect.exe)](/zh-TW/tools/tools-console/commandlinetools/xbconnect.md)
- [packageutil.exe](/zh-TW/build/core-features/common/packaging/deployment/packageutil.md)