> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect (xbconnect.exe)

> Connect (xbconnect.exe)

Usa esta herramienta para establecer o consultar la dirección de la consola predeterminada que usan las herramientas remotas del Microsoft Game Development Kit (GDK).

| Column 1                                                                                                                                                                                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xbconnect** \[/B] \[/S] \[/T] \[/N] \[/D] \[/Q] \[/QG] \[/WS\[:sec] ] \[/WTP\[:sec] ] \[/WT\[:sec] ] \[/WTO\[:sec] ] \[/discover \[search string] ] \[/data] \[/?] \[*address\[+\<accesskey>] \[name]*] |

| Opción                            | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /B                                | Muestra solo el nombre o la dirección de la consola y usa un formato sin adornos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| /S                                | Muestra solo el nombre o la dirección del sistema y usa un formato sin adornos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| /T                                | Muestra solo el nombre o la dirección de la herramienta y usa un formato sin adornos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| /N                                | No intenta conectarse a la dirección de destino.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| /D                                | Muestra las extensiones registradas y la información de compilación del proceso.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| /DX                               | Ejecuta pruebas de diagnóstico para evaluar el estado de la conexión entre el equipo y el kit de desarrollo de XBOX. Para obtener más información, consulta la sección Detalles sobre las pruebas de diagnóstico de Connect más adelante en este tema.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| /Q                                | Solo realiza la consulta y no registra una dirección predeterminada, incluso si se proporciona una dirección. Normalmente se usa con **/D** para realizar consultas directas sin afectar a la configuración de la consola predeterminada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| /QG                               | Consulta si el Title OS (Game OS) está en ejecución. Solo realiza la consulta y no registra una dirección predeterminada, incluso si se proporciona una dirección.<br />**/QG** lo usan normalmente los scripts para determinar el estado del Title OS con el fin de elegir el método correcto para acceder a los archivos del título. En los scripts, ERRORLEVEL se establece en 0 si el título está en ejecución. De lo contrario, se establece en 1. Consulta la sección **Comprobar el estado del Title OS en un script** para ver un ejemplo que muestra cómo comprobar el estado del Title OS en un script.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| /WS\[:sec]                        | <br />• Hace que **xbconnect** se bloquee hasta que el System OS esté listo para la interacción o se alcance el tiempo de espera.<br />• El tiempo de espera predeterminado es de 120 segundos. Existe la opción de especificar un valor personalizado, como **xbconnect /WS:200**.<br />•  Devuelve ERRORLEVEL=0 si la consola está lista o ERRORLEVEL=1 si se alcanza el tiempo de espera.<br />•  Ofrece una manera fiable de determinar cuándo una consola está lista para recibir comandos, por ejemplo, cuándo puedes llamar a **xbapp launch** después de **xbreboot**.<br />•  Para esperar indefinidamente, usa -1 o "infinite".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| /WTP\[:sec]                       | <br />• Hace que **xbconnect** se bloquee hasta que el proceso del título esté listo para la interacción. El tiempo de espera predeterminado es de 300 segundos y se puede configurar proporcionando un valor de tiempo de espera opcional aproximado en segundos (por ejemplo: /WTP:200). Usa un valor de -1 o 'infinite' para esperar indefinidamente.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| /WT\[:sec]                        | <br />• Hace que **xbconnect** se bloquee hasta que el Game OS esté listo para la interacción o se alcance el tiempo de espera.<br />• El tiempo de espera predeterminado es de 120 segundos. Existe la opción de especificar un valor personalizado, como **xbconnect /WT:200**.<br />•  Devuelve ERRORLEVEL=0 si la consola está lista o ERRORLEVEL=1 si se alcanza el tiempo de espera.<br />•  Ofrece una manera fiable de determinar cuándo el Game OS ha completado la inicialización y el juego se ha iniciado.<br />•  Para esperar indefinidamente, usa -1 o "infinite".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| /WTO\[:sec]                       | <br />• Hace que **xbconnect** se bloquee hasta que el Title OS esté listo para la interacción. El tiempo de espera predeterminado es de 300 segundos y se puede configurar proporcionando un valor de tiempo de espera opcional aproximado en segundos (por ejemplo: /WTO:200). Usa un valor de -1 o 'infinite' para esperar indefinidamente.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| /discover \[search string]        | Busca consolas XBOX en la LAN, filtradas por una subcadena opcional. La cadena de búsqueda se aplica a los nombres de host de las consolas, no a sus direcciones IP.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| /data                             | Devuelve la velocidad de conexión entre el equipo de desarrollo y la consola en MBps.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| /?                                | Muestra una lista completa de las opciones disponibles.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| *address\[+\<accesskey>] \[name]* | *address\[+\<accesskey>]* especifica el nombre de host o la dirección (**Tools IP**) de una consola de destino.<br />• Establecer la dirección cambia la consola predeterminada a menos que se especifique el modificador **/Q**.<br />• Si no se especifica ninguna dirección, **xbconnect** muestra la dirección predeterminada almacenada actualmente.<br />• Para obtener más información sobre cómo establecer un nombre de host en una consola, consulta [Establecer un nombre de host para la dirección IP de la consola](/home/setup-install/dev-kit-settings/setting-a-hostname). <br />Usa la cadena *accesskey* para proporcionar acceso a la consola solo a las personas que tengan la clave de acceso.<br />• Establece la clave de acceso mediante el comando **xbconfig accesskey=your-key** y, después, reinicia la consola para que la clave de acceso surta efecto.<br />• Para acceder a una consola configurada con una clave de acceso, incluye un signo más (+) y la clave de acceso después de la dirección IP o el nombre de host de la consola.<br />•  Si se proporciona una clave de acceso al establecer la consola predeterminada con **xbconnect**, la clave de acceso se almacena como parte de la dirección de la consola predeterminada.<br />•  Para obtener más información sobre las claves de acceso, consulta [xbconfig accesskey](/tools/tools-console/commandlinetools/xbconfig).<br />Usa *name* para especificar el nombre que se asociará a la dirección. Si no se especifica ningún nombre, **xbconnect** usa "devkit" como identificador de la consola. La *address* que las herramientas de desarrollo deben usar para conectarse a una consola aparece como **Console IP** en la consola.<br />•  Si no se especifica *address* y no se ha establecido una dirección predeterminada, **xbconnect** muestra un mensaje de error.<br />•  Si no se especifica *address* y se ha establecido una dirección predeterminada, **xbconnect** intenta conectarse a la dirección de la consola predeterminada. Esto puede usarse para comprobar que la consola predeterminada sigue siendo accesible.<br />•  Al invocar otras herramientas remotas, puedes invalidar la dirección de la consola predeterminada mediante el modificador **/X** para especificar un kit de desarrollo. |
| /LC                               | Especifica el código de configuración regional. Se usa para invalidar el código de configuración regional predeterminado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Comprobar el estado del Title OS en un script

