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

이 도구를 사용하여 Microsoft Game Development Kit(GDK) 원격 도구가 사용하는 기본 콘솔의 주소를 설정하거나 쿼리합니다.

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

| 옵션 | 설명 |
| - | - |
| /B | 콘솔의 이름 또는 주소만 표시하고 최소 형식을 사용합니다. |
| /S | System 이름 또는 주소만 표시하고 최소 형식을 사용합니다. |
| /T | 도구의 이름 또는 주소만 표시하고 최소 형식을 사용합니다. |
| /N | 대상 주소에 연결을 시도하지 않습니다. |
| /D | 등록된 확장 및 프로세스 빌드 정보를 표시합니다. |
| /DX | PC와 XBOX Development Kit 간의 연결 상태를 평가하기 위해 진단 테스트를 실행합니다. 자세한 내용은 이 문서의 뒤에 있는 Connect 진단 테스트에 대한 세부 정보 섹션을 참고하세요. |
| /Q | 쿼리만 수행하고, 주소가 제공된 경우에도 기본 주소를 등록하지 않습니다. 일반적으로 기본 콘솔 설정에 영향을 주지 않고 직접 쿼리하기 위해 **/D**와 함께 사용됩니다. |
| /QG | Title OS(Game OS)가 실행 중인지 쿼리합니다. 쿼리만 수행하고, 주소가 제공된 경우에도 기본 주소를 등록하지 않습니다. **/QG**는 일반적으로 스크립트가 Title OS의 상태를 결정해 타이틀 파일에 액세스하는 올바른 방법을 선택하는 데 사용됩니다. 스크립트에서는 타이틀이 실행 중인 경우 ERRORLEVEL이 0으로 설정되고, 그렇지 않으면 1로 설정됩니다. 스크립트에서 Title OS 상태를 확인하는 예는 **스크립트에서 Title OS 상태 확인** 섹션을 참고하세요. |
| /WS\[:sec] |  • System OS가 상호 작용할 준비가 되거나 시간 초과에 도달할 때까지 **xbconnect**가 차단되도록 합니다. • 기본 시간 초과는 120초입니다. **xbconnect /WS:200**과 같이 사용자 지정 값을 지정하는 옵션이 있습니다. • 콘솔이 준비되면 ERRORLEVEL=0을, 시간 초과에 도달하면 ERRORLEVEL=1을 반환합니다. • 콘솔이 명령을 받을 준비가 된 시점을 결정하는 신뢰할 수 있는 방법을 제공합니다. 예를 들어 **xbreboot** 이후 **xbapp launch**를 호출할 수 있는 때를 결정합니다. • 무제한 대기하려면 -1 또는 "infinite"를 사용합니다. |
| /WTP\[:sec] |  • Title 프로세스가 상호 작용할 준비가 될 때까지 **xbconnect**가 차단되도록 합니다. 기본 시간 초과는 300초이며, 초 단위의 대략적인 선택적 시간 초과 값을 제공하여 구성할 수 있습니다(예: /WTP:200). 무제한 대기하려면 -1 또는 'infinite' 값을 사용합니다. |
| /WT\[:sec] |  • Game OS가 상호 작용할 준비가 되거나 시간 초과에 도달할 때까지 **xbconnect**가 차단되도록 합니다. • 기본 시간 초과는 120초입니다. **xbconnect /WT:200**과 같이 사용자 지정 값을 지정하는 옵션이 있습니다. • 콘솔이 준비되면 ERRORLEVEL=0을, 시간 초과에 도달하면 ERRORLEVEL=1을 반환합니다. • Game OS가 초기화를 완료하고 게임이 시작된 시점을 결정하는 신뢰할 수 있는 방법을 제공합니다. • 무제한 대기하려면 -1 또는 "infinite"를 사용합니다. |
| /WTO\[:sec] |  • Title OS가 상호 작용할 준비가 될 때까지 **xbconnect**가 차단되도록 합니다. 기본 시간 초과는 300초이며, 초 단위의 대략적인 선택적 시간 초과 값을 제공하여 구성할 수 있습니다(예: /WTO:200). 무제한 대기하려면 -1 또는 'infinite' 값을 사용합니다. |
| /discover \[search string] | LAN에서 선택적 하위 문자열로 필터링된 XBOX 콘솔을 검색합니다. 검색 문자열은 콘솔의 IP 주소가 아닌 호스트 이름에 적용됩니다. |
| /data | 개발 PC에서 콘솔로의 연결 속도를 MBps 단위로 반환합니다. |
| /? | 사용 가능한 옵션의 전체 목록을 표시합니다. |
| *address\[+\<accesskey>] \[name]* | *address\[+\<accesskey>]* 는 대상 콘솔의 호스트 이름 또는 주소(**Tools IP**)를 지정합니다. • **/Q** 스위치를 지정하지 않는 한 주소 설정은 기본 콘솔을 변경합니다. • 주소를 지정하지 않으면 **xbconnect**가 현재 저장된 기본 주소를 표시합니다. • 콘솔에 호스트 이름을 설정하는 방법에 대한 자세한 내용은 [콘솔 IP 주소에 호스트 이름 설정](/ko/home/setup-install/dev-kit-settings/setting-a-hostname)을 참고하세요. *accesskey* 문자열을 사용해 액세스 키가 있는 사람에게만 콘솔 액세스를 제공합니다. • **xbconfig accesskey=your-key** 명령을 사용해 액세스 키를 설정한 다음 콘솔을 다시 시작하여 액세스 키를 적용합니다. • 액세스 키로 구성된 콘솔에 액세스하려면 콘솔의 IP 주소 또는 호스트 이름 뒤에 더하기 기호(+)와 액세스 키를 포함합니다. • 기본 콘솔이 **xbconnect**로 설정될 때 액세스 키가 제공되면 액세스 키는 기본 콘솔 주소의 일부로 저장됩니다. • 액세스 키에 대한 자세한 내용은 [xbconfig accesskey](/ko/tools/tools-console/commandlinetools/xbconfig)를 참고하세요. *name*을 사용해 주소와 연결할 이름을 지정합니다. 이름이 지정되지 않으면 **xbconnect**는 콘솔 식별자로 "devkit"을 사용합니다. 개발 도구가 콘솔에 연결하는 데 사용해야 하는 *address*는 콘솔에 **Console IP**로 표시됩니다. • *address*가 지정되지 않고 기본 주소가 설정되지 않은 경우 **xbconnect**는 오류 메시지를 표시합니다. • *address*가 지정되지 않고 기본 주소가 설정된 경우, **xbconnect**는 기본 콘솔의 주소에 연결을 시도합니다. 이를 통해 기본 콘솔에 여전히 액세스할 수 있는지 확인할 수 있습니다. • 다른 원격 도구를 호출할 때는 **/X** 스위치를 사용해 개발 키트를 지정하여 기본 콘솔의 주소를 재정의할 수 있습니다. |
| /LC | 로케일 코드를 지정합니다. 기본 로케일 코드를 재정의하는 데 사용됩니다. |

