構成ソースと優先順位
設定は 3 つのソースから取得され、後のソースが前のソースをオーバーライドします。- 実行可能ファイルにコンパイルされた組み込みの既定値。設定を参照してください。
- 環境変数。環境変数を参照してください。
- コマンド ライン オプション。CLI オプションによるオーバーライドを参照してください。
設定
AzureAd:*は、ユーザー サインインを構成します。認証を参照してください。PlayFab:StudioBaseUrlは、playfab service-principalが 呼び出すものなど、スタジオ API (/Studio/*) 用の PlayFab エンドポイントです。XboxPartner:TimeoutSecondsは、gameなどのコマンドのリクエスト タイムアウト (秒単位) であり、正の数である必要があります。XblPCSandbox:Pathは、pc sandboxコマンドが実行するXblPCSandbox.exeです。設定されていない場合、CLI は自身のディレクトリを検索し、次にPATHを検索します。AuditLog:Enabledは、監査ログを有効にします。Telemetry:*については、テレメトリで説明しています。
PlayFab:BaseUrlTemplate、PlayFab:StudioBaseUrl、または XboxPartner:BaseUrl が組み込みの既定値と
異なる場合、そのエンドポイントにトークンを送信するすべてのコマンドは、最初に stderr に警告を
書き込みます。
環境変数
設定の変数名は、XBOX_ にキーを続け、各 : を __ (アンダースコア 2 つ) に置き換えたものです。
たとえば、Telemetry:Enabled は XBOX_TELEMETRY__ENABLED になります。名前は大文字で記述します。変数は、
それを設定したシェルと、そのシェルが開始するすべてのコマンドに適用されます。
XBOX_AUTHENTICATION__ の設定は環境変数からのみ読み取られ、組み込みの既定値やオプションからは読み取られません。
自動化 (サービス プリンシパル) の認証を参照してください。
CLI オプションによるオーバーライド
オプションは、1 つのコマンドについて、他のすべてのソースをオーバーライドします。
その他のグローバル オプションについては、コマンドを参照してください。
テレメトリの構成
公式リリースでは、無効にしない限り、限られた匿名のテレメトリが収集されます。1 つのコマンドで 無効にするには、次のようにします。appsettings.json を読み取っていたリリースからのアップグレード
以前のリリースでは、実行可能ファイルと同じ場所にあるappsettings.json を読み取っていました。このファイルの値を変更していた場合は、
代わりに対応する XBOX_ 変数を設定してください。たとえば、"AzureAd": { "ClientId": "..." } は
XBOX_AZUREAD__CLIENTID になります。移行が完了するまで、次のメッセージが表示される場合があります。
-
--config-envは次のエラーで失敗します。このオプションを削除し、代わりにXBOX_変数を設定してください。 -
実行可能ファイルと同じ場所に
appsettings*.jsonファイルがある間は、コマンドが次のメモを stderr に書き込みます。このファイルを削除してください。 -
以前のエラー メッセージに従って
XBOX_PLAYFAB__REQUESTHEADERS__0__VALUEを設定した場合、PlayFab コマンドは この変数名を示すエラーで失敗します。この変数を削除してください。
