Saltar al contenido principal
La XBOX CLI recopila telemetría de uso anónima y limitada para ayudar a Microsoft a comprender qué comandos se usan, qué fiabilidad tienen y cuánto tardan. Puedes desactivarla. La telemetría nunca cambia la salida ni el código de salida de un comando. Microsoft trata estos datos tal como se describe en la declaración de privacidad de Microsoft. El aviso de privacidad del repositorio abarca la recopilación de datos que realiza el software.

Qué se recopila

Cada ejecución de xbox crea como máximo un evento, xbox.cli.command_invocation, con estos campos y nada más: Un nombre de comando u opción que la CLI no define se envía como unknown o se omite, por lo que nunca se envía un valor escrito en el lugar equivocado.

Ubicación aproximada

La CLI nunca envía tu ubicación. Sin embargo, Application Insights deriva una ubicación aproximada (país, región o estado, y ciudad) de la dirección IP que envía el evento, y la almacena en cada evento. La dirección IP en sí no se conserva; se almacena como 0.0.0.0. La ubicación solo se usa para comprender la adopción en los distintos mercados. Desactivar la telemetría detiene toda la telemetría, incluida esta ubicación.

Qué no se recopila

La CLI no recopila valores de argumentos ni de opciones, cuerpos de solicitudes ni de respuestas, id. de título de PlayFab, id. de vendedor, id. de sandbox, nombres de usuario, id. de inquilino ni de cuenta, tokens de acceso, rutas de archivo, secretos configurados, mensajes de error ni el nombre de la máquina.

Cuándo se envía el evento

Cuando un comando se ejecuta correctamente, la CLI guarda el evento en el disco y una ejecución posterior lo envía, por lo que el comando no espera a la red. Cuando un comando falla, la CLI espera como máximo 300 milisegundos para enviar su evento y los que haya guardados. En CI, donde es posible que la CLI no vuelva a ejecutarse, envía el evento antes de salir en lugar de guardarlo. Esto puede agregar hasta unos 5 segundos cuando el punto de conexión es lento, y el evento se descarta si no se envía en ese tiempo.

Encabezado de versión

Independientemente de la telemetría, cada solicitud que la CLI envía con un token de acceso lleva un encabezado User-Agent: XboxDevCLI/<version>, como XboxDevCLI/0.1.0.9, para que esos servicios puedan saber qué versiones de la CLI los llaman. No contiene nada más, y desactivar la telemetría no lo quita.

Aviso en la primera ejecución

La primera vez que la CLI recopila telemetría en una máquina, escribe este aviso en stderr, una sola vez:

Desactivar la telemetría

Para un comando

Pasa --disable-telemetry:

Para la sesión de shell actual

Establece XBOX_TELEMETRY_OPTOUT en PowerShell:
En bash o zsh:
Los valores 1, true y yes desactivan la telemetría, independientemente de cualquier otra configuración. Establecer XBOX_TELEMETRY__ENABLED en false también la desactiva.

Para cada terminal nuevo

Establece la variable para tu cuenta. En Windows, ejecuta lo siguiente y, después, vuelve a abrir el terminal, y tu IDE si usas su terminal integrado:
En Linux y macOS, agrega la línea export al archivo de inicio de tu shell, como ~/.zshrc o ~/.bashrc, del mismo modo que Instalación agrega la CLI a PATH.

Adónde va la telemetría

Las compilaciones de versión envían la telemetría a un recurso de Application Insights de Azure Monitor propiedad de Microsoft, que no puedes cambiar. La CLI omite APPLICATIONINSIGHTS_CONNECTION_STRING, por lo que un host que la establece para su propia aplicación no redirige la telemetría de la CLI.
Última modificación el 19 de noviembre de 2026