## 스크립트에서 Title OS 상태 확인

```
@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
```

스크립트를 실행하면 다음 출력이 생성됩니다.

```
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  
```

## Connect 진단 테스트에 대한 세부 정보

**xbconnect /dx**(진단)는 개발 PC와 개발 콘솔 모두에서 로컬로 다양한 테스트를 실행하여 연결 문제의 원인이 무엇일 수 있는지 확인합니다. 이러한 테스트는 네 개의 그룹으로 나뉘며, 각 그룹에서 여러 카테고리의 테스트가 실행됩니다. 오류는 오류 코드와 해당 오류 코드를 더 자세히 설명하는 일부 텍스트와 함께 빨간색으로 표시됩니다. 또한 일부 테스트는 문제 해결에 유용할 수 있는 추가 데이터를 표시합니다.

### 로컬 PC 테스트

로컬 PC 테스트는 개발 PC에서 실행되며 개발 콘솔과 독립적입니다.
프로세스 실행: XBOX 개발 콘솔과 작업하려면 실행되어야 하는 프로세스를 테스트합니다. 테스트되는 프로세스는 다음과 같습니다.

* XbtpLinkSvc.exe
* XrfsSvc.exe
  > [!NOTE]
  >
  > 이 특정 프로세스는 시작되지 않을 수 있으며, 이는 반드시 실제 실패는 아닙니다.

