Saltar al contenido principal
La XBOX CLI actúa con tus permisos, a menudo sobre títulos y vendedores de producción. En esta página se explica qué comandos solo leen, cuáles preguntan antes de cambiar algo, los pocos que hacen algo que su nombre no indica y qué hacer cuando el resultado de un cambio es desconocido. Para saber qué debe preguntar un agente de IA antes de un cambio, consulta Uso de la XBOX CLI desde agentes. Un comando toma su título, vendedor o sandbox de una marca, de una variable de entorno XBOX_ o de un valor guardado con xbox context set. Un comando que cambia algo indica en stderr cada valor que no pasaste en su línea de comandos, así que compruébalo antes de un cambio en producción. Consulta Contexto.

Qué es de solo lectura

Una operación de PlayFab solo es de solo lectura si su nombre empieza por Get, List o Search, como /Admin/GetTitleData o /MultiplayerServer/ListBuildSummariesV2. Cualquier otra operación cambia algo. Esto es especialmente importante con xbox playfab api <api-path>, donde escribes la ruta de la operación, no el nombre de un comando. La Ayuda de un comando tiene una sección SAFETY que indica si lee o cambia algo.

Qué pregunta primero

La mayoría de los comandos que cambian algo se ejecutan sin preguntar. Estos preguntan primero en un terminal y, sin terminal, se niegan a ejecutarse a menos que pases --confirm (--yes, -y):

Lo que el nombre de un comando no indica

  • Si playfab service-principal set falla, es posible que la entidad de servicio no tenga acceso en el estudio hasta que un set se ejecute correctamente, lo que puede detener una canalización que inicie sesión como ella. Pasa --expected-version para que set falle en lugar de sobrescribir el cambio de otra persona.
  • playfab privacy export envía por correo electrónico los datos del jugador, de todos los títulos del editor a los que ha jugado, a la dirección de correo electrónico de notificación del título. La exportación y su correo electrónico no se pueden recuperar.
  • xbl config publish desde otro sandbox reemplaza los archivos de almacenamiento global del título del destino por los del origen y elimina los archivos que solo tiene el destino. Los archivos eliminados no se pueden recuperar.
  • xbl config publish --sandbox-id HIDDEN publica la configuración de todo el título, que usan todos los sandboxes, incluido RETAIL.

Una escritura interrumpida indica que su resultado es desconocido

Si un cambio se interrumpe después de que la CLI lo envíe, por ejemplo, con Ctrl+C, por un tiempo de espera agotado o por una conexión perdida, o si el servicio responde con un error HTTP 5xx, es posible que el cambio se haya aplicado. El comando indica que su resultado es desconocido, como en este error de PlayFab:
Lee el estado afectado antes de volver a ejecutar el cambio. Los comandos que no son de playfab muestran un comando de solo lectura con el que comprobarlo. La CLI nunca reintenta un cambio por sí misma. Algunos comandos que esperan a que termine un trabajo salen con 4 cuando la solicitud se aceptó pero la espera terminó. No vuelvas a ejecutarlos; consulta la página del comando para saber cómo seguir esperando.
Última modificación el 19 de noviembre de 2026