Panoramica dello Strumento di distribuzione di Office

Office Deployment Tool (ODT) è uno strumento da riga di comando che è possibile usare per scaricare e distribuire Microsoft 365 Apps nei computer client. Lo strumento ODT consente un maggiore controllo sull'installazione di Office: è possibile specificare i prodotti e le lingue installati, la modalità di aggiornamento dei prodotti e se si vuole che l'esperienza di installazione sia visibile agli utenti.

Se non si è un amministratore aziendale e si sta cercando di installare Microsoft 365 a casa o all'azienda, vedere Scaricare e installare o reinstallare Microsoft 365 o Office 2021 in un PC o Mac.

Scaricare lo Strumento di distribuzione di Office

Scaricare lo Strumento di distribuzione di Office dall'Area download Microsoft.

Dopo il download del file, eseguire il file eseguibile autoestraente, che contiene il file eseguibile dello Strumento di distribuzione di Office (setup.exe) e un file di configurazione di esempio (configuration.xml).

Prima di utilizzare ODT per scaricare o installare Office, è consigliabile verificare di disporre della versione più recente.

Consiglio

Per altre informazioni sulle modifiche apportate alla versione più recente di ODT, vedere Cronologia versioni per Lo strumento di distribuzione di Office.

Informazioni sullo Strumento di distribuzione di Office

Lo strumento ODT è costituito da due file: setup.exe e configuration.xml. Per usare lo strumento, modificare il file di configurazione per definire le opzioni desiderate, quindi eseguire setup.exe dalla riga di comando. Ad esempio, è possibile modificare il file di configurazione per installare l'edizione inglese a 64 bit di Office con le condizioni di licenza accettate automaticamente. Per il set completo di opzioni, vedere Opzioni di configurazione per lo strumento di distribuzione di Office.

Nota

Procedura consigliata: Questo articolo illustra gli elementi e gli attributi XML nel file di configurazione per lo strumento di distribuzione di Office. È possibile continuare a creare il file di configurazione in un editor di testo, ma è consigliabile usare lo strumento di personalizzazione di Office . Con lo strumento di personalizzazione di Office è possibile creare e modificare facilmente i file di configurazione in un'interfaccia basata sul Web. Per altre informazioni, vedere Panoramica dello Strumento di personalizzazione di Office.

Quando si esegue ODT, specificare il percorso del file di configurazione e definire in quale modalità eseguire ODT:

  • Per scaricare i prodotti e le lingue di Microsoft 365 Apps, usare la modalità di download . Esempio: setup.exe /download downloadconfig.xml. Quando si scarica Office in una cartella che contiene già tale versione di Office, lo Strumento di distribuzione di Office conserverà la larghezza di banda della rete scaricando solo i file mancanti. Ad esempio, se si utilizza lo Strumento di distribuzione di Office per scaricare Office in inglese e tedesco in una cartella che contiene già Office in inglese, verrà scaricato solo il pacchetto in lingua tedesca.

  • Per installare i prodotti e le lingue di Microsoft 365 Apps scaricati in un computer client, usare la modalità di configurazione . Questa modalità può essere usata anche per rimuovere e aggiornare i prodotti e le lingue di Office. Esempio: setup.exe /configure installconfig.xml

  • Per applicare nuove preferenze dell'applicazione ai computer client in cui è già installato Microsoft 365 Apps, usare la modalità di personalizzazione . Questa modalità applica solo le preferenze dell'applicazione, senza modificare altre impostazioni di distribuzione. Esempio: setup.exe /customize preferencesconfig.xml

  • Per creare un pacchetto App-V dai prodotti e dalle lingue di Microsoft 365 Apps scaricati, usare la modalità packager . Esempio: setup.exe /packager packageconfig.xml

È anche possibile usare la modalità Guida per leggere la Guida della riga di comando per lo strumento.

Scaricare i file di installazione per Microsoft 365 Apps

Seguire questa procedura per scaricare i file di installazione per Microsoft 365 Apps da Office Content Delivery Network (CDN).

Passaggio 1: Creare il file di configurazione

Quando si crea il file di configurazione, è consigliabile partire da un file di esempio e aggiornarlo con le opzioni appropriate per l'ambiente. Iniziare copiando e incollando l'esempio riportato di seguito in un file di testo, salvandolo con un nome di propria scelta e modificando quindi gli attributi e gli elementi XML per definire le opzioni desiderate.

In questo esempio, il file di configurazione scarica i file di installazione per un'edizione in inglese a 32 bit di Microsoft 365 Apps for enterprise e la versione della sottoscrizione dell'app desktop Visio in \\server\share nella rete:

<Configuration> 
  <Add SourcePath="\\server\share" OfficeClientEdition="32"> 
   <Product ID="O365ProPlusRetail" > 
     <Language ID="en-us" />      
   </Product> 
   <Product ID="VisioProRetail" > 
     <Language ID="en-us" />      
   </Product> 
 </Add> 
</Configuration>

Per ulteriori informazioni sulle opzioni di configurazione e altri esempi, vedere Opzioni di configurazione per lo Strumento di distribuzione di Office.

Passaggio 2: Eseguire il file eseguibile ODT in modalità download

Da un prompt dei comandi eseguire il file eseguibile ODT in modalità download e con un riferimento al file di configurazione salvato. In questo esempio, il file di configurazione è denominato downloadconfig.xml:

setup.exe /download downloadconfig.xml

Passaggio 3: Controllare che i file siano stati scaricati

Dopo avere eseguito il comando, passare al percorso di download definito nel file di configurazione e cercare una cartella Office contenente i file appropriati. Se si verificano problemi, verificare di avere la versione più recente dello strumento ODT. È anche possibile risolvere i problemi esaminando il file di log nella cartella %temp%.

Scaricare i file di installazione per Microsoft 365 Apps da un'origine locale

È possibile usare lo strumento di distribuzione di Office per scaricare i file di installazione per Microsoft 365 Apps da un'origine locale nella rete. In questo modo è possibile archiviare una copia centralizzata di più lingue e prodotti per Office e distribuire solo le lingue e i prodotti necessari nelle altre posizioni della rete.

Per scaricare da un'origine locale, seguire la procedura per il download di Office con lo strumento ODT, ma includere il percorso di download nel file di configurazione, che definisce la posizione da cui scaricare i file di installazione. Ad esempio, questo file di configurazione scarica un'edizione in inglese a 32 bit di Microsoft 365 Apps for enterprise da \\servera\share (DownloadPath) in \\serverb\share (SourcePath):

<Configuration> 
  <Add SourcePath="\\serverb\share" OfficeClientEdition="32" Version="16.0.6741.2056" DownloadPath="\\servera\share"> 
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />      
    </Product> 
  </Add> 
</Configuration>

Quando si usa DownloadPath, è necessario specificare una versione.

Installare Microsoft 365 Apps

Dopo aver scaricato i file di installazione di Microsoft 365 Apps, seguire questa procedura per installare Office in un computer client. Come parte dell'installazione, è possibile scegliere quali prodotti installare.

Passaggio 1: Creare il file di configurazione

Quando si crea il file di configurazione, è consigliabile partire da un file di esempio e aggiornarlo con le opzioni appropriate per l'ambiente. Iniziare copiando e incollando l'esempio riportato di seguito in un file di testo, salvandolo con un nome di propria scelta e modificando quindi gli attributi e gli elementi XML per definire le opzioni desiderate.

In questo esempio, il file di configurazione installa un'edizione inglese a 32 bit di Microsoft 365 Apps for enterprise senza Publisher:

<Configuration> 
  <Add SourcePath="\\Server\share" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />        
      <ExcludeApp ID="Publisher" />
    </Product> 
  </Add> 
  <Display Level="None" AcceptEULA="TRUE" />
</Configuration> 

Il percorso dei file di installazione di Office è \\server\share. Il livello di visualizzazione è impostato su Nessuno, il che significa che l'utente non visualizzerà alcuna interfaccia utente durante l'installazione. AcceptEULA è impostato su TRUE, il che significa che gli utenti non dovranno fare clic per accettare le condizioni di licenza durante l'installazione.

Per ulteriori informazioni sulle opzioni di configurazioni, vedere Opzioni di configurazione per lo Strumento di distribuzione di Office.

Passaggio 2: Eseguire il file eseguibile ODT in modalità configurazione

Da un prompt dei comandi eseguire il file eseguibile ODT in modalità di configurazione con un riferimento al file di configurazione salvato. Nell'esempio seguente il file di configurazione è denominato installconfig.xml:

setup.exe /configure installconfig.xml

È necessario disporre delle autorizzazioni di amministratore locale nel computer client. È possibile eseguire il file eseguibile dal computer client in cui si vuole installare Office oppure inserire il file ODT e il file di configurazione in una condivisione di rete ed eseguirlo da qui. Se si usa una condivisione di rete, assicurarsi di passare al comando il percorso di rete completo sia per il setup.exe che per il file di configurazione.

Passaggio 3: Verificare che l'installazione sia stata completata

Dopo avere eseguito il comando, l'installazione di Office dovrebbe iniziare, a meno che il livello di visualizzazione non sia impostato su Nessuno. Al termine dell'installazione, nel prompt dei comandi verrà visualizzato "Prodotti configurati correttamente". Se si verificano problemi, assicurarsi di avere la versione più recente di ODT. È anche possibile risolvere i problemi esaminando i file di log nella cartella %temp%.

