원격 복구 (xbremoterecovery.exe) - XBOX Game Development Documentation

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

명령	설명
xbremoterecovery install	PC에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다.
xbremoterecovery live	클라우드에서 데이터를 다운로드하여 Live 시스템 업데이트를 설치합니다. 콘솔이 업데이트를 설치하려면 XBOX 서비스의 승인이 필요합니다.
xbremoterecovery getversion	콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 번호를 검색합니다.
xbremoterecovery getversionid	콘솔에서 현재 실행 중인 시스템 소프트웨어와 연결된 버전 ID를 검색합니다.
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 주소에 대한 호스트 이름 설정을 참조하십시오. - 이 옵션을 사용하지 않으면 기본 콘솔(Connect (xbconnect.exe)로 이전에 설정한)이 사용됩니다. - accesskey 문자열을 사용하여 액세스 키가 있는 사용자에게만 콘솔 액세스를 제공합니다. - xbconfig accesskey=your-key 명령을 사용하여 액세스 키를 설정한 다음 콘솔을 다시 시작하여 액세스 키가 적용되도록 합니다. - 액세스 키로 구성된 콘솔에 액세스하려면 콘솔의 IP 주소 또는 호스트 이름 뒤에 더하기 기호(+)와 액세스 키를 포함하십시오. - xbconnect로 기본 콘솔을 설정할 때 액세스 키가 제공되면 액세스 키는 기본 콘솔 주소의 일부로 저장됩니다. - 액세스 키에 대한 자세한 내용은 xbconfig accesskey를 참조하십시오.

이 항목의 맨 위로 돌아가기.

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에서 다운로드한 복구 .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/*`

이 항목의 맨 위로 돌아가기.

xbremoterecovery getversion

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

Column 1
xbremoterecovery getversion

이 항목의 맨 위로 돌아가기.

xbremoterecovery getversionid

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

Column 1
xbremoterecovery getversionid

이 항목의 맨 위로 돌아가기.

xbremoterecovery resetresume

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

Column 1
xbremoterecovery resetresume

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

참고 항목

명령줄 도구 XTF 전송 오류 Connect (xbconnect.exe)

​xbremoterecovery install

​xbremoterecovery live

​xbremoterecovery getversion

​xbremoterecovery getversionid

​xbremoterecovery resetresume

​참고 항목

xbremoterecovery install

xbremoterecovery live

xbremoterecovery getversion

xbremoterecovery getversionid

xbremoterecovery resetresume

참고 항목