執行 (xbrun.exe) - XBOX Game Development Documentation

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

如果傳入 xbrun 的可執行檔呼叫 XGameRuntimeInitialize，就會遇到失敗訊息 “The image was not launched as a game”。若要使用命令列工具啟動呼叫 XGameRuntimeInitialize 的可執行檔，請使用 xbapp launch。

欄 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` 分割區。注意：請謹慎使用此選項，因為工具工作物件的保留記憶體非常有限，且由工具工作物件內的所有處理序共用。超過整體限制會結束工具工作物件、其中的所有處理序，以及與 `title` 分割區的工具連線 (直到重新啟動為止)。
/X[:]address[+`<accesskey>`]	- 使用此選項可指定目標主機的主機名稱或位址 (在主機上顯示為 Tools IP)，而不需變更預設主機。如需為主機設定主機名稱的詳細資訊，請參閱為主機 IP 位址設定主機名稱。 - 如果您不使用此選項，則會使用預設主機 (先前由連線 (xbconnect.exe) 設定)。 - 使用 accesskey 字串，只為擁有存取金鑰的人員提供主機存取權。 - 使用 xbconfig accesskey=your-key 命令設定存取金鑰，然後重新啟動主機，讓存取金鑰生效。 - 若要存取已設定存取金鑰的主機，請在主機的 IP 位址或主機名稱後面加上加號 (+) 與存取金鑰。 - 如果在使用 xbconnect 設定預設主機時提供了存取金鑰，該存取金鑰會儲存為預設主機位址的一部分。 - 如需存取金鑰的詳細資訊，請參閱 xbconfig accesskey。
command	要執行的命令以及要傳遞給可執行檔的引數。命令是傳遞給 xbrun 的最後一個參數。所有其他參數都會自動附加至命令並傳遞至遠端裝置。可執行檔必須指定檔案類型。例如，net 命令必須指定為 net.exe。
/LC	指定地區設定代碼。用於覆寫預設的地區設定代碼

備註

xbrun 會在 exclusive 分割區中以具有系統權限的來賓使用者身分執行。
xbrun 支援在遠端裝置上展開的環境變數。例如，%SystemRoot% 會自動展開為遠端裝置的作業系統目錄。
參數周圍的引號會自動移除。如果要在傳遞至遠端裝置的命令列中保留引號，請在引號前面加上反斜線 (\)。
如果您指定的命令不含目錄路徑，系統會依下列順序搜尋可執行檔。
1. Windows 系統目錄
2. Windows 目錄
3. PATH 環境變數中列出的目錄
嘗試載入可執行檔時，xbrun 不會自動搜尋使用 /D 參數指定的工作目錄。
許多主控台應用程式 (包括 cmd.exe) 會直接從主控台讀取輸入，而不是從標準輸入管道讀取。這些應用程式不支援 /I 參數。此外，任何直接寫入主控台而非 stdout 或 stderr 的應用程式，其輸出都不會被 /O 參數重新導向。

範例

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

另請參閱

命令列工具 XTF 傳輸錯誤連線 (xbconnect.exe) 應用程式管理 (xbapp.exe)

最後修改於 2026年10月8日

⌘I