Sources de configuration et ordre de priorité
Les paramètres proviennent de trois sources, et les sources suivantes remplacent les précédentes :- Les valeurs par défaut intégrées, compilées dans l’exécutable. Consultez Paramètres.
- Les variables d’environnement. Consultez Variables d’environnement.
- Les options de ligne de commande. Consultez Remplacements par les options de la CLI.
Paramètres
AzureAd:*configurent la connexion des utilisateurs; consultez Authentification.PlayFab:StudioBaseUrlest le point de terminaison PlayFab des API de studio (/Studio/*), comme celles qu’appelleplayfab service-principal.XboxPartner:TimeoutSecondsest le délai d’expiration des requêtes, en secondes, pour des commandes commegame, et doit être un nombre positif.XblPCSandbox:Pathest le fichierXblPCSandbox.exequ’exécutent les commandespc sandbox. Lorsqu’il n’est pas défini, la CLI le cherche dans son propre répertoire, puis dansPATH.AuditLog:Enabledactive le journal d’audit.- Les paramètres
Telemetry:*sont décrits dans Télémétrie.
PlayFab:BaseUrlTemplate, PlayFab:StudioBaseUrl ou XboxPartner:BaseUrl n’a pas la
valeur par défaut intégrée, chaque commande qui envoie un jeton à ce point de terminaison écrit d’abord un avertissement sur
stderr.
Variables d’environnement
La variable d’un paramètre est formée deXBOX_ suivi de sa clé, avec __ (deux traits de soulignement) à la place de chaque :;
ainsi, Telemetry:Enabled devient XBOX_TELEMETRY__ENABLED. Écrivez les noms en majuscules. Une variable s’applique
au shell qui la définit et à toutes les commandes que ce shell lance :
Les paramètres
XBOX_AUTHENTICATION__ sont lus uniquement à partir des variables d’environnement, jamais à partir des valeurs
par défaut intégrées ni des options. Consultez
Authentification pour l’automatisation (principal de service).
Remplacements par les options de la CLI
Les options remplacent toutes les autres sources, pour une seule commande.
Consultez Commandes pour les autres options globales.
Configuration de la télémétrie
Les versions officielles recueillent une télémétrie anonyme limitée, sauf si vous la désactivez. Pour la désactiver pour une seule commande :Mise à niveau à partir d’une version qui lisait appsettings.json
Les versions antérieures lisaientappsettings.json à côté de l’exécutable. Si vous y avez modifié une valeur,
définissez plutôt sa variable XBOX_ : par exemple, "AzureAd": { "ClientId": "..." } devient
XBOX_AZUREAD__CLIENTID. Vous pourriez voir ces messages jusqu’à ce que vous ayez terminé :
-
--config-envéchoue avec cette erreur. Retirez l’option et définissez plutôt des variablesXBOX_. -
Tant qu’un fichier
appsettings*.jsonse trouve à côté de l’exécutable, les commandes écrivent cette note sur stderr. Supprimez le fichier. -
Les commandes PlayFab échouent avec une erreur qui nomme
XBOX_PLAYFAB__REQUESTHEADERS__0__VALUEsi un message d’erreur antérieur vous a amené à la définir. Retirez la variable.
