> ## 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. # Gestion de le stockage XGameSave sur la console (xbstorage.exe) > Gestion de le stockage XGameSave sur la console (xbstorage.exe) Utilisez cet outil pour gérer le stockage XGameSave sur la console. L'outil fournit les sous-commandes et fonctions suivantes. > [!NOTE] > > Si vous devez gérer des données `XGameSave` sur PC, vous devez utiliser > l'[outil en ligne de commande xgamesaveutil.exe](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md). | Commande | Description | | - | - | | [reset](#xbstorage_reset) | Supprime toutes les données locales du PFN et du SCID spécifiés sur la console | | [import](#xbstorage_import) | Importe les données du fichier XML spécifié dans un espace de stockage XGameSave | | [export](#xbstorage_export) | Exporte les données d'un espace de stockage XGameSave vers le fichier XML spécifié | | [delete](#xbstorage_delete) | Supprime des données d'un espace de stockage XGameSave | | [generate](#xbstorage_generate) | Génère des données factices et les enregistre dans le fichier XML spécifié | | [simulate](#xbstorage_simulate) | Simule des conditions de manque d'espace de stockage | ## xbstorage reset Efface toutes les données locales de le stockage XGameSave de la console locale et rétablit celui-ci aux paramètres d'usine. Les données conservées dans le nuage ne sont pas modifiées et sont à nouveau téléchargées si nécessaire. | Colonne 1 | | - | | **xbstorage reset** \[/force] | | Option | Description | | - | - | | /force | Confirme que le stockage `XGameSave` doit être réinitialisé. Si vous exécutez **reset** sans **/force**, la commande ne réinitialise pas le stockage. | ## xbstorage import Importe les données spécifiées dans *filename* dans un espace de stockage XGameSave. Ce fichier XML contient les données. Pour un exemple, consultez [xbstorage generate](#xbstorage_generate) dans cette rubrique. Pour plus de renseignements sur le format XML du fichier, consultez [Format des fichiers d'importation et d'exportation](#xbstorage_fileformat) dans cette rubrique. Il existe deux façons de spécifier un espace de stockage `XGameSave`. * Si le fichier d'entrée comporte une section **ContextDescription** correctement renseignée, ces informations sont utilisées pour spécifier l'espace de stockage `XGameSave`. * Vous pouvez aussi spécifier partiellement ou entièrement l'espace de stockage à l'aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants du fichier d'entrée. Utilisez les exemples suivants. ``` xbstorage import mydata.xml xbstorage import mydata.xml /replace xbstorage import mydata.xml /machine /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage import mydata.xml /msa:user@example.com /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage import mydata.xml /verbose ``` Avant l'importation, le système tente de synchroniser l'espace de stockage `XGameSave` spécifié avec le nuage, à l'aide de la même logique que celle exécutée lorsqu'une application en cours d'exécution acquiert un espace de stockage `XGameSave`. Une fois l'importation terminée, la console commence à téléverser les données importées vers le nuage en arrière-plan. Le téléversement se termine avant la libération du verrou infonuagique. Ce comportement diffère de celui de l'outil PC (`xgamesaveutil`), qui écrit les données uniquement dans le stockage local et ne déclenche pas de téléversement vers le nuage. Pour plus de renseignements, consultez [Gérer les données XGameSave sur PC (xgamesaveutil.exe)](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md). Si une application ayant le même identificateur de configuration de service (SCID) principal est en cours d'exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l'espace de stockage `XGameSave` dans un état indéterminé. Si **/replace** n'est pas spécifiée, les conteneurs spécifiés dans le fichier d'entrée sont effacés avant l'écriture des objets blob spécifiés dans le fichier d'entrée. Les conteneurs de l'espace de stockage `XGameSave` qui ne sont pas spécifiés dans le fichier d'entrée ne sont pas modifiés. | Colonne 1 | | - | | \*\*xbstorage import \*\**file-name* \[/scid:*SCID*] \[/machine] \[/msa:*account*] \[/replace] \[/verbose] | | Option | Description | | - | - | | *file-name* | Fichier XML qui contient les données à importer. | | /scid:*SCID* | Le SCID. | | /machine | Espace de stockage XGameSave par machine. Cette option ne peut pas être utilisée simultanément avec l'option **/msa**. | | /msa:*account* | Compte à utiliser pour un stockage XGameSave par utilisateur. L'utilisateur doit être connecté à la console pour que l'espace puisse être utilisé. Cette option ne peut pas être utilisée simultanément avec l'option **/machine**. | | /replace | Avant l'importation, supprime tous les conteneurs de l'espace de stockage `XGameSave` spécifié. | | /verbose | Affiche l'état de l'opération d'importation. | ## xbstorage export Exporte les données d'un espace de stockage `XGameSave` vers le fichier spécifié par **outfile**. Le fichier XML contient les données exportées. Pour un exemple, consultez [xbstorage generate](#xbstorage_generate) dans cet article. Pour plus de renseignements sur le format XML, consultez [Format des fichiers d'importation et d'exportation](#xbstorage_fileformat). Il existe deux façons de spécifier l'espace de stockage `XGameSave`. * Si le paramètre **/context** est utilisé et que le fichier spécifié par \ comporte une section **ContextDescription** correctement renseignée, ce fichier est utilisé pour spécifier l'espace de stockage `XGameSave`. * Vous pouvez aussi spécifier partiellement ou entièrement l'espace de stockage à l'aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants spécifiés par **/context**. Utilisez les exemples suivants. ``` xbstorage export exporteddata.xml /context:space.xml xbstorage export exporteddata.xml /machine /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage export exporteddata.xml /msa:user@example.com /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage export exporteddata.xml /context:space.xml /verbose ``` Avant l'exportation, le système tente de synchroniser l'espace de stockage `XGameSave` spécifié avec le nuage, à l'aide de la même logique que celle exécutée lorsqu'une application en cours d'exécution acquiert un espace de stockage `XGameSave`. Si une application ayant le même SCID principal est en cours d'exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l'espace de stockage `XGameSave` dans un état indéterminé. | Colonne 1 | | - | | \*\*xbstorage export \*\**outfile* \[/context:*input-file*] \[/scid:*SCID*] \[/machine] \[/msa:*account*] \[/verbose] | | Option | Description | | - | - | | *outfile* | Fichier XML vers lequel les données sont exportées. | | /context:*input-file* | Fichier d'entrée à partir duquel les informations sur l'espace doivent être lues. | | /scid:*SCID* | Le SCID. | | /machine | Espace de stockage XGameSave par machine. Cette option ne peut pas être utilisée simultanément avec l'option **/msa**. | | /msa:*account* | Compte à utiliser pour un stockage XGameSave par utilisateur. L'utilisateur doit être connecté à la console pour que l'espace puisse être utilisé. Cette option ne peut pas être utilisée simultanément avec l'option **/machine**. | | /verbose | Affiche l'état de l'opération **export**. | ## xbstorage delete Supprime toutes les données d'un espace de stockage `XGameSave`. Il existe deux façons de spécifier l'espace de stockage `XGameSave`. * Si vous utilisez le paramètre **/context** et que le fichier spécifié par \ comporte une section **ContextDescription** correctement renseignée, ce fichier est utilisé pour spécifier l'espace de stockage `XGameSave`. * Vous pouvez aussi spécifier partiellement ou entièrement l'espace de stockage à l'aide de paramètres de ligne de commande. Ces paramètres sont prioritaires sur les éléments correspondants spécifiés par **/context**. Utilisez les exemples suivants. ``` xbstorage delete /context:space.xml xbstorage delete /machine /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage delete /msa:user@example.com /scid:2AAEB34B-DAB2-4879-B625-D970069C1D22 xbstorage delete /context:space.xml /verbose ``` Avant la suppression, le système tente de synchroniser l'espace de stockage `XGameSave` spécifié avec le nuage, à l'aide de la même logique que celle exécutée lorsqu'une application en cours d'exécution acquiert un espace de stockage `XGameSave`. Si une application ayant le même SCID principal est en cours d'exécution, cette opération peut provoquer une condition de concurrence et laisser le contenu de l'espace de stockage `XGameSave` dans un état indéterminé. | Colonne 1 | | - | | **xbstorage delete** \[/context:*input-file*] \[/scid:*SCID*] \[/machine] \[/msa:*account*] \[/verbose] | | Option | Description | | - | - | | /context:*input-file* | Fichier d'entrée à partir duquel les informations sur l'espace doivent être lues. | | /scid:*SCID* | Le SCID. | | /machine | Espace de stockage XGameSave par machine. Cette option ne peut pas être utilisée simultanément avec l'option **/msa**. | | /msa:*account* | Compte à utiliser pour un stockage XGameSave par utilisateur. L'utilisateur doit être connecté à la console pour que l'espace puisse être utilisé. Cette option ne peut pas être utilisée simultanément avec l'option **/machine**. | | /verbose | Affiche l'état de l'opération **delete**. | ## xbstorage generate Génère des données factices et les enregistre dans le fichier spécifié par \. Pour plus de renseignements sur le format XML, consultez [Format des fichiers d'importation et d'exportation](#xbstorage_fileformat). Le SCID est défini sur 00000000-0000-0000-0000-000000000000 et le compte est défini pour un espace de stockage `XGameSave` par machine. Pour modifier ces valeurs, modifiez directement le fichier après sa génération. Utilisez les exemples suivants. ``` xbstorage generate dummydata.xml xbstorage generate dummydata.xml /containers:4 xbstorage generate dummydata.xml /blobs:10 xbstorage generate dummydata.xml /containers:4 /blobs:10 xbstorage generate dummydata.xml /containers:4 /blobs:10 /blobsize:512 ``` Les données d'octets forment une simple séquence croissante. Par exemple, un objet blob de 5 octets contiendrait les octets suivants : 00 01 02 03 04. Pour spécifier un espace de stockage `XGameSave` par utilisateur, modifiez le nœud **Account** du fichier XML comme indiqué dans l'exemple suivant. ``` ``` | Colonne 1 | | - | | \*\*xbstorage generate \*\**file-name* \[/containers:*n*] \[/blobs:*n*] \[/blobsize:*n*] | | Option | Description | | - | - | | *file-name* | Fichier XML dans lequel les données sont écrites. | | /containers:*n* | Nombre de conteneurs à générer. La valeur par défaut de *n* est 2. | | /blobs:*n* | Nombre d'objets blob à générer. La valeur par défaut de *n* est 3. | | /blobsize:*n* | Nombre d'octets par objet blob. La valeur par défaut de *n* est 1024. | ## xbstorage simulate Simule des conditions de manque d'espace de stockage local pour le service de stockage `XGameSave`. | Colonne 1 | | - | | **xbstorage simulate** \[/reserveremainingspace] \[/forceoutoflocalstorage] \[/stop] \[/verbose] | | Option | Description | | - | - | | /reserveremainingspace | Réserve tout l'espace restant dans le stockage XGameSave. La suppression d'un élément de le stockage XGameSave libère de l'espace utilisable. | | /forceoutoflocalstorage | Simule un service de stockage XGameSave ne disposant plus d'aucun espace disponible. La suppression d'un élément de le stockage XGameSave n'empêche pas le service de stockage XGameSave de signaler un manque de mémoire. | | /stop | Arrête toutes les simulations. | | /verbose | Affiche l'état de l'opération **simulate**. | ## Options courantes | Colonne 1 | | - | | **xbstorage** \[/?] \[/X\*:address\* \[*+accesskey*] ] | | Option | Description | | - | - | | /? | Affiche l'aide de xbstorage.exe. | | /X\*:address\* \[*+accesskey*] | Utilisez cette option pour spécifier le nom d'hôte ou l'adresse (affichée en tant que **Tools IP** sur la console) d'une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d'un nom d'hôte pour une console, consultez [Définir un nom d'hôte pour l'adresse IP de la console](https://docs.xbox.com/fr-CA/home/setup-install/dev-kit-settings/setting-a-hostname.md).Si vous n'utilisez pas cette option, la console par défaut (définie précédemment à l'aide de [Connexion (xbconnect.exe)](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xbconnect.md)) est utilisée.Utilisez la chaîne *accesskey* pour limiter l'accès à la console aux seules personnes qui disposent de la clé d'accès. Set the access key by using the command **xbconfig** **accesskey=*your-key***, and then restart your console to make the access key effective.Pour accéder à une console configurée avec une clé d'accès, ajoutez un signe plus (+) suivi de la clé d'accès après l'adresse IP ou le nom d'hôte de la console.Si une clé d'accès est fournie lors de la définition de la console par défaut avec [xbconnect](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xbconnect.md), la clé d'accès est stockée dans l'adresse de la console par défaut.Pour plus d'informations sur les clés d'accès, consultez [xbconfig accesskey](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xbconfig.md). | ## Format des fichiers d'importation et d'exportation Le fichier XML utilisé avec les commandes **import**, **export** et **generate** a le format illustré dans l'exemple suivant. ```xml theme={null} </ContextDescription> <Data> <Containers> <Container name="Container1"> <Blobs> <Blob name="Blob1"> <![CDATA[... ] ]> </Blob> ... <Blob name="BlobN"> <![CDATA[... ] ]> </Blob> </Blobs> </Container> ... <Container name="ContainerN"> ... </Container> </Containers> </Data> </XbConnectedStorageSpace> ``` Le format des données de ce fichier XML n'est pas identique au format de la plateforme. Ce format peut évoluer à l'avenir; les fichiers doivent donc être considérés comme ayant un format intermédiaire ou utilitaire, et non un format d'archivage. Le nœud **ContextDescription** est facultatif. Si vous créez un espace de stockage `XGameSave` pour un utilisateur, vous pouvez utiliser `<Account msa="user@example.com"/>` au lieu de `<Account machine="true"/>`. Sinon, vous pouvez spécifier le contexte sur la ligne de commande lors de l'importation. Les objets blob et les conteneurs doivent porter les noms correspondants que leur a attribués le jeu ou l'application pour lequel le fichier est généré. Le contenu de chaque objet blob doit être une chaîne encapsulée dans une balise **CDATA**, générée en appelant **CryptBinaryToStringW** avec l'indicateur **CRYPT\_STRING\_BASE64** et en fournissant les données de cet objet blob sous forme de tableau d'octets bruts. À l'inverse, les données d'un objet blob peuvent être reconverties en appelant **CryptStringToBinary** avec la chaîne précédemment chiffrée. Pour un exemple d'utilisation de ces deux fonctions, consultez [CryptBinaryToString returns invalid bytes](https://social.msdn.microsoft.com/Forums/vstudio/9acac904-c226-4ae0-9b7f-261993b9fda2/cryptbinarytostring-returns-invalid-bytes?forum=vcgeneral). ## Voir aussi [Outils en ligne de commande](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/commandlinetools.md) [Erreurs de transport XTF](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xtf-transport-errors.md) [Connexion (xbconnect.exe)](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xbconnect.md) [Gérer les données XGameSave sur PC (xgamesaveutil.exe)](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md) ## Related topics - [Outils en ligne de commande pour le développement sur console](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/commandlinetools.md) - [Gérer les données XGameSave sur PC (xgamesaveutil.exe)](https://docs.xbox.com/fr-CA/tools/tools-pc/commandlinetools/gr-xgamesaveutil.md) - [Outils de Game Saves](https://docs.xbox.com/fr-CA/build/core-features/common/game-save/game-saves-tools.md) - [Vue d'ensemble de l'API XGameSave](https://docs.xbox.com/fr-CA/build/core-features/common/game-save/xgamesave.md) - [Game Saves (contenu)](https://docs.xbox.com/fr-CA/build/core-features/common/game-save/game-saves-toc.md)