Adicionar uma ferramenta personalizada ao menu de inicialização avançada do Windows RE

Você pode adicionar uma ferramenta personalizada de solução de problemas ou diagnóstico à imagem do WinRE (Ambiente de Recuperação do Windows). Essa ferramenta é exibida no menu Inicialização avançada.

Ao desenvolver sua ferramenta personalizada para ser executada no WinRE, você pode aproveitar o suporte ao teclado virtual e ao toque disponível no WinRE.

Adicionar uma ferramenta personalizada

1. Extraia e monte uma imagem do Windows (install.wim) e sua imagem WinRE correspondente (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
   

   Para obter mais informações sobre essas etapas, consulte o tópico: Personalizar Windows RE.

2. No Bloco de Notas, crie um arquivo de configuração que especifique o nome de arquivo e os parâmetros da ferramenta personalizada (se houver):

   <?xml version="1.0" encoding="utf-8"?>
   <!-- WinREConfig.xml -->
   <Recovery>
      <RecoveryTools>
         <RelativeFilePath>OEMDiagnostics.exe</RelativeFilePath>
         <CommandLineParam>/param1 /param2</CommandLineParam>
      </RecoveryTools>
   </Recovery>
   

   Em que C:\Tools\OEMDiagnostics.exe é a ferramenta personalizada de solução de problemas ou diagnóstico e onde /param1 e /param2 são parâmetros opcionais usados ao executar essa ferramenta personalizada.

   Observação

   Você só pode adicionar uma ferramenta personalizada aos menus de inicialização do WinRE Advanced.

   Salve o arquivo usando a codificação UTF-8. Não use ANSI:

   Clique em Arquivo e em Salvar como. Na caixa Codificação , selecione UTF-8 e salve esse arquivo como C:\mount\WinREConfig.xml.

3. Crie uma \Sources\Recovery\Tools pasta na pasta de montagem do WinRE e copie a ferramenta personalizada e seu arquivo de configuração para a nova pasta:

   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
   

   A ferramenta personalizada e todas as pastas associadas devem estar nessa pasta para que ela possa continuar funcionando após futuras atualizações do WinRE.

4. Confirme suas personalizações e desmonte a imagem do WinRE:

   Dism /unmount-image /mountdir:C:\mount\winre /commit
   

5. Opcional: faça uma cópia de backup da imagem do WinRE.

   copy C:\mount\windows\windows\system32\recovery\winre.wim C:\mount\winre_amd64_backup.wim
   

   Muitas vezes, você pode reutilizar as mesmas personalizações em várias imagens.

6. Desmonte e salve as alterações da imagem base do Windows:

   Dism /unmount-image /mountdir:C:\mount\windows /commit
   

Implantar a imagem

1. No Bloco de Notas, crie um arquivo de configuração que descreva a ferramenta personalizada no menu Inicialização avançada. Adicione descrições para cada idioma ao qual você dá suporte. Este exemplo especifica as versões em inglês e francês do nome e da descrição da ferramenta:

   <?xml version="1.0" encoding="utf-8"?>
   <!-- AddDiagnosticsToolToBootMenu.xml -->
   <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>
   

   Aviso

   Limite os <Name> valores e <Description> a aproximadamente 30 caracteres ou menos para garantir que eles apareçam corretamente no menu Inicialização avançada.

   Salve o arquivo usando a codificação UTF-8:

   Clique em Arquivo e em Salvar como. Na caixa Codificação , selecione UTF-8 e salve esse arquivo como E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml.

   Em que E:\ é a letra da unidade de uma unidade removível ou local de rede.

2. No computador de destino, durante a implantação da imagem, mas depois de registrar a imagem de inicialização personalizada do WinRE e o sistema operacional Windows, você deve registrar a descrição da ferramenta personalizada:

   Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
   

   Se a ferramenta personalizada for registrada corretamente, a saída da execução desse comando será: <OEM Tool = 1>.

   Observação

   Para obter mais informações sobre como implantar o Windows, consulte o tópico Implantar Windows RE.

Verifique se a ferramenta personalizada aparece no menu Inicialização avançada quando iniciada do Windows

1. Reinicie o computador de destino e conclua o OOBE como seu usuário.

   Observação

   Se for solicitada uma chave do produto (Product Key), clique em Ignorar.

2. Clique em Iniciar>configurações do computador e selecione Geral.

3. Na seção Inicialização avançada , selecione Reiniciar agora.

   O menu de inicialização do Windows Advanced é exibido.

4. No menu Inicialização avançada , selecione Solucionar problemas e clique no link Utilitário da Fabrikam .

   O computador é reiniciado no WinRE e a ferramenta especificada na <seção RecoveryTools> do arquivo WinREConfig.xml é exibida.

5. Confirme se a ferramenta personalizada funciona corretamente e feche a ferramenta.

   Se a ferramenta personalizada não aparecer no menu Inicialização avançada, você poderá tentar o seguinte:

   • Verifique se o WinREConfig.xml e os arquivos de AddDiagnosticsToolToBootMenu.xml são salvos usando o formato de codificação UTF-8.

   • Desabilite o WinRE, registre a ferramenta personalizada novamente e habilite o WinRE. Por exemplo:

     Reagentc /disable 
     Reagentc /setbootshelllink /configfile E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml
     Reagentc /enable
     

Verifique se a ferramenta personalizada aparece no menu de recuperação do WinRE

1. No menu de recuperação, selecione Solucionar problemas e clique no link Utilitário da Fabrikam .

2. Confirme se a ferramenta personalizada funciona corretamente e feche a ferramenta.

3. Clique em Continuar.

   O computador é reinicializado no sistema operacional.

Tópicos relacionados

Referência técnica do Ambiente de Recuperação do Windows (Windows RE)

Personalizar o Windows RE

Implantar o Windows RE

Recursos de solução de problemas do Windows RE