> ## 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. # Player Data Reset ツール (XblPlayerDataReset.exe) > コマンドライン ツール XblPlayerDataReset.exe。XBOX サービス サンドボックス内のプレイヤーまたはグループの実績、リーダーボード、統計、タイトル履歴をリセットします。 2026 年 8 月に、正しいパートナー センター権限が付与されているアカウントであっても、XUID によるプレイヤー データのリセット時に権限エラー (HTTP 401) が発生する問題を修正しました。この修正は XBOX サービスのバック エンドで行われたため、自動的に適用されます。GDK、XBOX サービス ツール パッケージ、またはツール自体の新しいバージョンをインストールする必要はありません。以前にこのエラーが発生して回避策を講じた場合や、パートナー センターの権限が正しく構成されていないと案内された場合は、以下の手順に従ってツールを再試行できます。「[XUID でリセットする](#reset-by-xuid)」で説明している "Tools Access" 権限は引き続き必要です。 Player Data Reset ツールを使用すると、テスト サンドボックス内のプレイヤーまたはプレイヤー グループのデータをリセットできます。実績、リーダーボード、統計、タイトル履歴などのデータをリセットできます。個々のアカウントは、電子メール アドレスまたは XUID でリセットできます。XUID でリセットするには、まず XblDevAccount.exe ツールを実行して、リセット対象のアカウントを所有するパートナー センター アカウントにサインインする必要があります。テスト アカウントの電子メール アドレスでリセットするには、そのテスト アカウントのパスワードを知っている必要があります。 このツールでは、プレイヤーの Connected Storage (ゲーム セーブ) はリセットされません。Connected Storage を管理するには、「[Connected Storage ツール (XblConnectedStorage.exe)](/tools/tools-services/live-connected-storage-tool)」を参照してください。 このコマンド ライン ツールは、GDK の一部として、また別途 XBOX サービス ツール パッケージにも含まれています。XblPlayerDataReset.exe ツールの取得方法については、「[XBOX サービス用開発ツール](/tools/tools-services/live-tools)」を参照してください。 `--xuid`、`--user`、`--file` の各オプションは同時に指定できません。`--scid` および `--sandbox` と共に、いずれか 1 つだけを指定してください。 ## XUID でリセットする Player Data Reset ツールを使用してユーザーを XUID でリセットするには、(XblDevAccount.exe で) サインインに使用する開発者アカウントに、対象製品に対する適切な権限が必要です。「Tools Access」はアカウント レベルの権限ではなく、製品レベルの権限であることに注意してください。したがって、プレイヤー データをリセットしたい各製品に対して個別に「Tools Access」権限を付与する必要があります。 1. 管理者権限を持つ開発者アカウントでパートナー センターにサインインします。 2. アカウント設定 => [Users ページ](https://partner.microsoft.com/dashboard/account/usermanagement)に移動します。 3. 「Tools Access」権限が必要なユーザーまたはグループをクリックします。 4. ユーザーまたはグループが現在標準ロール (Developer など) に割り当てられている場合は、「Customize permissions」に切り替える必要があります。 5. 次のページで、「Product-level」の権限テーブルに移動し、「XBOX Live」テーブル ヘッダーを展開して、「Tools access」列を見つけます。 6. 「Tools Access」権限を付与したい製品または製品グループについて、そのボックスを明示的にオンにします。 権限を設定したら、次のようにテスト アカウント データをリセットできます。 ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --xuid ``` ## 電子メール アドレスでリセットする テスト アカウントの電子メール アドレスでリセットするには、各テスト アカウントのパスワードを知っている必要があります。以下のコマンドを使用すると、テスト ユーザーとしてサインインするウィンドウが表示されます。 ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --user ``` ## ファイルでリセットする ファイルでリセットするには、区切り文字付きの XUID のファイル、区切り文字付きの電子メールのファイル、または[パートナー センター アカウントのエクスポート](/services/xbox-services/develop/test-accounts/live-exporting-test-accounts)のファイルの場所を渡すことができます。 ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --file ``` 区切り文字付きファイルの場合、ツールは先頭行を調べてファイルの読み取り方法を決定します。先頭行に `@` 文字が含まれている場合、ファイル全体が電子メール アドレスの一覧として扱われます。含まれていない場合は、XUID の一覧として扱われます。ヘッダー行はアカウントとして解析されるため、区切り文字付きファイルにはヘッダー行を含めないでください。 パートナー センター アカウントのエクスポートは自動的に検出されますが、元のヘッダー行がそのまま変更されずに存在する場合に限られます。 ```text theme={null} Xuid,Email,Gamertag,IsDeleted,AccountId,Etag,Subscriptions,Keywords ``` エクスポートをスプレッドシート アプリケーションで開き、列の順序や名前を変更して保存すると、ヘッダーが認識されなくなり、ファイルは通常の区切り文字付きファイルとして読み取られます。 パートナー センター アカウントのエクスポートからリセットする前に、XblDevAccount.exe でサインインしてください。パートナー センター アカウントがサインインしている場合、ツールは `Xuid` 列を読み取り、追加のプロンプトなしでアカウントをリセットします。サインインしているアカウントがない場合は、`Email` 列にフォールバックし、ファイル内のすべてのアカウントのパスワードの入力を求められます。 ## 区切り文字オプション `--xuid` オプションと `--user` オプション、および `--file` に渡す区切り文字付きファイルに対して、カスタム区切り文字をオプションで設定できます。既定の区切り文字はカンマ (,) です。 ```cmd theme={null} XblPlayerDataReset.exe --scid --sandbox --xuid --delimiter * XblPlayerDataReset.exe --scid --sandbox --user --delimiter $ XblPlayerDataReset.exe --scid --sandbox --file --delimiter % ``` 値の最初の 1 文字だけが使用されます。1 文字より長い値を渡した場合、残りの文字は複数文字の区切り文字として扱われるのではなく、無視されます。 `--file` に渡すファイルがパートナー センター アカウントのエクスポートである場合、その形式は常にカンマ区切りであるため、区切り文字は無視されます。 ## アカウントの処理方法 アカウントの処理方法は、使用するオプションによって異なります。 XUID でリセットする場合、または XUID として解決されるファイルからリセットする場合、アカウントは最大 10 件ずつのバッチで処理されます。バッチ内のアカウントは並列にリセットされ、バッチは順番に実行されます。 電子メール アドレスでリセットする場合、各アカウントに個別にサインインする必要があるため、アカウントは 1 件ずつ処理されます。いずれかのテスト アカウントのサインインに失敗すると、ツールは直ちに停止し、一覧内の残りのアカウントは処理されません。 各アカウントは、失敗として報告される前に最大 5 回まで自動的に再試行され、ツールは各リセットがサービス側で完了するのを待ってから次に進みます。そのため、1 つのアカウントの最終結果が報告されるまでに最大で約 1 分かかることがあります。特に大きな一覧をリセットする場合は、途中でキャンセルせずにツールが完了するまで待ってください。 ## 出力 コマンドが成功または失敗した場合、以下に示すような出力が表示されます。 ***成功*** ```cmd theme={null} Resetting player data for SCID in sandbox Using Dev account contoso@contoso.com from WindowsDevCenter Processing batch of 2 account(s). Resetting player 2814000000000001 result: Succeeded Resetting player 2814000000000002 result: Succeeded Player data has been reset successfully. ``` ***エラー*** ```cmd theme={null} Resetting player data for SCID in sandbox Using Dev account contoso@contoso.com from WindowsDevCenter Processing batch of 1 account(s). Resetting player 2814000000000001 result: CompletedError. Will retry. Retrying 1 accounts. 4 more attempt(s). Failed to reset 1 account(s): 2814000000000001 An error occurred while resetting player data: ``` リセットはタイムアウトすることもあります。タイムアウトは、ツールが結果の待機を停止したことを意味するのであって、リセットが確実に失敗したことを意味するわけではありません。ジョブはサービス側で完了する可能性があります。 ```cmd theme={null} Player data reset has timed out: ``` ## 終了コード このツールは、成功した場合は 0 を、失敗した場合は -1 を返します。スクリプトや自動テスト パスからツールを呼び出す場合は、コンソールのテキストに依存するのではなく、終了コードを確認してください。 このツールは、何もリセットされない次の 2 つのケースでも 0 を返します。`--xuid`、`--user`、`--file` のいずれも指定されていない場合と、`--file` に渡したファイルを読み取れない場合です。自動化で終了コードのみを確認している場合、これらのケースは正常な実行のように見えることがあります。リセット対象として想定していたすべてのアカウントについて、出力に結果の行が含まれていることを確認してください。 ## トラブルシューティング ### Unable to authorize the account with XBOX Live ```cmd theme={null} Unable to authorize the account with XBOX Live and scid : and sandbox : , please contact your administrator. ``` このメッセージは HTTP 401 エラーに伴って表示されます。2026 年 8 月より前は、サービス側の問題により、パートナー センターの権限が正しく構成されている開発者を含め、XUID でリセットするすべての開発者にこのエラーが発生していました。この問題は修正済みであり、修正にツールや GDK の更新は必要ありませんでした。 それでもこのエラーが表示される場合は、「[XUID でリセットする](#reset-by-xuid)」で説明しているとおり、サインインしているアカウントに対象製品の「Tools Access」権限があること、および SCID とサンドボックスが対象の製品と一致していることを確認してください。最近パートナー センターで権限を変更した場合は、新しいトークンが発行されるように、XblDevAccount.exe でいったんサインアウトしてからサインインし直してください。 ### Your account doesn't have access to perform the operation ```cmd theme={null} Your account doesn't have access to perform the operation, please contact your administrator. ``` このメッセージは HTTP 403 エラーに伴って表示されます。「[XUID でリセットする](#reset-by-xuid)」で説明しているとおり、対象製品に「Tools Access」権限を付与してください。 ### Resetting by XUID requires a signed in Partner Center account ```cmd theme={null} Resetting by XUID requires a signed in Partner Center account. Please use "XblDevAccount.exe signin" to log in. ``` XUID でリセットする前、またはパートナー センター アカウントのエクスポートからリセットする前に、`XblDevAccount.exe signin` を実行してください。 ### Failed to log in to test account ```cmd theme={null} Failed to log in to test account . ``` ツールがテスト アカウントにサインインできませんでした。電子メール アドレスとパスワードを確認し、そのアカウントが `--sandbox` に渡したサンドボックスに属していることを確認してください。この状況が発生するとツールは停止するため、一覧内の残りのアカウントはリセットされません。 ## Related topics - [XBOX サービス向け開発ツール](/ja-jp/tools/tools-services/live-tools.md) - [XBOX サービス向けツール](/ja-jp/tools/tools-services/live-tools-nav.md) - [Stats と Achievements](/ja-jp/build/steam-porting-guide/features/stats-and-achievements.md) - [XBOX サービス開発者アカウント ツール (XblDevAccount.exe)](/ja-jp/tools/tools-services/live-dev-account-tool.md) - [title_initiated_player_password_reset](/ja-jp/services/playfab/api-references/events/PlayerIdentity/title-initiated-player-password-reset.md)