Opzioni di configurazione per lo Strumento di distribuzione di Office

Con Office Deployment Tool (ODT), è possibile 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. Questo articolo mostra tutte le opzioni disponibili nello strumento. Per informazioni su come usare lo strumento stesso, vedere Panoramica dello strumento di distribuzione di Office.

Nota

Procedura consigliata: Le opzioni in questo articolo mostrano gli elementi XML e gli attributi nel file di configurazione. È 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.

Esempio di un file di configurazione standard

L'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, per scaricare la versione inglese a 64 bit di Office, modificare il file di configurazione. Analogamente, per installare questa versione con le condizioni di licenza preaccepted ed escludendo Publisher, modificare il file di conseguenza.

Quando si crea il file di configurazione, è consigliabile partire da un file di esempio e aggiornarlo con le opzioni appropriate per l'ambiente. È possibile iniziare copiando e incollando l'esempio seguente in un file di testo e salvandolo con un nome a scelta. Usare il file per modificare gli elementi e gli attributi XML e usare il resto di questo articolo per altre informazioni su ognuno degli elementi e degli attributi.

Questo file di configurazione include gli elementi e gli attributi più usati e può essere usato per scaricare e installare Office in un computer client.

<Configuration>
  <Add SourcePath="\\Server\Share" 
       OfficeClientEdition="64"
       Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
    <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
  </Add>
  <Updates Enabled="TRUE" 
           UpdatePath="\\Server\Share" />
   <Display Level="None" AcceptEULA="TRUE" />  
</Configuration>
Valore Descrizione
Add SourcePath="\\Server\Share"
Office viene scaricato in "\\server\share" nella rete e distribuito usando i file di installazione in tale percorso.
Aggiungere OfficeClientEdition="64"
Scarica e installa l'edizione a 64 bit di Office
Add Channel="MonthlyEnterprise"
Office viene installato tramite Monthly Enterprise Channel.
Product ID="O365ProPlusRetail"
Scarica e installa Microsoft 365 Apps for enterprise.
Language ID="en-us"
Language ID="ja-jp"
Consente di scaricare e installare versioni di Office in lingua inglese e giapponese.
Updates Enabled="TRUE"
Office verifica la disponibilità di aggiornamenti.
Aggiornamenti UpdatePath="\\Server\Share"
Office verifica la disponibilità di aggiornamenti in "\server\share" nella rete.
Display Level="None" AcceptEULA="TRUE"
Durante l'installazione di Office, non viene visualizzata nessuna interfaccia utente.

Nota

L'elemento Logging non è più supportato come opzione di configurazione per lo strumento di distribuzione di Office. I file di log sono disponibili nella cartella %temp% dell'utente e in C:\Windows\Temp.

Elemento Add

Definisce i prodotti e le lingue da scaricare o installare.

Esempio

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     Version="16.0.15330.20306" >
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
  </Product>
  <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>  