Aggiornare Microsoft 365 Apps

È possibile usare lo strumento di distribuzione di Office per apportare aggiornamenti ai computer client dopo l'installazione di Microsoft 365 Apps. Esistono due modi per eseguire gli aggiornamenti:

  • Usare ODT per installare di nuovo Microsoft 365 Apps, che aggiornerà Office alla versione più recente. Verranno aggiornati solo i file che sono stati modificati nella nuova versione.

  • Usare lo strumento ODT per scaricare i file di installazione di Office e quindi inserire questa posizione nei computer client per ricevere gli aggiornamenti. Per impostazione predefinita, i client vengono aggiornati direttamente dalla rete per la distribuzione di contenuti (CDN) di Office.

Per modificare il percorso in cui i computer client ricevono gli aggiornamenti, eseguire lo strumento ODT in modalità di configurazione e specificare un percorso di aggiornamento nel file di configurazione. Ad esempio, per fare in modo che Microsoft 365 Apps ottenga automaticamente gli aggiornamenti da una condivisione di rete denominata \\server\updates, includere la riga seguente nel file di configuration.xml:

<Updates Enabled="TRUE" UpdatePath="\\server\updates" />

In questo articolo non viene illustrata tutti i problemi relativi a gestire gli aggiornamenti per Office all'interno dell'organizzazione. Per altre informazioni su questo scenario, incluso l'uso di Criteri di gruppo, vedere Scegliere come gestire gli aggiornamenti per Microsoft 365 Apps.

Escludere o rimuovere applicazioni di Microsoft 365 Apps dai computer client

Quando si installa Microsoft 365 Apps, è possibile escludere applicazioni specifiche. A questo scopo, seguire i passaggi per installare Office con lo strumento ODT, ma includere l'elemento ExcludeApp nel file di configurazione. Ad esempio, questo file di configurazione installa tutte le applicazioni Microsoft 365 Apps for enterprise tranne Publisher:

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <ExcludeApp ID="Publisher" />
    </Product>
</Add>

Se è già stato installato Microsoft 365 Apps, è anche possibile usare l'elemento ExcludeApp per rimuovere un'applicazione installata in precedenza. Ad esempio, il file di configurazione precedente rimuove Publisher dall'installazione precedente di Office.

È anche possibile rimuovere un'intera versione della lingua di Microsoft 365 Apps. A questo scopo, seguire i passaggi per escludere i prodotti dall'installazione di Office con lo strumento ODT, ma sostituire il file di configurazione con un file che usa l'elemento Remove. Ad esempio, questo file di configurazione rimuove la versione in lingua spagnola di Microsoft 365 Apps for enterprise:

<Configuration> 
 <Remove>
    <Product ID="O365ProPlusRetail" > 
      <Language ID="es-es" />        
    </Product> 
 </Remove>
</Configuration> 

Per ulteriori informazioni sulle opzioni per l'esclusione o la rimozione di app, vedere Opzioni di configurazione per lo Strumento di distribuzione di Office.

Escludere OneDrive durante l'installazione di Microsoft 365 Apps o altre applicazioni

OneDrive viene installato automaticamente quando si installa Microsoft 365 Apps o si installano singole applicazioni, ad esempio Word, Excel, PowerPoint, Publisher, Visio o Skype. Se non si vuole installare OneDrive con tali applicazioni, usare l'elemento ExcludeApp per rimuoverlo, come illustrato nell'esempio.

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <ExcludeApp ID="OneDrive" />
    </Product>
</Add>

Distribuire più lingue o corrispondenti

Per informazioni dettagliate sulla distribuzione delle lingue, vedere Panoramica della distribuzione delle lingue per Microsoft 365 Apps.

Applicare le preferenze dell'applicazione a Microsoft 365 Apps

Come parte della distribuzione, è possibile definire le preferenze dell'applicazione per Microsoft 365 Apps, incluse le notifiche macro VBA, i percorsi predefiniti dei file e i formati di file predefiniti. A tale scopo, si distribuisce Office usando la procedura standard descritta in Installare Microsoft 365 Apps, ma si includono le preferenze dell'applicazione come parte del file di configurazione.

Per creare il file di configurazione, è consigliabile usare lo strumento di personalizzazione di Office per a portata di clic, un'applicazione Web con un'interfaccia utente completa.

  1. Nel Web browser aprire lo Strumento di personalizzazione di Office per A portata di clic e seguire la procedura per creare un file di configurazione, inclusa la definizione delle preferenze dell'applicazione insieme alle impostazioni di distribuzione standard.
  2. Esportare il file.
  3. Seguire la procedura descritta in Installare Microsoft 365 Apps per distribuire Office con il file di configurazione appena creato.

