Condividi tramite


Aggiungere uno strumento personalizzato al menu di avvio avanzato di Windows RE

È possibile aggiungere uno strumento di risoluzione dei problemi o di diagnostica personalizzato all'immagine Windows Recovery Environment (WinRE). Questo strumento viene visualizzato nel menu di avvio avanzato.

Sviluppando lo strumento personalizzato da eseguire in WinRE, è possibile sfruttare il supporto della tastiera touch e dello schermo disponibile in WinRE.

Novità per Windows 10: non sarà possibile aggiungere componenti facoltativi WinRE che non sono già presenti negli strumenti WinRE predefiniti. Ad esempio, se si dispone di un'app da Windows 8 che dipende dai componenti facoltativi .NET, sarà necessario riscrivere l'app per Windows 10.

Aggiungere uno strumento personalizzato

  1. Estrarre e montare un'immagine di Windows (install.wim) e la relativa immagine WinRE corrispondente (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
    

    Per altre informazioni su questi passaggi, vedere l'argomento: Personalizzare Windows RE.

  2. Nel Blocco note creare un file di configurazione che specifica i parametri e i nomi file e i parametri dello strumento personalizzati (se presenti):

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

    Dove C:\Tools\OEMDiagnostics.exe è lo strumento personalizzato per la risoluzione dei problemi o la diagnostica e dove /param1 e /param2 sono parametri facoltativi usati durante l'esecuzione di questo strumento personalizzato.

    Nota

    È possibile aggiungere uno strumento personalizzato solo ai menu di avvio di WinRE Advanced.

    Salvare il file usando la codifica UTF-8. Non usare ANSI:

    Fare clic su File e quindi su Salva con nome. Nella casella Codifica selezionare UTF-8 e salvare il file come C:\mount\WinREConfig.xml.

  3. Creare una \Sources\Recovery\Tools cartella nella cartella di montaggio WinRE e quindi copiare lo strumento personalizzato e il relativo file di configurazione nella nuova cartella:

    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
    

    Lo strumento personalizzato e le cartelle associate devono trovarsi in questa cartella in modo che possa continuare a funzionare dopo gli aggiornamenti winRE futuri.

  4. Eseguire il commit delle personalizzazioni e smontare l'immagine WinRE:

    Dism /unmount-image /mountdir:C:\mount\winre /commit
    
  5. Facoltativo: creare una copia di backup dell'immagine WinRE.

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

    È spesso possibile riutilizzare le stesse personalizzazioni in più immagini.

  6. Smontare e salvare le modifiche dall'immagine di Windows di base:

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

Distribuire l'immagine

  1. Nel Blocco note creare un file di configurazione che descrive lo strumento personalizzato nel menu Di avvio avanzato. Aggiungere descrizioni per ogni lingua supportata. Questo esempio specifica sia le versioni in lingua inglese che francese del nome e della descrizione dello strumento:

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

    Avviso

    Limitare i <Name> valori e <Description> a circa 30 caratteri o meno per assicurarsi che vengano visualizzati correttamente nel menu di avvio avanzato.

    Salvare il file usando la codifica UTF-8:

    Fare clic su File e quindi su Salva con nome. Nella casella Codifica selezionare UTF-8 e salvare il file come E:\Recovery\BootMenu\AddDiagnosticsToolToBootMenu.xml.

    Dove E:\ è la lettera di unità di un'unità rimovibile o un percorso di rete.

  2. Nel computer di destinazione, durante la distribuzione delle immagini, ma dopo aver registrato l'immagine di avvio WinRE personalizzata e il sistema operativo Windows, è necessario registrare la descrizione dello strumento personalizzato:

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

    Se lo strumento personalizzato è registrato correttamente, l'output dell'esecuzione di questo comando sarà: <OEM Tool = 1>.

    Nota

    Per altre informazioni sulla distribuzione di Windows, vedere l'argomento Distribuisci Windows RE .

Verificare che lo strumento personalizzato venga visualizzato nel menu di avvio avanzato quando viene avviato da Windows

  1. Riavviare il computer di destinazione e completare OOBE come utente.

    Nota

    Se viene richiesto un codice Product Key, fare clic su Ignora.

  2. Fare clic su Avvia>impostazioni PC e quindi selezionare Generale.

  3. Nella sezione Avvio avanzato selezionare Riavvia ora.

    Viene visualizzato il menu di avvio avanzato di Windows.

  4. Nel menu Di avvio avanzato selezionare Risoluzione dei problemi e quindi fare clic sul collegamento Utilità Fabrikam .

    Il computer viene riavviato in WinRE e viene visualizzato lo strumento specificato nella <sezione RecoveryTools> del file WinREConfig.xml.

  5. Verificare che lo strumento personalizzato funzioni correttamente e quindi chiudere lo strumento.

    Se lo strumento personalizzato non viene visualizzato nel menu Di avvio avanzato, è possibile provare quanto segue:

    • Verificare che i WinREConfig.xml e i file di AddDiagnosticsToolToBootMenu.xml vengano salvati usando il formato di codifica UTF-8.

    • Disabilitare WinRE, registrare di nuovo lo strumento personalizzato e quindi abilitare WinRE. Ad esempio:

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

Verificare che lo strumento personalizzato venga visualizzato nel menu di ripristino WinRE

  1. Nel menu di ripristino selezionare Risoluzione dei problemi e quindi fare clic sul collegamento Utilità Fabrikam .

  2. Verificare che lo strumento personalizzato funzioni correttamente e quindi chiudere lo strumento.

  3. Fare clic su Continue.

    Il PC viene riavviato nel sistema operativo.

Informazioni di riferimento tecnico su Windows Recovery Environment (Windows RE)

Personalizzare Ambiente ripristino Windows

Distribuire Windows RE

Funzionalità di risoluzione dei problemi di Windows RE