Automazione dell’installazione di componenti aggiuntivi durante l’installazioneAutomate Installation of Add-Ins During Setup

Si applica a: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 EssentialsApplies To: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

Automatizzare l'installazione di componenti aggiuntivi durante l'installazioneAutomate installing add-ins during setup

Per installare i componenti aggiuntivi durante l'installazione, usare il metodo PostIC.cmd descritto nella sezione Create the PostIC.cmd File for Running Post Initial Configuration Tasks di questo documento.To install add-ins during setup, use the PostIC.cmd method described in the Create the PostIC.cmd File for Running Post Initial Configuration Tasks section of this document.

Aggiungere la seguente voce al proprio PostIC.cmd:Add the following entry to your PostIC.cmd:

C:\Program Files\Windows Server\bin\Installaddin.exe <full path to wssx file> -q  

Ora il componente aggiuntivo supporta le operazioni di preinstallazione e disinstallazione personalizzata.The add-in now supports pre-install and customized uninstall steps.

L'operazione di preinstallazione viene eseguita prima di installare tutti i file .msi specificati in addin.xml.The pre-install step is run before installing all .msi files specified in addin.xml. Quando si lavora in modalità interattiva, viene visualizzata la finestra di avanzamento che però non mostra alcun progresso.When run in the interactive mode, the progress dialog will be shown but without changing the progress. Il pulsante di annullamento è disabilitato durante la fase di preinstallazione.The cancellation button is disabled during pre-install phase. Per implementare l'operazione di preinstallazione, aggiungere il seguente contenuto nel file addin.xml (direttamente in Package):To implement a pre-install step, add the following contents in addin.xml (directly under Package):

Nota

Lo schema xml deve essere esattamente come il seguente:The xml schema needs to exactly follow the one below:

<Package xmlns="https://schemas.microsoft.com/WindowsServerSolutions/2010/03/Addins" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
  <Id>...</Id>  
  <Version>...</Version>  
  <Name>...</Name>  
  <Allow32BitOn64BitClients>...</Allow32BitOn64BitClients>  
  <ServerBinary>...</ServerBinary>  
  <ClientBinary32>...</ClientBinary32>  
  <ClientBinary64>...</ClientBinary64>  
  <SupportedSkus>...</SupportUrl>    
  <SupportUrl>...</SupportUrl>  
  <Location>...</Location>    
  <PrivacyStatement>...</PrivacyStatement>  
  <OtherBinaries>...</OtherBinaries>   
  <Preinstall>  
<Executable>exefile</Executable>  
<NormalArgs>args-for-interactive-mode</NormalArgs>  
<SilentArgs>args-for-silent-mode</SilentArgs>  
<IgnoreExitCode>true</IgnoreExitCode>  
  </Preinstall>  
  <UninstallConfirm>...</UninstallConfirm>      
</Package>  
<¦>  
<¦>  

exefile è il file eseguibile nel pacchetto del componente aggiuntivo che consente di eseguire l'operazione di preinstallazione e deve quindi essere specificato.Wherein exefile is the executable file in the add-in package to perform the pre-install step, and must be specified. NormalArgs specifica gli argomenti da inviare a exefile nella riga di comando quando si utilizza la modalità interattiva.NormalArgs specifies arguments to be passed to exefile in command-line when interactive mode is used. In questa modalità, exefile può visualizzare alcune finestre di dialogo per l'interazione utente.In this mode, the exefile can popup some dialogs for user interaction. SilentArgs specifica gli argomenti da inviare a exefile nella riga di comando quando si utilizza la modalità non interattiva (-q viene specificato quando si richiama installaddin.exe).SilentArgs specifies arguments to be passed to exefile in command-line when silent mode is used (-q is specified when invoking installaddin.exe). In questa modalità, exefile non visualizzerà alcuna finestra.The exefile should not popup any windows in this mode. Se si imposta IgnoreExitCode su true, l'operazione di preinstallazione viene sempre considerata riuscita, altrimenti il codice di uscita 0 indica che l'operazione è stata completata, 1 che è stata annullata e altri valori che non è riuscita.If IgnoreExitCode is specified with true, the pre-install step is always considered successful, otherwise, exit code 0 indicates success, 1 indicates cancellation, and other values indicate failure. I tag NormalArgs, SilentArgs e IgnoreExitCode sono facoltativi.Tags NormalArgs, SilentArgs, and IgnoreExitCode are all optional.