```
@xbconnect /QG > nul
@if ERRORLEVEL=1 GOTO SYSTEM

@echo Title running
@echo using xbcp
@GOTO ENDD

@:SYSTEM
@echo Title not running
@echo using robocopy 
@GOTO ENDD

@:ENDD
@echo Done
```

La ejecución del script produce la siguiente salida.

```
C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title not running
using robocopy
Done
C:\Scratch\D\GXDK\SigninUser\temp>testqg.bat
Title running
using xbcp
Done  
```

<a id="xbconnect_diagnostics" />

## Detalles sobre las pruebas de diagnóstico de Connect

**xbconnect /dx** (diagnóstico) ejecuta diversas pruebas, tanto localmente en el equipo de desarrollo como en la consola de desarrollo, para determinar qué podría estar causando problemas de conexión. Estas pruebas se separan en cuatro grupos, con categorías de pruebas que se ejecutan en cada grupo. Los errores se muestran en rojo junto con un código de error y un texto que describe el código de error con más detalle. Además, algunas pruebas muestran datos adicionales que pueden resultar útiles para la solución de problemas.

### Pruebas locales del equipo

Las pruebas locales del equipo se ejecutan en el equipo de desarrollo y son independientes de la consola de desarrollo.
Proceso en ejecución: prueba de los procesos que deberían estar en ejecución para poder trabajar con una consola de desarrollo XBOX. Los procesos probados incluyen los siguientes:

* XbtpLinkSvc.exe
* XrfsSvc.exe
  > \[!NOTE]
  > Es posible que este proceso específico no se haya iniciado, y esto no es necesariamente un error real.

### Pruebas del equipo a la consola

Las pruebas del equipo a la consola se originan en el equipo de desarrollo e intentan conectarse a la consola de desarrollo de varias maneras.

* **XbtpLink:** prueba que el protocolo XBTP funciona entre el equipo y la consola, ya sea mediante el protocolo de control de transmisión (TCP) o mediante un dispositivo de transferencia XBOX (XTD).
* **Query IP:** solicita a la consola que devuelva sus direcciones IP conocidas.
* **Ping:** intenta hacer ping a la consola de destino en la dirección IP proporcionada mediante el protocolo de mensajes de control de Internet (ICMP) estándar.
* **Port connections:** intenta conectarse a un puerto abierto que ejecuta un servicio en la consola de desarrollo. Estos servicios y puertos incluyen los siguientes:
  * XTF (XBOX Tools Framework): puerto 4201/4211/4221
  * VS Debugger (depurador remoto de Visual Studio): puertos 4024/4022/4020/4016
  * Video Server (servidor de vídeo remoto que usa XBOX Manager): puerto 11442
  * WDP (Windows Device Portal para XBOX): puerto 11443

### Pruebas de la consola

Las pruebas de la consola se ejecutan en la consola remota y son independientes del equipo de desarrollo.

* **Debug NIC:** determina si el puerto de red de depuración de la consola se está usando además del puerto de red comercial.
* **Process running:** prueba los procesos que deberían estar en ejecución en la consola de desarrollo. Estos procesos incluyen Xtfhost.exe.

### Pruebas de la consola al equipo

Las pruebas de la consola al equipo se originan en la consola de desarrollo e intentan conectarse al equipo de desarrollo de varias maneras.

* **Ping:** intenta hacer ping al equipo de desarrollo de destino mediante las direcciones IP que proporciona el equipo.
  > \[!NOTE]
  > Se intenta con cada dirección enrutable del equipo, pero no todas las direcciones serían enrutables desde la consola de desarrollo XBOX. Los errores de direcciones específicas en esta prueba no son infrecuentes.
* **XbtpLink:** prueba que el protocolo XBTP funciona entre el equipo de desarrollo y la consola de desarrollo, ya sea mediante TCP o mediante un XTD.

### Ejemplo de salida de diagnóstico

En la siguiente captura de pantalla se muestra un ejemplo de salida de diagnóstico.

<img src="https://mintcdn.com/microsoft-4404708b/0AcfaOdKrAaDPaQZ/images/gdk/tools/xbconnect_diagnostics.webp?fit=max&auto=format&n=0AcfaOdKrAaDPaQZ&q=85&s=fb112edebb182f6653147f82914d91f7" alt="Captura de pantalla del diagnóstico de xbconnect" width="1192" height="1342" data-path="images/gdk/tools/xbconnect_diagnostics.webp" />

<a id="ID4E4AAC" />

## Consulte también

[Herramientas de línea de comandos](/tools/tools-console/commandlinetools/commandlinetools)

[Copia de archivos (xbcp.exe)](/tools/tools-console/commandlinetools/xbcp)

[Directorio (xbdir.exe)](/tools/tools-console/commandlinetools/xbdir)

[Información de diagnóstico (xbdiaginfo.exe)](/tools/tools-console/commandlinetools/xbdiaginfo)


## Related topics

- [Copia de archivos (xbcp.exe)](/es/tools/tools-console/commandlinetools/xbcp.md)
- [Propiedades de Visual Studio para el desarrollo en XBOX](/es/tools/tools-console/visualstudio/durango-property-pages.md)
- [IXtfEnumerateConsolesCallback::OnConsoleFound (método)](/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [IXtfConsoleManagerCallback::OnAddConsole (método)](/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [XtfCreateConsoleManager](/es/reference/tools/xtf/xtfconsolemanager/methods/xtfcreateconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)