> ## 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.

# Configuración

> Cómo superpone la CLI la configuración a partir de sus valores predeterminados integrados, las variables de entorno y las opciones de la línea de comandos.

La XBOX CLI no necesita ningún archivo de configuración. Su configuración procede de valores predeterminados integrados
en el ejecutable, que puedes invalidar para un shell con variables de entorno o para
un solo comando con opciones.

## Orígenes de configuración y prioridad

La configuración procede de tres orígenes, y los posteriores invalidan a los anteriores:

1. Valores predeterminados integrados, compilados en el ejecutable. Consulta [Opciones de configuración](#settings).
2. Variables de entorno. Consulta [Variables de entorno](#environment-variables).
3. Opciones de la línea de comandos. Consulta [Invalidaciones con opciones de la CLI](#cli-option-overrides).

Cada nueva versión trae sus propios valores predeterminados, así que no hay ningún archivo de configuración que trasladar.

El vendedor, el título de PlayFab, el título de XBOX y el sandbox no son opciones de configuración; consulta
[Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md) para saber de dónde los obtiene un comando.

## Opciones de configuración

| Clave | Variable de entorno | Opción | Valor predeterminado integrado |
| - | - | - | - |
| `AzureAd:ClientId` | `XBOX_AZUREAD__CLIENTID` | `--client-id` | La aplicación de Microsoft Entra ID propia de la CLI |
| `AzureAd:TenantId` | `XBOX_AZUREAD__TENANTID` | `--tenant-id` | `common` |
| `AzureAd:Scopes` | `XBOX_AZUREAD__SCOPES` | `--scopes` | Integrado |
| `PlayFab:BaseUrlTemplate` | `XBOX_PLAYFAB__BASEURLTEMPLATE` | Ninguna | Integrado |
| `PlayFab:StudioBaseUrl` | `XBOX_PLAYFAB__STUDIOBASEURL` | Ninguna | Integrado |
| `PlayFab:MaxRequestBodyBytes` | `XBOX_PLAYFAB__MAXREQUESTBODYBYTES` | Ninguna | `1048576` (1 MiB) |
| `PlayFab:MaxResponseBytes` | `XBOX_PLAYFAB__MAXRESPONSEBYTES` | Ninguna | `4194304` (4 MiB) |
| `XboxPartner:BaseUrl` | `XBOX_XBOXPARTNER__BASEURL` | `--base-url`, en los comandos que la aceptan | Integrado |
| `XboxPartner:TimeoutSeconds` | `XBOX_XBOXPARTNER__TIMEOUTSECONDS` | Ninguna | `120` |
| `XblPCSandbox:Path` | `XBOX_XBLPCSANDBOX__PATH` | Ninguna | Sin establecer |
| `AuditLog:Enabled` | `XBOX_AUDITLOG__ENABLED` | Ninguna | `false` |
| `Telemetry:Enabled` | `XBOX_TELEMETRY__ENABLED` | `--disable-telemetry` establece `false` | `true` |

* `AzureAd:*` configuran el inicio de sesión de usuario; consulta [Autenticación](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#overriding-entra-id-settings).
* `PlayFab:StudioBaseUrl` es el punto de conexión de PlayFab para las API de estudio (`/Studio/*`), como
  las que llama [`playfab service-principal`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/service-principal).
* `XboxPartner:TimeoutSeconds` es el tiempo de espera de las solicitudes, en segundos, para comandos como
  [`game`](https://docs.xbox.com/es/tools/xbox-cli/commands/game), y debe ser un número positivo.
* `XblPCSandbox:Path` es el `XblPCSandbox.exe` que ejecutan los comandos [`pc sandbox`](https://docs.xbox.com/es/tools/xbox-cli/commands/pc).
  Cuando no está establecido, la CLI busca en su propio directorio y, después, en `PATH`.
* `AuditLog:Enabled` activa el [registro de auditoría](https://docs.xbox.com/es/tools/xbox-cli/audit-log.md).
* `Telemetry:*` se describen en [Telemetría](https://docs.xbox.com/es/tools/xbox-cli/telemetry.md).

Cuando `PlayFab:BaseUrlTemplate`, `PlayFab:StudioBaseUrl` o `XboxPartner:BaseUrl` no tienen el
valor predeterminado integrado, todos los comandos que envían un token a ese punto de conexión escriben primero una advertencia en
stderr.

## Variables de entorno

La variable de una opción de configuración es `XBOX_` seguida de su clave, con `__` (dos guiones bajos) en lugar de cada `:`,
de modo que `Telemetry:Enabled` es `XBOX_TELEMETRY__ENABLED`. Escribe los nombres en mayúsculas. Una variable se aplica
al shell que la establece y a todos los comandos que ese shell inicia:

```bash theme={null}
# Linux / macOS
export XBOX_XBOXPARTNER__TIMEOUTSECONDS=300
xbox game list
```

```powershell theme={null}
# Windows PowerShell
$env:XBOX_XBOXPARTNER__TIMEOUTSECONDS = "300"
xbox game list
```

Todas las opciones de [Opciones de configuración](#settings) tienen una variable. La CLI también lee estas:

| Variable de entorno | Propósito |
| - | - |
| `XBOX_PLAYFAB_TITLE_ID`, `XBOX_SELLER_ID`, `XBOX_SANDBOX_ID`, `XBOX_TITLE_ID` | Valores de contexto; consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md) |
| `XBOX_PROFILE` | El [perfil](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md#profiles) del que proceden los valores guardados cuando no se pasa `--profile` |
| `XBOX_TELEMETRY_OPTOUT` | Desactiva la telemetría cuando se establece en `1`, `true` o `yes` |
| `XBOX_AUTHENTICATION__MODE` y otras variables `XBOX_AUTHENTICATION__` | Inicio de sesión como entidad de servicio |

La configuración de `XBOX_AUTHENTICATION__` solo se lee de variables de entorno, nunca de valores predeterminados
integrados ni de opciones. Consulta
[Autenticación para automatización (entidad de servicio)](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

## Invalidaciones con opciones de la CLI

Las opciones invalidan cualquier otro origen para un comando.

| Opción | Clave de configuración o comportamiento |
| - | - |
| `--client-id` | `AzureAd:ClientId` para el inicio de sesión de usuario; se rechaza en los modos de entidad de servicio |
| `--tenant-id` | `AzureAd:TenantId` para el inicio de sesión de usuario; se rechaza en los modos de entidad de servicio |
| `--scopes` | `AzureAd:Scopes` |
| `--base-url` | `XboxPartner:BaseUrl`, en los comandos que la aceptan, como [`game`](https://docs.xbox.com/es/tools/xbox-cli/commands/game) y [`seller`](https://docs.xbox.com/es/tools/xbox-cli/commands/seller) |
| `--disable-telemetry` | Establece `Telemetry:Enabled=false` para este comando |

Consulta [Comandos](https://docs.xbox.com/es/tools/xbox-cli/commands.md) para ver las demás opciones globales.

## Configuración de la telemetría

Las versiones oficiales recopilan telemetría anónima limitada a menos que la desactives. Para desactivarla
en un comando:

```bash theme={null}
xbox --disable-telemetry auth status
```

Para desactivarla en un shell:

```bash theme={null}
export XBOX_TELEMETRY_OPTOUT=1
```

```powershell theme={null}
$env:XBOX_TELEMETRY_OPTOUT = "1"
```

Consulta [Telemetría](https://docs.xbox.com/es/tools/xbox-cli/telemetry.md) para saber qué se recopila.

## Actualizar desde una versión que leía appsettings.json

Las versiones anteriores leían `appsettings.json` junto al ejecutable. Si cambiaste un valor en
ese archivo, establece en su lugar su variable `XBOX_`: por ejemplo, `"AzureAd": { "ClientId": "..." }` pasa a ser
`XBOX_AZUREAD__CLIENTID`. Es posible que veas estos mensajes hasta que termines:

* `--config-env` produce este error. Quita la opción y establece variables `XBOX_` en su lugar.

  ```text theme={null}
  --config-env is no longer supported because settings files are no longer read. Set XBOX_ environment variables instead, such as XBOX_AZUREAD__CLIENTID.
  ```

* Mientras haya un archivo `appsettings*.json` junto al ejecutable, los comandos escriben esta nota en
  stderr. Elimina el archivo.

  ```text theme={null}
  Note: '<file>' is no longer read. Settings come from the built-in defaults, XBOX_ environment variables, and command options. Delete the file to hide this note.
  ```

* Los comandos de PlayFab producen un error que menciona `XBOX_PLAYFAB__REQUESTHEADERS__0__VALUE` si un
  mensaje de error anterior te llevó a establecerla. Quita la variable.


## Related topics

- [Configuración](https://docs.xbox.com/es/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/access-policies/config/index.md)
- [Configuración HTTP](https://docs.xbox.com/es/services/playfab/sdks/c/http-config.md)
- [Configuración del portal](https://docs.xbox.com/es/services/xbox-services/fundamentals/portal-config/index.md)
- [Configuración del juego](https://docs.xbox.com/es/publishing/game-publishing/concepts/game-setup-overview.md)
- [Configuración de sandboxes](https://docs.xbox.com/es/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes.md)
