跳轉到主要內容
使用此工具管理主機上的 XGameSave 儲存空間。此工具提供下列子命令與功能。
如果您需要在 PC 上管理 XGameSave 資料,則必須使用 xgamesaveutil.exe 命令列工具。

xbstorage reset

清除本機主機上 XGameSave 儲存空間中的所有本機資料,將其還原為出廠設定。保存在雲端的資料不會被修改,並會在必要時重新下載。

xbstorage import

將 filename 中指定的資料匯入至 XGameSave 儲存空間。此 XML 檔案包含該資料。如需範例,請參閱本主題中的 xbstorage generate。如需檔案 XML 格式的詳細資訊,請參閱本主題中的匯入與匯出檔案格式。 有兩種方式可以指定 XGameSave 儲存空間。
  • 如果輸入檔案具有正確填入的 ContextDescription 區段,則會使用該資訊指定 XGameSave 儲存空間。
  • 您也可以使用命令列參數部分或完整指定儲存空間。這些參數的優先順序高於輸入檔案中的對應元素。
請參考下列範例。
匯入之前,系統會嘗試使用執行中應用程式取得 XGameSave 儲存空間時所執行的相同邏輯,將指定的 XGameSave 儲存空間與雲端同步。 匯入完成後,主機會開始在背景將匯入的資料上傳至雲端。上傳會在雲端鎖定釋放之前完成。此行為與 PC 工具 (xgamesaveutil) 不同,後者只會將資料寫入本機儲存空間,不會觸發上傳至雲端。如需詳細資訊,請參閱在 PC 上管理 XGameSave 資料 (xgamesaveutil.exe)。 如果具有相同主要服務設定識別碼 (SCID) 的應用程式正在執行,此作業可能會造成競爭情況,並使 XGameSave 儲存空間的內容處於不確定的狀態。 如果未指定 /replace,則會在寫入輸入檔案中指定的 Blob 之前,先清除輸入檔案中指定的容器。XGameSave 儲存空間中未在輸入檔案中指定的容器不會受到影響。

xbstorage export

將 XGameSave 儲存空間中的資料匯出至 outfile 指定的檔案。此 XML 檔案包含匯出的資料。如需範例,請參閱本文中的 xbstorage generate。如需 XML 格式的詳細資訊,請參閱匯入與匯出檔案格式。 有兩種方式可以指定 XGameSave 儲存空間。
  • 如果使用了 /context 參數,且 <infile> 所指定的檔案具有正確填入的 ContextDescription 區段,則會使用該檔案指定 XGameSave 儲存空間。
  • 您也可以使用命令列參數部分或完整指定儲存空間。這些參數的優先順序高於 /context 所指定的對應元素。
請參考下列範例。
匯出之前,系統會嘗試使用執行中應用程式取得 XGameSave 儲存空間時所執行的相同邏輯,將指定的 XGameSave 儲存空間與雲端同步。 如果具有相同主要 SCID 的應用程式正在執行,此作業可能會造成競爭情況,並使 XGameSave 儲存空間的內容處於不確定的狀態。

xbstorage delete

從 XGameSave 儲存空間刪除所有資料。有兩種方式可以指定 XGameSave 儲存空間。
  • 如果您使用 /context 參數,且 <input-file> 所指定的檔案具有正確填入的 ContextDescription 區段,則會使用該檔案指定 XGameSave 儲存空間。
  • 您也可以使用命令列參數部分或完整指定儲存空間。這些參數的優先順序高於 /context 所指定的對應元素。
請參考下列範例。
刪除之前,系統會嘗試使用執行中應用程式取得 XGameSave 儲存空間時所執行的相同邏輯,將指定的 XGameSave 儲存空間與雲端同步。 如果具有相同主要 SCID 的應用程式正在執行,此作業可能會造成競爭情況,並使 XGameSave 儲存空間的內容處於不確定的狀態。

xbstorage generate

產生虛擬資料並將其儲存至 <file-name> 指定的檔案。如需 XML 格式的詳細資訊,請參閱匯入與匯出檔案格式。 SCID 會設定為 00000000-0000-0000-0000-000000000000,且帳戶會設定為每部電腦的 XGameSave 儲存空間。若要變更這些值,請在產生後直接編輯檔案。 請參考下列範例。
位元組資料是簡單的遞增序列。例如,5 位元組的 Blob 會有下列位元組:00 01 02 03 04。 若要指定每位使用者的 XGameSave 儲存空間,請依下列範例所示變更 XML 檔案中的 Account 節點。

xbstorage simulate

為 XGameSave 儲存服務模擬本機儲存空間不足的情況。

通用選項

匯入與匯出檔案格式

與 import、export 及 generate 命令一起使用的 XML 檔案,其格式如下列範例所示。
此 XML 檔案中的資料格式與平台上的格式並不相同。格式未來可能會變更,因此應將這些檔案視為中繼或公用程式格式,而非封存格式。 ContextDescription 節點是選擇性的。如果您要為使用者建立 XGameSave 儲存空間,可以使用 <Account msa="user@example.com"/> 取代 <Account machine="true"/>。否則,您可以在匯入時於命令列上指定內容。 Blob 與容器應使用產生檔案所針對之遊戲或應用程式為其指定的對應名稱。 每個 Blob 的內容應為以 CDATA 標記包裝的字串,此字串是透過以 CRYPT_STRING_BASE64 旗標呼叫 CryptBinaryToStringW,並將該 Blob 的資料以原始位元組陣列提供而產生的。相反地,可以呼叫 CryptStringToBinary 並提供先前加密的字串,將 Blob 資料轉換回來。如需使用這兩個函式的範例,請參閱 CryptBinaryToString returns invalid bytes。

另請參閱

命令列工具 XTF 傳輸錯誤 連線 (xbconnect.exe) 在 PC 上管理 XGameSave 資料 (xgamesaveutil.exe)
最後修改於 2026年10月8日