Sources de configuration et 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
- Les paramètres
AzureAd:*configurent la connexion utilisateur ; 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 telles quegame, 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 recherche 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 sa
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 collectent une télémétrie anonyme limitée, sauf si vous la désactivez. Pour la désactiver pour une seule commande :Mise à niveau depuis une version qui lisait appsettings.json
Les versions antérieures lisaientappsettings.json à côté de l’exécutable. Si vous y aviez modifié une valeur,
définissez plutôt sa variable XBOX_ : par exemple, "AzureAd": { "ClientId": "..." } devient
XBOX_AZUREAD__CLIENTID. Vous pouvez voir ces messages tant que vous n’avez pas terminé :
-
--config-envéchoue avec cette erreur. Supprimez 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 remarque 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. Supprimez la variable.
