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

# 원격 복구 (xbremoterecovery.exe)

> 원격 복구 (xbremoterecovery.exe)

이 도구를 사용하여 XBOX One 제품군 콘솔과 XBOX Series 콘솔에서 시스템 업데이트를 시작합니다. 이 도구는 로컬 PC 대상, XBOX 서비스 또는 사용자 지정 CDN에서 시스템 업데이트를 가져올 수 있게 합니다. 이 도구는 다음과 같은 하위 명령과 기능을 제공합니다.

| 명령 | 설명 |
| - | - |
| [xbremoterecovery install](#xbremoterecovery_install) | PC에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다. |
| [xbremoterecovery live](#xbremoterecovery_live) | 클라우드에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다. |
| [xbremoterecovery getversion](#xbremoterecovery_getversion) | 콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 번호를 검색합니다. |
| [xbremoterecovery getversionid](#xbremoterecovery_getversionid) | 콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 ID를 검색합니다. |
| [xbremoterecovery resetresume](#xbremoterecovery_resetresume) | 진행 중인 업데이트를 지워 다음 시도가 새 업데이트를 시작하도록 합니다. |

## xbremoterecovery install

PC에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다.

| Column 1 |
| - |
| \*\*xbremoterecovery install \*\**update\_path* \[/factoryreset\[:VALUE] ] \[/log] \[/noidletimeout] \[/xblsandbox:VALUE] \[/provision:\<path to xbProvision manifest>] \[/savehostname] \[/sethostname:NAME] \[/X\[:]*address\[+\<accesskey>]*] |

| 옵션 | 설명 |
| - | - |
| *update\_path* | 시스템 업데이트 데이터 파일이 있는 디렉터리 경로입니다. 예: system.xvd, host.xvd, updater.xvd, update.ini. |
| /factoryreset\[:VALUE] | 모든 설정 및 내부 저장소의 재설정을 강제합니다. **값 없음** - 모든 설정 및 콘텐츠를 기본 상태로 완전히 재설정합니다. **savesettings** - 공장 재설정 중 설정을 유지합니다. |
| /log | 로그 파일에 적합한 콘텐츠를 생성합니다. |
| /noidletimeout | 유휴 종료 타이머를 비활성화합니다. 이는 사용자가 비활동 때문에 콘솔이 스스로 꺼지는 것을 원하지 않는 시나리오를 테스트하는 데 유용합니다. |
| /xblsandbox:VALUE | 기본 샌드박스를 재정의합니다. 이는 모든 콘솔이 RETAIL 샌드박스에서 시작되므로 특히 콘솔을 처음 설정할 때 유용합니다. RETAIL 샌드박스는 개발 키트에 실용적이지 않기 때문입니다. 개발 키트가 처음 복구될 때 이 스위치를 사용하여 올바른 샌드박스로 이동하도록 해야 합니다. |
| /savehostname | 빌드를 다운그레이드하고 콘솔의 호스트 이름을 유지하려는 경우 이 옵션을 사용합니다. /factoryreset과 함께 이 옵션을 사용하면 호스트 이름이 유지됩니다. |
| /sethostname:NAME | /savehostname과 유사하지만 호스트 이름을 제공된 NAME으로 덮어씁니다. |
| /X\[:]*address\[+\<accesskey>]* | - 이 옵션을 사용하여 기본 콘솔을 변경하지 않고 대상 콘솔의 호스트 이름 또는 주소(콘솔에 **Tools IP**로 표시됨)를 지정합니다. 콘솔에 대한 호스트 이름 설정에 대한 자세한 내용은 [콘솔 IP 주소에 대한 호스트 이름 설정](/ko/home/setup-install/dev-kit-settings/setting-a-hostname.md)을 참조하십시오. - 이 옵션을 사용하지 않으면 기본 콘솔([Connect (xbconnect.exe)](/ko/tools/tools-console/commandlinetools/xbconnect.md)로 이전에 설정한)이 사용됩니다. - *accesskey* 문자열을 사용하여 액세스 키가 있는 사용자에게만 콘솔 액세스를 제공합니다. - **xbconfig** **accesskey=your-key** 명령을 사용하여 액세스 키를 설정한 다음 콘솔을 다시 시작하여 액세스 키가 적용되도록 합니다. - 액세스 키로 구성된 콘솔에 액세스하려면 콘솔의 IP 주소 또는 호스트 이름 뒤에 더하기 기호(+)와 액세스 키를 포함하십시오. - [xbconnect](/ko/tools/tools-console/commandlinetools/xbconnect.md)로 기본 콘솔을 설정할 때 액세스 키가 제공되면 액세스 키는 기본 콘솔 주소의 일부로 저장됩니다. - 액세스 키에 대한 자세한 내용은 [xbconfig accesskey](/ko/tools/tools-console/commandlinetools/xbconfig.md)를 참조하십시오. |

[이 항목의 맨 위로 돌아가기.](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)

## xbremoterecovery live

클라우드에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다.

| Column 1 |
| - |
| **xbremoterecovery live \[VERSIONID] \[/cdnoverride:VALUE]** |

| 옵션 | 설명 |
| - | - |
| VERSIONID | x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 형식으로 설치할 정확한 버전 ID입니다. 개발자 콘솔이 수동 업데이트로 구성된 경우 VERSIONID는 필수 매개 변수입니다. 그렇지 않으면 이 매개 변수를 생략하면 해당 시스템 업데이트 그룹에서 사용 가능한 최신 버전으로 업데이트됩니다. VERSIONID 값은 다음 방법 중 하나로 확인할 수 있습니다: 1. [https://aka.ms/gdkdl](https://aka.ms/gdkdl)에서 다운로드한 복구 .zip의 update.ini 파일을 검사합니다. 예를 들어, 이는 2021년 3월 QFE 1 복구 업데이트의 버전 ID입니다: `VersionId=10.0.19041.6737.31cedb80-46ab-407b-b277-1c67bd056f4c` 2. `getversionid` 명령줄 스위치와 함께 `xbremoterecovery.exe`를 실행합니다. |
| /cdnoverride:VALUE | XBOX 서비스에서 반환된 CDN 값을 사용자 지정 CDN 엔드포인트로 재정의합니다. 이 옵션을 사용할 때 VERSIONID 매개 변수를 제공하는 것이 권장됩니다. 모든 업데이트 파일의 전체 경로는 다음과 같아야 합니다: `\|----- CDN override value ----\|-------------- Version ID of the build -------------\| Flat directory of update files \|` `http://example.com/xboxupdates/10.0.19041.6288.afaf9289-dc86-45ab-9515-02554081a1e8/*` |

[이 항목의 맨 위로 돌아가기.](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)

## xbremoterecovery getversion

콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 번호를 검색합니다.

| Column 1 |
| - |
| \*\*xbremoterecovery getversion \*\* |

[이 항목의 맨 위로 돌아가기.](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)

## xbremoterecovery getversionid

콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 ID를 검색합니다. 이 ID는 [xbremoterecovery live](#xbremoterecovery_live) 명령을 실행할 때 VERSIONID 값으로 사용할 수 있습니다.

| Column 1 |
| - |
| \*\*xbremoterecovery getversionid \*\* |

[이 항목의 맨 위로 돌아가기.](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)

## xbremoterecovery resetresume

진행 중인 업데이트를 지워 다음 시도가 새 업데이트를 시작하도록 합니다.

| Column 1 |
| - |
| \*\*xbremoterecovery resetresume \*\* |

경우에 따라 복구가 실패하지만 업데이트가 진행 중임을 나타내는 이 플래그가 설정된 채로 남을 수 있습니다. 이 스위치는 이 플래그를 지워 후속 업데이트를 진행할 수 있도록 합니다. 선택적으로 콘솔을 다시 시작하여 이 플래그를 지울 수 있습니다.

[이 항목의 맨 위로 돌아가기.](/ko/tools/tools-console/commandlinetools/xbremoterecovery.md)

## 참고 항목

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

[XTF 전송 오류](/ko/tools/tools-console/commandlinetools/xtf-transport-errors.md)

[Connect (xbconnect.exe)](/ko/tools/tools-console/commandlinetools/xbconnect.md)


## Related topics

- [콘솔 개발용 명령줄 도구](/ko/tools/tools-console/commandlinetools/commandlinetools.md)
- [명령줄 도구](/ko/tools/tools-console/commandlinetools/index.md)
- [복구 (wdRecovery.exe)](/ko/tools/tools-console/console_commandlinetools/wdrecovery.md)
- [원격 복구 URI(API 콘텐츠)](/ko/reference/deviceportal/remote/atoc-rest-remote.md)
- [Windows Device Portal REST API 참조(API 콘텐츠)](/ko/reference/deviceportal/atoc-deviceportal-reference.md)
