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

# 使用者管理 (xbuser.exe)

> 使用者管理 (xbuser.exe)

使用此工具在開發套件中新增使用者、移除使用者、讓使用者登入或登出。此工具提供下列子命令與功能。

| 命令 | 描述 |
| - | - |
| [xbuser add](#xbuser_add) | 將使用者新增至主機。 |
| [xbuser addsponsored](#xbuser_addsponsored) | 將受贊助的使用者新增至主機並讓該使用者登入。 |
| [xbuser delete](#xbuser_delete) | 刪除具有指定 ID 或電子郵件地址的使用者。 |
| [xbuser deleteall](#xbuser_deleteall) | 從主機刪除所有使用者。 |
| [xbuser list](#xbuser_list) | 列出主機的所有使用者。 |
| [xbuser signin](#xbuser_signin) | 以指定的 ID 或電子郵件地址讓使用者登入。如果使用者尚未存在於主機上，則會將使用者新增至主機。 |
| [xbuser signout](#xbuser_signout) | 以指定的 ID 或電子郵件地址讓使用者登出。 |

## xbuser add

將使用者新增至主機。這會新增*現有*的帳戶，不會建立新帳戶。

新增的使用者在開發套件切換至零售模式或從零售模式切換回來時都會保留。如果未執行出廠重設，新增的使用者在開發套件復原後也會保留。

| 欄 1 |
| - |
| **xbuser add** \[/e\[:]*email address*] |

| 選項 | 描述 |
| - | - |
| /e\[:]*email address* | 要新增至主機之使用者的電子郵件地址 |
| /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼 |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser addsponsored

將受贊助的使用者新增至主機並讓該使用者登入。

來賓使用者會與已登入的帳戶相關聯。系統會挑選一位目前已登入的使用者作為贊助者。之後對 **addsponsored** 的呼叫會繼續將該使用者用於所有後續的受贊助使用者。如果所選的使用者登出，所有受贊助的使用者也會同時登出。

如果沒有任何使用者登入，**addsponsored** 命令就會失敗。

| 欄 1 |
| - |
| \*\*xbuser addsponsored \*\* |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser delete

從主機刪除使用者。

| 欄 1 | |
| - | - |
| **xbuser delete** \[/i:\<userId> | /e:\<email address>] |

| 選項 | 描述 | |
| - | - | - |
| /i:\<userId> | /e:\<email address> | 要刪除之使用者的 ID 或電子郵件地址 |
| /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼。 | |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser deleteall

從主機刪除所有使用者。

| 欄 1 |
| - |
| \*\*xbuser deleteall \*\* |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser list

列出主機的所有使用者。

| 欄 1 |
| - |
| \*\*xbuser list \*\* |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser signin

使用指定的 ID 或電子郵件地址讓使用者登入。如果使用者尚未存在於主機上，則會將使用者新增至主機。

| 欄 1 | |
| - | - |
| **xbuser signin** \[/i:\<userId> | /e:\<email address>] \[/p:password] |

| 選項 | 描述 | |
| - | - | - |
| /i:\<userId> | /e:\<email address> | 要登入之使用者的 ID 或電子郵件地址。 |
| /p:password | 使用者的密碼。密碼只用於驗證，不會儲存在主機上。如果主機上已存在先前使用此工具或 Sign-In 應用程式登入所取得的有效權杖，則密碼為選擇性。在此版本中，密碼透過網路傳遞至主機時不會加密。如果您的網路環境對此情況有疑慮，請使用主機上的 Sign-In 應用程式讓使用者登入。接著您就可以使用此工具讓使用者登入，而不需要傳入密碼。對於登入與安全性喜好設定設為 "Lock it down." 的帳戶，則需要密碼。 | |
| /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼 | |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## xbuser signout

使用指定的 ID 或電子郵件地址讓使用者登出。

| 欄 1 | |
| - | - |
| **xbuser signout** \[/i:\<userId> | /e:\<email address>] |

| 選項 | 描述 | |
| - | - | - |
| /i:\<userId> | /e:\<email address> | 要登出之使用者的 ID 或電子郵件地址 |
| /LC | 指定地區設定代碼。用於覆寫預設的地區設定代碼 | |

[返回本文頂端。](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbuser.md)

## 錯誤碼

`xbuser` 工具會將 HRESULT 值回應至 `stdout`，以提供某些錯誤的詳細資料。

| 錯誤碼 | 意義 |
| - | - |
| 0x80048823 | 電子郵件地址不是有效的電子郵件地址。 |
| 0x8004882E | 主機未儲存指定使用者的密碼。您必須在登入作業中提供密碼。 |
| 0x80048821 | 指定使用者的密碼無效。 |
| 0x8015DC16 | 指定的使用者已在另一部主機上登入。 |


## Related topics

- [主機開發的命令列工具](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/commandlinetools.md)
- [命令列工具](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/index.md)
- [PlayFab Party 邀請與安全性模型](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/concepts-invitations-security-model.md)
- [管理使用者帳戶 (wduser.exe)](https://docs.xbox.com/zh-TW/tools/tools-console/console_commandlinetools/wduser.md)
- [XBOX 連線儲存空間工具 (XblConnectedStorage.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-connected-storage-tool.md)