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

# Comandos

> La referencia de comandos de la CLI, con sus opciones globales, formatos de salida y una página para cada comando.

Esta página es la referencia de comandos de la XBOX CLI. Abarca el propio `xbox`: las
opciones globales, los formatos de salida y los códigos de salida que comparten todos los comandos. Cada comando siguiente tiene su
propia página, y cada servicio de `playfab` tiene una página en `commands/playfab/`. Ejecuta
`xbox <command> --help` para ver la misma referencia en tu terminal.

La Ayuda etiqueta los comandos experimentales, cuyo contrato de CLI puede cambiar o quitarse.
Consulta [Comandos experimentales](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md).

## Comandos principales

| Comando | Descripción |
| - | - |
| [`auth`](https://docs.xbox.com/es/tools/xbox-cli/commands/auth) | Autenticarse con Microsoft Entra ID. |
| [`context`](https://docs.xbox.com/es/tools/xbox-cli/commands/context) | Guardar valores predeterminados, como el vendedor y el título de PlayFab, para comandos posteriores. |
| [`game`](https://docs.xbox.com/es/tools/xbox-cli/commands/game) | Enumerar, obtener y crear juegos de Partner Center. |
| [`seller`](https://docs.xbox.com/es/tools/xbox-cli/commands/seller) | Enumerar los vendedores de Partner Center disponibles para el desarrollador que ha iniciado sesión. |
| [`sandbox`](https://docs.xbox.com/es/tools/xbox-cli/commands/sandbox) | Enumerar, obtener y crear sandboxes de XBOX. |
| [`audience`](https://docs.xbox.com/es/tools/xbox-cli/commands/audience) | Enumerar, obtener, crear y actualizar las audiencias de un vendedor (Experimental). |
| [`package`](https://docs.xbox.com/es/tools/xbox-cli/commands/package) | Enumerar y obtener paquetes de juegos (Experimental). |
| [`playtest`](https://docs.xbox.com/es/tools/xbox-cli/commands/playtest) | Enumerar, obtener, comparar, crear, actualizar, publicar y eliminar los playtests de un juego. |
| [`pc`](https://docs.xbox.com/es/tools/xbox-cli/commands/pc) | Obtener o cambiar el sandbox de XBOX que usa este PC con Windows (Experimental). |
| [`test-account`](https://docs.xbox.com/es/tools/xbox-cli/commands/test-account) | Crear, actualizar y eliminar lotes de cuentas de prueba de XBOX, seguir sus trabajos de creación, leer lotes y consultar el lote de una cuenta y si su acceso ha expirado. |
| [`playfab`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab) | Inspeccionar y administrar servicios de PlayFab. |
| [`xbl`](https://docs.xbox.com/es/tools/xbox-cli/commands/xbl) | Administrar la configuración de los servicios XBOX (Experimental). |

## Comandos de soporte

| Comando | Descripción |
| - | - |
| [`info`](https://docs.xbox.com/es/tools/xbox-cli/commands/info) | Mostrar la versión y vínculos de introducción. |
| [`upgrade`](https://docs.xbox.com/es/tools/xbox-cli/commands/upgrade) | Buscar una versión más reciente de la CLI y mostrar instrucciones de actualización manual. |
| [`feedback`](https://docs.xbox.com/es/tools/xbox-cli/commands/feedback) | Abrir un borrador de informe de errores con información del entorno de la CLI. |
| [`help`](https://docs.xbox.com/es/tools/xbox-cli/commands/help) | Mostrar la ayuda de cualquier comando. |

## Opciones globales

Todos los comandos aceptan estas opciones. Algunas solo afectan a determinados comandos, como indica la tabla;
en los demás se aceptan y se omiten.

| Opción | Se aplica a | Descripción |
| - | - | - |
| `--playfab-title-id <id>` | Comandos `playfab` | El título de PlayFab de destino. Prevalece sobre `XBOX_PLAYFAB_TITLE_ID` y el título guardado, y no cambia ninguno de ellos. Consulta [Contexto](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md). |
| `--profile <name>` | Comandos que usan valores guardados | Usar los valores guardados en este perfil. El valor predeterminado es `XBOX_PROFILE` y, después, `default`. Consulta [Perfiles](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md#profiles). |
| `--client-id <id>` | Inicio de sesión de usuario | Invalidar `AzureAd:ClientId`. Se rechaza al iniciar sesión como entidad de servicio. |
| `--tenant-id <id>` | Inicio de sesión de usuario | Invalidar `AzureAd:TenantId`. Se rechaza al iniciar sesión como entidad de servicio. |
| `--scopes <scopes>` | Inicio de sesión | Invalidar `AzureAd:Scopes`. |
| `--output <format>`, `-o` | Comandos de datos | `json` (el valor predeterminado), `json-compact` o `table` en los comandos que lo admiten. Consulta [Formatos de salida](#output-formats). |
| `--data-only` | Comandos `playfab` | Escribir solo el campo `data` de la respuesta de PlayFab. Consulta [Sobre de respuesta](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab.md#response-envelope). |
| `--confirm`, `--yes`, `-y` | Comandos `playfab` y comandos en cuya página aparece | Omitir el mensaje de confirmación de un comando que pregunta primero. Consulta [Seguridad](https://docs.xbox.com/es/tools/xbox-cli/safety.md). |
| `--verbose` | Todos los comandos | Escribir detalles de diagnóstico en stderr, incluida la procedencia de cada [valor guardado](https://docs.xbox.com/es/tools/xbox-cli/commands/context.md#how-commands-use-saved-values) que usó un comando. |
| `--disable-telemetry` | Todos los comandos | Desactivar la telemetría anónima de uso del producto para esta ejecución. Consulta [Telemetría](https://docs.xbox.com/es/tools/xbox-cli/telemetry.md). |

Las opciones invalidan la configuración y las variables de entorno; consulta [Configuración](https://docs.xbox.com/es/tools/xbox-cli/configuration.md).

## Formatos de salida

Los comandos de datos escriben su resultado en stdout, y los errores y diagnósticos en stderr.

| Formato | Salida |
| - | - |
| `json` | JSON con formato legible. El valor predeterminado. |
| `json-compact` | JSON en una sola línea, para canalizarlo a `jq` o a un script. |
| `table` | Una tabla de texto sin formato, en los comandos cuya página indica que la aceptan. |

Los comandos de PlayFab encapsulan cada resultado en un sobre de respuesta que `--data-only` quita; consulta
[Sobre de respuesta](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab.md#response-envelope). `--data-only` no tiene efecto en
otros comandos ni con `--output table`.

Algunos comandos escriben texto para personas en lugar de JSON, y sus páginas lo indican. `auth status`
escribe texto a menos que pases `--output json` o `--output json-compact`; consulta
[Auth](https://docs.xbox.com/es/tools/xbox-cli/commands/auth.md#auth-status). Las operaciones de archivo, como `playfab file upload`, no escriben
nada en stdout e informan de lo que hicieron en stderr; consulta [Archivos](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/file.md#output).

### Salida en tabla

Las tablas están pensadas para leerse en un terminal. Sus columnas pueden cambiar en cualquier versión, por lo que los scripts
y los agentes deben usar `--output json-compact`. Un comando sin vista de tabla rechaza
`table`:

```console theme={null}
$ xbox playfab api /Admin/GetTitleData --output table
Output format 'table' is not available for this command, because it does not declare a
table view. Omit --output to get this command's default output.
```

### Progreso

Los comandos que leen muchas páginas, como `game list`, o que esperan una solicitud, como
`xbl config publish`, muestran su progreso en una línea de stderr:
`Reading games... 1646 found, 25 pages, 84s`. La línea solo aparece cuando stderr es un terminal,
y se borra antes del resultado.

## Códigos de salida

Todos los comandos comparten estos códigos de salida. Los comandos que cambian algo pueden agregar los
suyos, como `3` cuando el resultado de un cambio es desconocido, y sus páginas los enumeran.

| Código de salida | Significado |
| - | - |
| `0` | El comando se ejecutó correctamente. |
| `1` | El comando produjo un error. El error está en stderr. |
| `130` | Presionaste Ctrl+C mientras el comando estaba leyendo o esperando. |

Una llamada a PlayFab con errores escribe el JSON del error en stderr en el formato de `--output`; consulta
[Respuestas de error de PlayFab](https://docs.xbox.com/es/tools/xbox-cli/playfab-api.md#error-responses). Un comando desconocido escribe un error
y el uso en stderr; consulta [Ayuda](https://docs.xbox.com/es/tools/xbox-cli/commands/help.md).

Si presionas Ctrl+C después de que un comando haya enviado un cambio, indica en stderr si el cambio podría
haberse realizado. Sale con el código que documenta su página, o con `1` en el caso de un comando de PlayFab. Compruébalo
antes de volver a ejecutarlo; consulta
[Una escritura interrumpida indica que su resultado es desconocido](https://docs.xbox.com/es/tools/xbox-cli/safety.md#an-interrupted-write-reports-that-its-outcome-is-unknown).

## Seguridad

Muchos comandos cambian títulos, vendedores y juegos de producción, y solo las operaciones de PlayFab cuyos
nombres empiezan por `Get`, `List` o `Search` son de solo lectura. Lee
[Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md) antes de ejecutar comandos que cambien algo.


## Related topics

- [Comandos experimentales](https://docs.xbox.com/es/tools/xbox-cli/cli-command-lifecycle.md)
- [Comando serve](https://docs.xbox.com/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)
- [Comando convert](https://docs.xbox.com/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-convert-command.md)
- [Comando license](https://docs.xbox.com/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-license-command.md)
- [Comando pack](https://docs.xbox.com/es/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-pack-command.md)
