Windows RE 고급 시작 메뉴에 사용자 지정 도구 추가

아티클
06/19/2023

사용자 지정 문제 해결 또는 진단 도구를 WinRE(Windows Recovery Environment) 이미지에 추가할 수 있습니다. 이 도구는 고급 시작 메뉴에 표시됩니다.

WinRE에서 실행할 사용자 지정 도구를 개발하여 WinRE에서 사용할 수 있는 터치 및 화상 키보드 지원을 활용할 수 있습니다.

Windows 10의 새로운 기능: 아직 기본 WinRE 도구에 없는 WinRE 선택적 구성 요소는 추가할 수 없습니다. 예를 들어 .NET 선택적 구성 요소를 사용하는 Windows 8의 앱이 있는 경우 Windows 10용 앱을 다시 작성해야 합니다.

사용자 지정 도구 추가

Windows 이미지(install.wim) 및 해당 WinRE 이미지(winre.wim)를 추출하고 탑재합니다.

md c:\mount
xcopy D:\sources\install.wim C:\mount 
md C:\mount\windows
Dism /mount-image /imagefile:C:\mount\install.wim /index:1 /mountdir:C:\mount\windows 
md C:\mount\winre 
Dism /mount-image /imagefile:c:\mount\windows\windows\system32\recovery\winre.wim /index:1 /mountdir:C:\mount\winre

이 단계에 대한 자세한 내용은 Windows RE 사용자 지정 항목을 참조하세요.

메모장에서 사용자 지정 도구의 파일 이름 및 매개 변수(있는 경우)를 지정하는 구성 파일을 만듭니다.
```
<?xml version="1.0" encoding="utf-8"?>

<Recovery>
   <RecoveryTools>
      <RelativeFilePath>OEMDiagnostics.exe</RelativeFilePath>
      <CommandLineParam>/param1 /param2</CommandLineParam>
   </RecoveryTools>
</Recovery>
```
여기서 C:\Tools\OEMDiagnostics.exe는 사용자 지정 문제 해결 또는 진단 도구이며, 여기서 /param1 및 /param2는 이 사용자 지정 도구를 실행할 때 사용되는 선택적 매개 변수입니다.

참고

WinRE 고급 시작 메뉴에 사용자 지정 도구를 하나만 추가할 수 있습니다.

UTF-8 코딩을 사용하여 파일을 저장합니다. ANSI를 사용하지 마세요.

파일을 클릭한 후 다른 이름으로 저장을 클릭합니다. 인코딩 상자에서 UTF-8을 선택하고 이 파일을 C:\mount\WinREConfig.xml로 저장합니다.
WinRE 탑재 폴더에 \Sources\Recovery\Tools 폴더를 만든 다음, 사용자 지정 도구 및 해당 구성 파일을 새 폴더에 복사합니다.
```
md C:\mount\winre\sources\recovery\tools
copy C:\Tools\OEMDiagnostics.exe C:\mount\winre\sources\recovery\tools
copy C:\mount\WinREConfig.xml C:\mount\winre\sources\recovery\tools
```
이후 WinRE 업그레이드 후에도 계속 작동할 수 있도록 사용자 지정 도구 및 연결된 폴더가 이 폴더에 있어야 합니다.
사용자 지정을 커밋하고 WinRE 이미지를 분리합니다.
```
Dism /unmount-image /mountdir:C:\mount\winre /commit
```
선택 사항: WinRE 이미지의 백업 복사본을 만듭니다.
```
copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
```
여러 이미지에서 동일한 사용자 지정을 다시 사용할 수 있습니다.
기본 Windows 이미지에서 변경 내용을 분리하고 저장합니다.
```
Dism /unmount-image /mountdir:C:\mount\windows /commit
```

이미지 배포

메모장에서 고급 시작 메뉴의 사용자 지정 도구를 설명하는 구성 파일을 만듭니다. 지원하는 각 언어에 대한 설명을 추가합니다. 이 예제에서는 도구 이름과 설명의 영어 및 프랑스어 버전을 모두 지정합니다.
```
<?xml version="1.0" encoding="utf-8"?>

<BootShell>
   <WinRETool locale="en-us">
         <Name>Fabrikam Utility</Name>
         <Description>Troubleshoot your Fabrikam PC</Description>
   </WinRETool>
   <WinRETool locale="fr-fr">
      <Name>Utilité de Fabrikam</Name>
      <Description>Dépannez votre PC de Fabrikam</Description>
   </WinRETool>
</BootShell>
```
경고

고급 시작 메뉴에 올바르게 표시되도록 <Name> 및 <Description> 값을 약 30자 이하로 제한합니다.

UTF-8 코딩을 사용하여 파일을 저장합니다.

파일을 클릭한 후 다른 이름으로 저장을 클릭합니다. 인코딩 상자에서 UTF-8을 선택하고 이 파일을 E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml로 저장합니다.

여기서 E:\는 이동식 드라이브 또는 네트워크 위치의 드라이브 문자입니다.
대상 컴퓨터에서 이미지를 배포하는 동안 사용자 지정 WinRE 부팅 이미지와 Windows 운영 체제를 등록한 후 사용자 지정 도구에 대한 설명을 등록해야 합니다.
```
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
```
사용자 지정 도구가 제대로 등록될 경우 이 명령을 실행하면 <OEM Tool = 1> 같은 출력이 표시됩니다.

참고

Windows를 배포하는 방법에 대한 자세한 내용은 Windows RE 배포 항목을 참조하세요.

대상 컴퓨터를 다시 시작하고 사용자 권한으로 OOBE를 완료합니다.

참고

제품 키를 묻는 메시지가 표시되면 건너뛰기를 클릭합니다.
시작>PC 설정을 클릭한 다음, 일반을 선택합니다.
고급 시작 섹션에서 지금 다시 시작을 선택합니다.

Windows 고급 시작 메뉴가 나타납니다.
고급 시작 메뉴에서 문제 해결을 선택한 다음, Fabrikam 유틸리티 링크를 클릭합니다.

WinRE에서 컴퓨터가 다시 시작되고 WinREConfig.xml 파일의 <RecoveryTools> 섹션에 지정된 도구가 나타납니다.
사용자 지정 도구가 제대로 작동하는지 확인한 다음, 도구를 닫습니다.

사용자 지정 도구가 고급 시작 메뉴에 표시되지 않으면 다음을 시도할 수 있습니다.
- UTF-8 인코딩 형식을 사용하여 WinREConfig.xml 및 AddDiagnosticsToolToBootMenu.xml 파일이 저장되었는지 확인합니다.
- WinRE를 사용하지 않도록 설정하고 사용자 지정 도구를 다시 등록한 다음, WinRE를 사용하도록 설정합니다. 예를 들면 다음과 같습니다.
```
Reagentc /disable 
Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
Reagentc /enable
```