Attributo SourcePath (parte dell'elemento Add)

Facoltativo.

Definisce il percorso dei file di installazione di Office. Se l'ODT viene eseguito in modalità download, definisce il percorso di salvataggio dei file. Se non è incluso, ODT cerca i file di installazione nella stessa cartella dello strumento e quindi usa la rete cdn (Content Delivery Network) di Office. Se non è incluso e lo strumento ODT viene eseguito in modalità di download, i file di installazione di Office vengono scaricati nella stessa cartella dello strumento.

Quando si scarica Office in una cartella che contiene già quella versione di Office, ODT consente di risparmiare la larghezza di banda di rete scaricando solo i file mancanti. Ad esempio, se si usa ODT per scaricare Office in inglese e tedesco in una cartella che contiene già Office in inglese, viene scaricato solo il Language Pack tedesco.

Valori di esempio:

  • SourcePath="\\server\share"
  • SourcePath="C:\Downloads\Microsoft"

Non includere la parte /Office o il nome della cartella contenente i dati di Office scaricati nel valore SourcePath.

Attributo versione (parte dell'elemento Add)

Facoltativo. Se non specificato, usa per impostazione predefinita la versione più recente disponibile.

Quando si usa l'attributo Version, è consigliabile includere anche l'attributo Channel. Se non si include l'attributo Channel, viene usato il canale predefinito, che potrebbe non corrispondere alla versione specificata.

Se Microsoft 365 Apps è già installato in un dispositivo, è possibile usare Version="MatchInstalled" per installare la stessa versione di Office, anche se è disponibile una versione più recente. Questa impostazione può semplificare l'aggiunta di Language Pack o Visio e Project senza aggiornare Office a una versione più recente.

Valori di esempio:

  • Version="16.0.15330.20306"
  • Version="MatchInstalled"

Attributo OfficeClientEdition (parte dell'elemento Add)

Facoltativo.

Definisce se l'edizione a 32 bit o a 64 bit di Microsoft 365 Apps viene scaricata o installata. Se Office non è installato e OfficeClientEdition non è specificato, il valore predefinito di ODT è l'edizione a 64 bit. Questa situazione si verifica a meno che il dispositivo non eserciti una versione a 32 bit di Windows o abbia meno di 4 GB di RAM. Se Office è installato e OfficeClientEdition non è specificato, ODT corrisponde all'architettura dell'installazione esistente di Office. Se Office è installato e OfficeClientEdition è specificato, deve corrispondere all'architettura già installata. In caso contrario, l'installazione ha esito negativo, poiché le architetture miste non sono supportate.

Valori consentiti:

  • OfficeClientEdition="64"
  • OfficeClientEdition="32"

Attributo del canale (parte dell'elemento Add)

Facoltativo.

Definisce il canale da usare per l'installazione di Office. Se Office non è installato nel dispositivo, l'impostazione predefinita per l'attributo Channel è Current. Se Office è installato nel dispositivo e l'attributo channel non è specificato, ODT corrisponde al canale dell'installazione esistente.

Questo valore determina il canale da installare, indipendentemente da un canale di aggiornamento specificato facoltativamente nell'elemento Aggiornamenti o tramite Criteri di gruppo Setting. Se è presente un'impostazione di questo tipo con un canale di aggiornamento diverso, il commutatore del canale viene eseguito dopo l'installazione durante il ciclo di aggiornamento successivo. Per altre informazioni, vedere Modificare il canale di aggiornamento Microsoft 365 Apps.

Per ulteriori informazioni sui canali di aggiornamento, vedere Panoramica dei canali di aggiornamento per App di Microsoft 365.

Valori consentiti:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="SemiAnnualPreview"
  • Channel="SemiAnnual"

Nota

  • Per usare questi valori di attributo, è necessario usare almeno la versione 16.0.12827.20268 dello Strumento di distribuzione di Office, rilasciata martedì 9 giugno 2020.
  • È comunque possibile usare i valori consentiti precedenti per ogni canale di aggiornamento, il che significa che non è necessario aggiornare i file XML di configurazione meno recenti.
  • Il canale beta (a volte denominato Insider Fast) non è una compilazione supportata, quindi deve essere usato solo negli ambienti di test e da un piccolo gruppo di utenti selezionati, ad esempio personale IT o sviluppatori di applicazioni.

Quando si distribuisce Office LTSC Professional Plus 2021 o Office LTSC Standard 2021, entrambe le versioni con contratti multilicenza usano il canale di aggiornamento PerpetualVL2021. Per altre informazioni, vedere Canale di aggiornamento per Office LTSC 2021.

Se si distribuisce Office Professional Plus 2019 o Office Standard 2019, ovvero versioni con contratti multilicenza di Office, è necessario usare un canale di aggiornamento diverso: PerpetualVL2019. Per altre informazioni, vedere Canale di aggiornamento per Office 2019.

Attributo DownloadPath (parte dell'elemento Add)

Facoltativo. Se non specificato, viene impostata per impostazione predefinita sulla rete CDN.

Definisce da dove vengono scaricati i file di installazione quando si esegue ODT in modalità di download. Usato in genere per distribuire lingue e prodotti specifici per Office da una posizione centralizzata della rete in un'altra posizione. È necessario specificare una versione quando si usa DownloadPath, come illustrato nell'esempio.

Valori di esempio:

  • DownloadPath="\\servera\share"

Esempio

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

Attributo AllowCdnFallback (parte dell'elemento Add)

Facoltativo. Se non specificato, il valore predefinito è False.

Per usare la rete CDN di Office come origine di backup per i Language Pack, includere l'attributo "AllowCdnFallback" nel file di configurazione, come illustrato nell'esempio.

Quando si installano le lingue, ODT cerca prima i file di origine nel percorso specificato nell'attributo SourcePath. Se il Language Pack non è disponibile in tale posizione e l'impostazione AllowCdnFallback è impostata su True, ODT usa i file di origine della rete CDN di Office.

Valori consentiti:

  • AllowCdnFallback="True"
  • AllowCdnFallback="False"

Esempio

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>  

Attributo MigrateArch (parte dell'elemento Add)

Facoltativo. Se non specificato, il valore predefinito è False.

Se impostato su TRUE, l'installazione esistente di Microsoft 365 Apps viene modificata nell'architettura (a volte definita bitness) specificata nell'attributo OfficeClientEdition. Ad esempio, è possibile usare questo attributo per modificare un'installazione a 32 bit di Microsoft 365 Apps in un'installazione a 64 bit.

Per altre informazioni sull'uso di MigrateArch, vedere Modificare un'installazione di Microsoft 365 Apps da 32 bit a 64 bit.

Attributo OfficeMgmtCOM (parte dell'elemento Add)

Facoltativo. Se non specificato, il valore predefinito è False.

Se impostato su True, viene registrato un oggetto COM necessario per consentire alle soluzioni di gestione degli aggiornamenti (ad esempio, Microsoft Configuration Manager) di gestire gli aggiornamenti di Office. Obbligatorio quando si usa Configuration Manager per gli aggiornamenti Microsoft 365 Apps. Quando l'oggetto COM di Office è abilitato, l'opzione Aggiorna ora nella pagina Account per Microsoft 365 Apps viene disabilitata automaticamente per i dispositivi client.

Per altre informazioni, vedere Gestire gli aggiornamenti per Microsoft 365 Apps con Microsoft Configuration Manager.

Valori consentiti:

  • OfficeMgmtCOM="True"
  • OfficeMgmtCOM="False"

Esempio

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" OfficeMgmtCOM="True" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>  
  <Updates Enabled="True"  /> 
</Configuration>

Elemento Product

Definisce i prodotti da scaricare o installare. Se si definiscono più prodotti, questi vengono installati nell'ordine nel file di configurazione. Il primo prodotto determina il contesto per l'esperienza First Run di Microsoft Office.

È anche possibile usare l'elemento Product per aggiungere Language Pack alle installazioni esistenti di Microsoft 365 Apps. Per altre informazioni, incluso un file di configurazione di esempio, vedere Distribuire le lingue nelle installazioni esistenti di Microsoft 365 Apps.

Esempio

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>
<Product ID="VisioProRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>

Attributo ID (parte dell'elemento Product)

Obbligatorio.

Definisce l'ID del prodotto da scaricare o installare.

Valori di esempio:

  • ID="O365ProPlusRetail"
  • ID="VisioProRetail"
  • ID="ProjectProRetail"

Per un elenco di tutti gli ID prodotto supportati, vedere ID prodotto supportati dallo Strumento di distribuzione di Office per la versione A portata di clic

Attributo MSICondition (parte dell'elemento Product)

Facoltativo.

Consente di controllare l'installazione di un prodotto Office, come specificato dall'attributo ID, in base al fatto che un determinato prodotto Office basato su MSI sia già installato nel dispositivo. Ad esempio, se nel dispositivo è già installata una versione basata su MSI di Project Professional, installare Project Online Desktop Client.

È possibile specificare qualsiasi prodotto Office installato da Windows Installer (MSI), ma MSICondition è più comunemente usato per le installazioni di Project o Visio. Il valore specificato per l'attributo MSICondition può essere una versione con contratto multicondizionato o al dettaglio del prodotto, purché tale versione del prodotto sia stata installata tramite MSI.

MSICondition riconosce le versioni 2007, 2010, 2013 e 2016 del prodotto Office specificato. Non è tuttavia possibile specificare una versione specifica. Ad esempio, non è possibile avere un aspetto MSICondition specifico per Visio Standard 2013. MSICondition cerca tutte le installazioni basate su MSI di Visio Standard, tra cui Visio Standard 2007, Visio Standard 2010, Visio Standard 2013 e Visio Standard 2016.

Il valore specificato per l'attributo MSICondition è l'ID di installazione trovato nel file Setup.xml in {product}. Cartella WW dei file di installazione per la versione esistente del prodotto Office. Ad esempio, il file Setup.xml per Visio Professional 2016 si trova nella cartella VisPro.WW. È possibile specificare più tipi di un prodotto Office, separati da una virgola. Ad esempio, è possibile specificare "PrjStd,PrjStdR,PrjPro,PrjProR" per cercare installazioni di Project Standard o Project Professional, con contratti multi-licenza o al dettaglio.

Nota

È consigliabile rimuovere i prodotti Office basati su MSI esistenti durante l'installazione dei prodotti specificati nel file XML. Per rimuovere i prodotti basati su MSI esistenti, usare l'elemento RemoveMSI.

È anche possibile watch un video su come usare MSICondition in combinazione con RemoveMSI per semplificare l'aggiornamento.

Esempio di attributo MSICondition

Nell'esempio seguente Project Online Desktop Client viene installato nel dispositivo solo se nel dispositivo è già installata una versione basata su MSI di Project Standard. Inoltre, Project Standard viene rimosso dal dispositivo come parte dell'installazione di Project Online Desktop Client.

<Configuration>
  <Add>
      <Product ID="ProjectProRetail" MSICondition="PrjStd,PrjStdR">
         <Language ID="en-us" />
         <Language ID="MatchPreviousMSI" />
      </Product>
  </Add>
  <RemoveMSI />
</Configuration>

Elemento Language

Definisce le lingue da scaricare o installare. Se si definiscono più lingue, la prima nel file di configurazione determina le impostazioni cultura dell'interfaccia utente di Shell, tra cui tasti di scelta rapida, menu di scelta rapida visualizzati facendo clic con il pulsante destro del mouse e descrizioni comandi. Se si decide di modificare la lingua dell'interfaccia utente shell dopo l'installazione iniziale, è necessario disinstallare e reinstallare Office.

Esempio

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>
<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
     <Language ID="MatchInstalled" />
     <Language ID="MatchOS" Fallback="en-us" />
  </Product>
</Add>  

Attributo ID (parte dell'elemento Language)

Obbligatorio.

Definisce l'ID della lingua da scaricare o installare.

Valori di esempio

  • ID="en-us"
  • ID="ja-jp"
  • ID="MatchOS"
  • ID="MatchPreviousMSI"
  • ID="MatchInstalled"

Assicurarsi che le lingue specificate supportano il prodotto che si sta installando. In caso contrario, l'installazione non riesce.

Ad esempio, Microsoft 365 Apps supporta l'inglese (Regno Unito), il francese (Canada) e lo spagnolo (Messico), ma Project e Visio non supportano tali lingue.

Per altre informazioni su MatchPreviousMSI, vedere Rimuovere le versioni msi esistenti di Office durante l'aggiornamento a Microsoft 365 Apps.

MatchOS e MatchInstalled non possono installare le lingue del sistema operativo se Office non supporta tale lingua o se ODT non riesce a trovare il Language Pack corretto nei file di origine locali. Per risolvere questo problema, è consigliabile specificare una lingua di backup e consentire all'ODT di usare la rete CDN di Office per i file mancanti. A tale scopo, usare l'attributo Fallback e l'attributo AllowCdnFallBack.

MatchInstalled può essere usato solo se è già installato almeno un prodotto a portata di clic. Non può essere usato con l'opzione /download per ODT. Per altre informazioni su MatchInstalled, vedere Panoramica della distribuzione dei linguaggi e Compilare pacchetti dinamici, snelli e universali per Microsoft 365 Apps.

Attributo Fallback (parte dell'elemento Language)

Facoltativo.

Quando si usa MatchOS, è consigliabile specificare una lingua di fallback da installare quando una lingua corrispondente non è supportata da Office. A tale scopo, usare l'attributo "Fallback". Per altre informazioni, vedere Installare le stesse lingue del sistema operativo.

Valori di esempio:

  • Fallback="en-us"
  • Fallback="ja-jp"

Attributo TargetProduct (parte dell'elemento Language)

Facoltativo.

Quando si usa MatchInstalled, è possibile specificare se si vuole corrispondere all'elenco delle lingue già installate per un prodotto specifico o alla combinazione di tutti i prodotti installati. Per specificare come destinazione un prodotto specifico, è possibile specificare qualsiasi ID prodotto supportato. Se si desidera trovare una corrispondenza con le lingue di tutti i prodotti già installati, specificare "Tutti". ODT installa quindi il nuovo prodotto con lo stesso set di lingue di quello specificato in TargetProduct.

Se non è specificato alcun oggetto TargetProduct con MatchInstalled, ODT tenta di corrispondere allo stesso ID prodotto a cui appartiene il tag Language nel file di configurazione. Ad esempio, se si usa MatchInstalled durante l'installazione di "VisioProRetail" senza TargetProduct, ODT tenta di corrispondere alle lingue già installate per questo prodotto.

Valori di esempio:

<Language ID="MatchInstalled" TargetProduct="O365ProPlusRetail" />
<Language ID="MatchInstalled" TargetProduct="All" />

Elemento Display

Definisce cosa viene visualizzato dall'utente quando viene installato Office.

Esempio

<Display Level="None" AcceptEULA="TRUE" />  

Attributo Level (parte dell'elemento Display)

Facoltativo. Se non specificato, il valore predefinito è Completo .

Se Level è impostato su Nessuno, Office viene installato senza interfaccia utente: non vengono visualizzate barre di stato, schermate di completamento, messaggi di errore o altre interfacce utente.

Se Level è impostato su Full, Office viene installato con l'esperienza di installazione normale.

Valori consentiti:

  • Level="None"
  • Level="Full"

Attributo AcceptEULA (parte dell'elemento Display)

Facoltativo. Il valore predefinito è FALSE se non è specificato.

Se AcceptEULA è impostato su TRUE, l'utente non visualizza una finestra di dialogo condizioni di licenza. Se questo attributo è impostato su FALSE o non è incluso, l'utente potrebbe visualizzare una finestra di dialogo condizioni di licenza. È consigliabile che gli amministratori impostino AcceptEULA su TRUE.

Valori consentiti:

  • AcceptEULA="TRUE"
  • AcceptEULA="FALSE"

Nota

Se si distribuisce una versione di Office prima della versione 1803, questa impostazione verrà applicata solo se si installa con l'account dell'utente. Microsoft Configuration Manager e altri strumenti di distribuzione software che usano l'account SYSTEM per l'installazione non applicano l'impostazione.

Elemento ExcludeApp

Definisce quali prodotti Microsoft 365 Apps non devono essere installati. OneDrive viene installato automaticamente con Microsoft 365 Apps o durante l'installazione di singole applicazioni come Word, Excel, PowerPoint, Publisher, Visio o Skype. Se non si vuole installare OneDrive con tali applicazioni, usare l'elemento ExcludeApp per rimuoverlo. Per altre informazioni, vedere Escludere OneDrive durante l'installazione di Microsoft 365 Apps o altre applicazioni.

Esempio

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise">
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
    <ExcludeApp ID="Publisher" />
  </Product>
</Add>  

Se si usa un file di configurazione con ExcludeApp per installare Office in un dispositivo in cui è già installato Microsoft 365 Apps, l'impostazione ExcludeApp viene gestita in modo diverso in base all'elenco delle lingue:

  • Se il file di configurazione elenca ogni lingua installata, sovrascrive tutte le impostazioni di ExcludeApp esistenti nel dispositivo. Questa regola si applica anche se il file elenca tutte le lingue installate più quelle nuove.
  • Se il file non elenca tutte le lingue installate, le impostazioni ExcludeApp dal file e dall'unione del dispositivo.

Attributo ID (parte dell'elemento ExcludeApp)

Obbligatorio.

Definisce l'ID del prodotto che non deve essere installato.

Valori consentiti:

  • ID="Access"
  • ID="Bing"
  • ID="Excel"
  • ID="Groove"
  • ID="Lync"
  • ID="OneDrive"
  • ID="OneNote"
  • ID="Outlook"
  • ID="PowerPoint"
  • ID="Publisher"
  • ID="Teams"
  • ID="Word"

Nota

Elemento Property

Definisce alcune proprietà e comportamenti di Office.

Esempio

<Property Name="FORCEAPPSHUTDOWN" Value="FALSE"/>
<Property Name="SharedComputerLicensing" Value="1"/>
<Property Name="SCLCacheOverride" Value="1" />
<Property Name="DeviceBasedLicensing" Value="1" />
<Property Name="SCLCacheOverrideDirectory" Value="\\server\share\%username%" />
<Property Name="PinIconsToTaskbar" Value="TRUE"/>

Attributo Name (parte dell'elemento Property)

Obbligatorio.

Definisce la proprietà specifica della quale si desidera impostare il valore.

Attributo Value (parte dell'elemento Property)

Definisce il valore della proprietà denominata.

Proprietà AUTOACTIVATE (parte dell'elemento Property)

Facoltativo. Il valore predefinito è 0 se non specificato.

Poiché Microsoft 365 Apps è impostato per l'attivazione automatica, non è consigliabile impostare questa proprietà per Microsoft 365 Apps prodotti. Per gli altri prodotti, è possibile impostare AUTOACTIVATE su 1 per attivare automaticamente il prodotto.

Valori consentiti:

  • Property Name="AUTOACTIVATE" Value="0"
  • Property Name="AUTOACTIVATE" Value="1"

Proprietà FORCEAPPSHUTDOWN (parte dell'elemento Property)

Facoltativo. Il valore predefinito è FALSE se non è specificato.

Se impostato su TRUE, forza l'arresto di tutte le app che bloccano l'installazione di Office. Potrebbe verificarsi una perdita di dati.

Valori consentiti:

  • Property Name="FORCEAPPSHUTDOWN" Value="FALSE"
  • Property Name="FORCEAPPSHUTDOWN" Value="TRUE"

Proprietà PACKAGEGUID (parte dell'elemento Property)

Facoltativo.

Per impostazione predefinita, i pacchetti App-V creati da ODT condividono lo stesso ID pacchetto App-V. Gli amministratori possono utilizzare PACKAGEGUID per specificare un ID pacchetto diverso. In questo modo è possibile pubblicare più pacchetti App-V di Office in un server di gestione App-V. Tuttavia, non consente di distribuire più pacchetti di App-V di Office in un singolo computer. È possibile usare ODT per creare pacchetti App-V per Microsoft 365 Apps. La creazione di pacchetti per le versioni con contratti multi-licenza di Office Professional Plus o Office Standard non è supportata.

L'ID pacchetto deve avere il formato indicato nell'esempio e può contenere solo i caratteri seguenti: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F

Se si usano caratteri diversi, il pacchetto App-V viene creato con l'ID pacchetto predefinito.

Valori di esempio:

  • Property Name="PACKAGEGUID" Value="12345678-ABCD-1234-ABCD-1234567890AB"

Proprietà SharedComputerLicensing (parte dell'elemento Property)

Facoltativo. Il valore predefinito è 0 se non specificato.

Impostare SharedComputerLicensing su 1 se si distribuisce Microsoft 365 Apps nei computer condivisi usando Servizi Desktop remoto.

Per altre informazioni, vedere Panoramica dell'attivazione condivisa del computer per Microsoft 365 Apps.

Valori consentiti:

  • Property Name="SharedComputerLicensing" Value="0"
  • Property Name="SharedComputerLicensing" Value="1"

Proprietà SCLCacheOverride (parte dell'elemento Property)

Facoltativo. Il valore predefinito è 0 se non specificato.

Impostare SCLCacheOverride su 1 se si usa l'attivazione del computer condiviso e si vuole eseguire il roaming del token di licenza. Utilizzare questa proprietà con SCLCacheOverrideDirectory. Questa proprietà è necessaria solo se si sceglie di spostare il token di licenza dal percorso predefinito. Per altre informazioni, vedere Panoramica dell'attivazione condivisa del computer per Microsoft 365 Apps.

Valori consentiti:

  • Property Name="SCLCacheOverride" Value="0"
  • Property Name="SCLCacheOverride" Value="1"

Proprietà SCLCacheOverrideDirectory (parte dell'elemento Property)

Facoltativo.

Impostare SCLCacheOverrideDirectory per specificare un percorso di cartella per il token di licenza se si usa l'attivazione del computer condiviso e si vuole eseguire il roaming del token di licenza. Utilizzare la proprietà con SCLCacheOverride. Questa proprietà è necessaria solo se si sceglie di spostare il token di licenza dal percorso predefinito.

Per altre informazioni, vedere Panoramica dell'attivazione condivisa del computer per Microsoft 365 Apps.

Valori di esempio:

  • Property Name="SCLCacheOverrideDirectory" Value="%appdata%\Microsoft"
  • Property Name="SCLCacheOverrideDirectory" Value="\\server\share\%username%"

Proprietà DeviceBasedLicensing (parte dell'elemento Property)

Facoltativo. Il valore predefinito è 0 se non specificato.

Definisce la modalità di licenza di Office per l'attivazione basata su dispositivo. Per altre informazioni, vedere Licenze basate su dispositivi per Microsoft 365 Apps for enterprise.

Valori consentiti:

  • Property Name="DeviceBasedLicensing" Value="1"
  • Property Name="DeviceBasedLicensing" Value="0"

Proprietà PinIconsToTaskBar (parte dell'elemento Property)

Facoltativo. Il valore predefinito è True se non specificato.

Definisce se le icone di collegamento per i prodotti Office vengono aggiunte alla barra delle applicazioni di Windows in Windows 7 e Windows 8.1. Se si installa Office usando un account di sistema, che è comune durante la distribuzione con Microsoft Configuration Manager, le icone non vengono aggiunte anche se questa proprietà è impostata su True.

Valori consentiti:

  • Property Name="PinIconsToTaskbar" Value="FALSE"
  • Property Name="PinIconsToTaskbar" Value="TRUE"

Nota

Elemento Remove

Definisce i prodotti e le lingue da rimuovere da un'installazione precedente di Microsoft 365 Apps. Per rimuovere una lingua installata, è necessario specificare sia il prodotto che la lingua, come nell'esempio. Per rimuovere tutte le lingue installate, non includere l'attributo language. In tal caso, ODT individua e rimuove automaticamente tutte le lingue installate per il prodotto.

Per altre informazioni, vedere Panoramica dello strumento di distribuzione di Office.

Esempio

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

Attributo All (parte dell'elemento Remove)

Facoltativo. Il valore predefinito è FALSE se non specificato.

Se impostato su TRUE, tutti i prodotti e le lingue Microsoft 365 Apps vengono rimossi, inclusi Project e Visio.

Valori consentiti:

  • All="FALSE"
  • All="TRUE"

Elemento Updates

Definisce la modalità di aggiornamento di Office dopo l'installazione.

Esempio

<Updates Enabled="TRUE" 
         UpdatePath="\\Server\Share\"
         Channel="SemiAnnual" />

Attributo Enabled (parte dell'elemento Updates)

Facoltativo. Il valore predefinito è TRUE se non specificato.

Se impostato su TRUE, Office verifica la disponibilità di aggiornamenti. Se impostato su FALSE, Office non controlla la disponibilità di aggiornamenti, ma l'utente può verificare la disponibilità di aggiornamenti passando aOpzioni> di aggiornamentodell'account>file>Aggiorna ora.

Valori consentiti:

  • Enabled="TRUE"
  • Enabled="FALSE"

Attributo UpdatePath (parte dell'elemento Updates)

Facoltativo. Se non specificato, viene impostata per impostazione predefinita sulla rete CDN.

Definisce la provenienza degli aggiornamenti per Office. UpdatePath possibile specificare una rete locale o percorso HTTP di un'origine i file di installazione Office. Variabili di ambiente possono essere utilizzate in rete o percorsi locali.

Se si usa Criteri di gruppo con i file del modello amministrativo (ADMX/ADML) per Office, è possibile impostare UpdatePath usando l'impostazione dei criteri Percorso aggiornamento. Quest'ultima è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.

Valori di esempio:

  • UpdatePath="\\server\share"
  • UpdatePath="C:\Preload\Office"
  • UpdatePath="http://internalApps/Office/"

Attributo TargetVersion (parte dell'elemento Updates)

Facoltativo. Il valore predefinito è la versione più recente del percorso di aggiornamento specificato.

Definisce a quale versione aggiornare Office. Se TargetVersion è impostato su un numero di build specifico, Office tenta di eseguire l'aggiornamento a tale versione.

Se si usa Criteri di gruppo con i file del modello amministrativo (ADMX/ADML) per Office, è possibile impostare TargetVersion usando l'impostazione dei criteri Versione di destinazione. Quest'ultima è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.

Valori di esempio:

  • TargetVersion="16.0.12345.12345"
  • TargetVersion=""

Attributo Deadline (parte dell'elemento Updates)

Facoltativo.

Definisce una data scadenza entro la quale devono essere applicati gli aggiornamenti. La data di scadenza viene specificata in formato Coordinated Universal Time (UTC). È possibile usare Deadline con Target Version per assicurarsi che Office venga aggiornato a una determinata versione in base alla data specificata. È consigliabile impostare la scadenza dopo almeno una settimana per fornire agli utenti il tempo di installare gli aggiornamenti.

Prima della scadenza, gli utenti ricevono più promemoria per installare gli aggiornamenti. Se non è aggiornato Office entro la data di scadenza, gli utenti vedono una notifica che gli aggiornamenti vengono applicati in 15 minuti. Questa notifica offre agli utenti l'opportunità di salvare i documenti di Office su cui stanno lavorando e di chiudere eventuali programmi di Office aperti. Se gli utenti non chiudere le applicazioni di Office, chiudere automaticamente i programmi, si è 15 minuti, che può comportare la perdita di dati.

Dopo la chiusura di programmi Office, gli aggiornamenti vengono applicati automaticamente. La scadenza si applica solo a uno specifico set di aggiornamenti. Se si vuole usare una scadenza per assicurarsi che Office sia sempre aggiornato, è necessario modificare la scadenza ogni volta che è disponibile un nuovo aggiornamento per Office.

Per usare questo attributo, Office deve eseguire almeno Service Pack 1 (versione 15.0.4569.1507). Se si usa Criteri di gruppo con i file del modello amministrativo (ADMX/ADML) per Office, è possibile impostare Scadenza usando l'impostazione dei criteri Scadenza aggiornamento. Quest'ultima è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.

Valore di esempio:

  • Deadline="05/16/2014 18:30"

Attributo Channel (parte dell'elemento Updates)

Facoltativo. Il valore predefinito è Current.

Specifica il canale di aggiornamento per Office dopo l'installazione. Esistono due attributi di canale: il canale per l'elemento Add viene usato per specificare un canale di aggiornamento durante l'installazione di Office e il canale per l'elemento Aggiornamenti viene usato per modificare il canale per un'installazione esistente di Office.

Per ulteriori informazioni sui canali di aggiornamento, vedere Panoramica dei canali di aggiornamento per App di Microsoft 365.

Se si usa Criteri di gruppo con i file del modello amministrativo (ADMX/ADML) per Office, è possibile impostare Channel usando l'impostazione dei criteri Del canale di aggiornamento. Quest'ultima è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti. Se abilitata, questa impostazione di Criteri di gruppo ha la precedenza rispetto al valore di Channel impostato con lo Strumento di distribuzione di Office.

Valori consentiti:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="SemiAnnualPreview"
  • Channel="SemiAnnual"

Nota

  • Per usare questi valori di attributo, è necessario usare almeno la versione 16.0.12827.20268 dello Strumento di distribuzione di Office, rilasciata martedì 9 giugno 2020.
  • È comunque possibile usare i valori consentiti precedenti per ogni canale di aggiornamento, il che significa che non è necessario aggiornare i file XML di configurazione meno recenti.
  • Il canale beta (a volte denominato Insider Fast) non è una compilazione supportata, quindi deve essere usato solo negli ambienti di test e da un piccolo gruppo di utenti selezionati, ad esempio personale IT o sviluppatori di applicazioni.

Quando si distribuisce Office LTSC Professional Plus 2021 o Office LTSC Standard 2021, entrambe le versioni con contratti multilicenza usano il canale di aggiornamento PerpetualVL2021. Per altre informazioni, vedere Canale di aggiornamento per Office LTSC 2021.

Se si distribuisce Office Professional Plus 2019 o Office Standard 2019, ovvero versioni con contratti multilicenza di Office, è necessario usare un canale di aggiornamento diverso: PerpetualVL2019. Per altre informazioni, vedere Canale di aggiornamento per Office 2019.

Elemento RemoveMSI

Facoltativo.

Specifica se le versioni 2007, 2010, 2013 o 2016 di Office, Visio e Project installate con Windows Installer (MSI) vengono disinstallate dal computer prima dell'installazione del prodotto specificato, ad esempio Microsoft 365 Apps.

È consigliabile disinstallare le versioni precedenti di Office prima di installare Microsoft 365 Apps. Per altre informazioni sull'uso di RemoveMSI, vedere Rimuovere le versioni msi esistenti di Office durante l'aggiornamento a Microsoft 365 Apps.

Attributo IgnoreProduct (parte dell'elemento RemoveMSI)

Facoltativo.

Se viene specificato un ID, il prodotto Windows Installer (MSI) non viene disinstallato dal computer.

Valori di esempio:

  • IgnoreProduct ID="VisPro"
  • IgnoreProduct ID="PrjPro"

Elemento AppSettings

Facoltativo.

Definisce le preferenze dell'applicazione per Microsoft 365 Apps, incluse le notifiche macro VBA, i percorsi dei file predefiniti e il formato di file predefinito. Per creare un file di configurazione con le preferenze dell'applicazione, è consigliabile usare il Strumento di personalizzazione di Office per A portata di clic, un'applicazione Web con un'interfaccia utente completa. È anche possibile usare lo strumento per altre informazioni sulle preferenze dell'applicazione disponibili.

Per altre informazioni sulle preferenze dell'applicazione, vedere Applicare le preferenze dell'applicazione e Applicare le preferenze dell'applicazione a un'installazione esistente di Office.

Esempio

  <AppSettings>
    <User Key="software\microsoft\office\16.0\excel\security"
          Name="vbawarnings" 
          Value="3" 
          Type="REG_DWORD" 
          App="excel16" 
          Id="L_VBAWarningsPolicy" />
  </AppSettings>