È possibile utilizzare l'operazione di disinstallazione personalizzata per:A customized uninstall step can be used for any of the following:

  • Sostituire la finestra di dialogo di conferma predefinita.Replace the built-in confirmation dialog.

  • Inserire i dati nelle finestre di dialogo personalizzare prima della disinstallazione.Populate customized dialogs before uninstallation.

  • Eseguire alcune attività prima della disinstallazione.Perform certain tasks before uninstallation.

    Per implementare l'operazione di disinstallazione, aggiungere il seguente contenuto nel file addin.xml (direttamente in Package):To implement an uninstall step, add the following contents in addin.xml (directly under Package):

<Package xmlns="https://schemas.microsoft.com/WindowsServerSolutions/2010/03/Addins" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
  <Id>...</Id>  
  <Version>...</Version>  
  <Name>...</Name>  
  <Allow32BitOn64BitClients>...</Allow32BitOn64BitClients>  
  <ServerBinary>...</ServerBinary>  
  <ClientBinary32>...</ClientBinary32>  
  <ClientBinary64>...</ClientBinary64>  
  <SupportedSkus>...</SupportUrl>    
  <SupportUrl>...</SupportUrl>  
  <Location>...</Location>    
  <PrivacyStatement>...</PrivacyStatement>  
  <OtherBinaries>...</OtherBinaries>   
  <Preinstall>¦</Preinstall>  
<UninstallConfirm>  
<Executable>full-path-to-exefile</Executable>  
<Arguments>command-line-arguments</Arguments>  
</UninstallConfirm>  
</Package>  

full-path-to-exefile indica l'exefile già installato sul sistema.Wherein full-path-to-exefile specifies the exefile already installed on the system. Arguments è facoltativo e specifica gli argomenti della riga di comando per l'exefile.Arguments is optional, and specifies the command line arguments for the exefile. L'exefile viene richiamato prima che venga visualizzata la finestra di conferma della disinstallazione.The exefile is invoked before the built-in uninstall confirmation dialog pops up.

In questa fase, l'exefile può fare quanto segue:The exefile can perform following tasks in this phase:

  • Visualizzare alcune finestre di dialogo per consentire l'interazione utente.Pops up some dialogs for user interaction.

  • Eseguire alcune attività in background.Perform some background tasks.

    Dal codice di uscita del file exe dipende l'andamento del processo di disinstallazione:The exit code of this exe file determines how the uninstall process moves forward:

  • 0: il processo di disinstallazione prosegue senza inserire i dati nella finestra di conferma predefinita, come già confermato dall'utente.0: the uninstall process continues without populating the built-in confirmation dialog, just as user has already confirmed. Questo approccio può essere utilizzato per ignorare la finestra di conferma predefinita;(this approach can be used to replace the built-in confirmation dialog);

  • 1: il processo di disinstallazione viene annullato e visualizza un messaggio per informare l'utente.1: the uninstall process is canceled, and finally a canceled message will be shown to user. Nulla cambia;Everything stays unchanged;

  • Altro: il processo di disinstallazione prosegue con la finestra di conferma predefinita, come se l'operazione di disinstallazione personalizzata non fosse presente.Other: the uninstall process continues with built-in confirmation dialog, just like the customized uninstall step is not present.

    Qualsiasi errore che si verifica mentre viene richiamato exefile provoca lo stesso risultato che si ottiene quando exefile restituisce un codice diverso da 0 o 1.Any failure invoking the exefile will lead to the same behavior as the exefile returns a code other than 0 or 1.

Vedere ancheSee Also

Creazione e personalizzazione dell'immagine Creating and Customizing the Image
Personalizzazioni aggiuntive Additional Customizations
Preparazione dell'immagine per la distribuzione Preparing the Image for Deployment
Test di Analisi utilizzo softwareTesting the Customer Experience