將自訂工具新增至 [進階啟動] 功能表Windows RE

發行項
06/19/2023

您可以將自訂疑難排解或診斷工具新增至 Windows 復原環境 (WinRE) 映射。此工具會顯示在 [進階啟動] 功能表中。

藉由開發自訂工具以在 WinRE 中執行，您可以利用 WinRE 中提供的觸控和螢幕鍵盤支援。

Windows 10的新功能：您將無法新增尚未在預設 WinRE 工具中的 WinRE 選用元件。例如，如果您有來自 Windows 8 且相依於 .NET 選用元件的應用程式，則需要針對 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 是自訂疑難排解或診斷工具，以及執行這個自訂工具時所使用的選擇性 /param2 參數。 /param1

注意

您只能將一個自訂工具新增至 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。

注意

如果系統提示您輸入產品金鑰，請按一下 [略過]。
按一下[啟動>電腦設定]，然後選取 [一般]。
在 [ 進階啟動 ] 區段中，選取 [立即重新開機]。

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