In questo esempio, il file di configurazione installa la versione a 32 bit di Microsoft 365 Apps for enterprise in inglese e visualizza la barra di attendibilità per tutte le macro VBA in Excel.

<Configuration>
  <Add OfficeClientEdition="32" Channel="Current">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
  <AppSettings>
    <User Key="software\microsoft\office\16.0\excel\security"
          Name="vbawarnings" 
          Value="3" 
          Type="REG_DWORD" 
          App="excel16" 
          Id="L_VBAWarningsPolicy" />
  </AppSettings>
</Configuration>

Questo file è stato creato con lo strumento di personalizzazione di Office per a portata di clic. Per altre informazioni sulle preferenze dell'app, è consigliabile esplorare le opzioni nello strumento stesso.

Nota: quando Office è installato, le preferenze dell'app definite nel file di configurazione vengono applicate a tutti gli utenti esistenti del dispositivo e a tutti i nuovi utenti aggiunti al dispositivo in futuro.

Applicare le preferenze dell'applicazione a un'installazione esistente di Microsoft 365 Apps

È possibile applicare nuove preferenze dell'applicazione ai computer client in cui è già installato Microsoft 365 Apps senza modificare altre impostazioni di distribuzione. A tale scopo, creare un file di configurazione che contiene le preferenze dell'applicazione e quindi eseguire ODT in modalità di personalizzazione . La modalità di personalizzazione ignora tutte le altre impostazioni nel file di configurazione, ad eccezione delle preferenze dell'applicazione.

  1. Usare i passaggi descritti in Definire le preferenze dell'applicazione per creare il file di configurazione.
  2. Da un prompt dei comandi eseguire l'eseguibile ODT in modalità personalizzata con un riferimento al file di configurazione creato. Nell'esempio seguente il file di configurazione è denominato installapppreferences.xml:

setup.exe /customize installapppreferences.xml

È necessario eseguire il file eseguibile dal computer client in cui si desidera applicare le preferenze dell'app ed è necessario disporre delle autorizzazioni di amministratore locale per tale computer. Quando si usa la modalità di personalizzazione, le preferenze dell'app definite nel file di configurazione vengono applicate a tutti gli utenti esistenti del dispositivo e a tutti i nuovi utenti aggiunti al dispositivo in futuro. Se si applicano le preferenze dell'applicazione quando le app di Office sono in esecuzione, le preferenze verranno applicate al successivo riavvio di Office.

Creare un pacchetto App-V per Microsoft 365 Apps

Oltre a scaricare e distribuire Microsoft 365 Apps, è possibile usare lo strumento di distribuzione di Office per creare pacchetti App-V. A questo scopo, aggiornare il file di configurazione e quindi eseguire lo strumento ODT in modalità packager. È necessario creare pacchetti App-V in un computer con un'installazione pulita del sistema operativo.

Questo articolo non descrive tutti i problemi relativi alla distribuzione dei pacchetti di App-V. Per altre informazioni su questo scenario, vedere Distribuzione di Microsoft Office 2016 tramite App-V.

Passaggio 1: Creare il file di configurazione

Quando si crea il file di configurazione, è consigliabile partire da un file di esempio e aggiornarlo con le opzioni appropriate per l'ambiente. Iniziare copiando e incollando l'esempio riportato di seguito in un file di testo, salvandolo con un nome di propria scelta e modificando quindi gli attributi e gli elementi XML per definire le opzioni desiderate.

In questo esempio, il file di configurazione crea un pacchetto App-V da un'edizione in inglese a 32 bit di Microsoft 365 Apps for enterprise senza Publisher:

<Configuration> 
 <Add SourcePath="\\Server\share" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />        
      <ExcludeApp ID="Publisher" />
    </Product> 
 </Add> 
</Configuration> 

Il percorso dei file di installazione di Office è \\server\share. Per il file di configurazione, sostituire i valori di esempio con l'opzione appropriata per l'ambiente. Per altre informazioni sulle opzioni, vedere Opzioni di configurazione per lo strumento di distribuzione di Office,

Passaggio 2: Eseguire il file eseguibile ODT in modalità packager

Da un prompt dei comandi eseguire l'eseguibile ODT in modalità packager con un riferimento al file di configurazione salvato e al percorso in cui si vuole salvare il pacchetto App-V. Nell'esempio seguente, il file di configurazione denominato packageconfig.xml e il pacchetto App-V verrà salvato in \\server\share\appv\:

setup.exe /packager packageconfig.xml \\server\share\appv\

Passaggio 3: Verificare che il pacchetto sia stato creato

Dopo aver eseguito il comando, la posizione del pacchetto deve contenere una cartella Pacchetti App-V e una cartella WorkingDir. È possibile risolvere i problemi esaminando il file di log nella cartella %temp%.