### PC에서 콘솔로의 테스트

PC에서 콘솔로의 테스트는 개발 PC에서 시작하여 다양한 방법으로 개발 콘솔에 연결을 시도합니다.

* **XbtpLink:** TCP(전송 제어 프로토콜) 또는 XTD(XBOX Transfer Device)를 통해 PC와 콘솔 간에 XBTP 프로토콜이 작동하는지 테스트합니다.
* **Query IP:** 콘솔에 알려진 IP 주소를 반환하도록 요청합니다.
* **Ping:** 표준 ICMP(인터넷 제어 메시지 프로토콜)를 사용해 제공된 IP 주소에서 대상 콘솔을 핑하려고 시도합니다.
* **포트 연결:** 개발 콘솔에서 서비스를 실행하는 열린 포트에 연결을 시도합니다. 이러한 서비스와 포트는 다음과 같습니다.
  * XTF(XBOX Tools Framework): 포트 4201/4211/4221
  * VS 디버거(Visual Studio Remote Debugger): 포트 4024/4022/4020/4016
  * 비디오 서버(XBOX Manager에서 사용되는 원격 비디오 서버): 포트 11442
  * WDP(Windows Device Portal for XBOX): 포트 11443

### 콘솔 테스트

콘솔 테스트는 원격 콘솔에서 실행되며 개발 PC와 독립적입니다.

* **Debug NIC:** 콘솔의 디버그 네트워크 포트가 리테일 네트워크 포트와 함께 사용되고 있는지 확인합니다.
* **프로세스 실행:** 개발 콘솔에서 실행되어야 하는 프로세스를 테스트합니다. 이러한 프로세스에는 Xtfhost.exe가 포함됩니다.

### 콘솔에서 PC로의 테스트

콘솔에서 PC로의 테스트는 개발 콘솔에서 시작하여 다양한 방법으로 개발 PC에 연결을 시도합니다.

* **Ping:** PC에서 제공하는 IP 주소를 사용해 대상 개발 PC를 핑하려고 시도합니다.
  > [!NOTE]
  >
  > PC의 모든 라우팅 가능한 주소가 시도되지만, 모든 주소가 XBOX 개발 콘솔에서 라우팅 가능한 것은 아닙니다. 이 테스트에서 특정 주소의 실패는 드문 일이 아닙니다.
* **XbtpLink:** TCP 또는 XTD를 통해 개발 PC와 개발 콘솔 간에 XBTP 프로토콜이 작동하는지 테스트합니다.

### 진단 출력 예

진단 출력의 예는 다음 스크린샷과 같습니다.

![xbconnect 진단 스크린샷](https://mintcdn.com/microsoft-4404708b/0AcfaOdKrAaDPaQZ/images/gdk/tools/xbconnect_diagnostics.webp?fit=max\&auto=format\&n=0AcfaOdKrAaDPaQZ\&q=85\&s=fb112edebb182f6653147f82914d91f7)

## 참고

[명령줄 도구](/ko/tools/tools-console/commandlinetools/commandlinetools)

[파일 복사 (xbcp.exe)](/ko/tools/tools-console/commandlinetools/xbcp)

[디렉터리 (xbdir.exe)](/ko/tools/tools-console/commandlinetools/xbdir)

[진단 정보 (xbdiaginfo.exe)](/ko/tools/tools-console/commandlinetools/xbdiaginfo)


## Related topics

- [파일 삭제 (xbdel.exe)](/ko/tools/tools-console/commandlinetools/xbdel.md)
- [원격 복구 (xbremoterecovery.exe)](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)
- [파일 복사 (xbcp.exe)](/ko/tools/tools-console/commandlinetools/xbcp.md)
- [XBOX 개발용 Visual Studio 속성](/ko/tools/tools-console/visualstudio/durango-property-pages.md)
- [게임 스트리밍 관리 (xbgamestream.exe)](/ko/tools/tools-console/commandlinetools/xbgamestream.md)