Opzioni di configurazione per lo Strumento di distribuzione di Office

Usare lo Strumento di distribuzione di Office (ODT) per scaricare e distribuire Microsoft 365 Apps nei computer client. Lo strumento ODT offre un maggiore controllo sull'installazione, consentendo di definire quali prodotti e lingue installare, come aggiornarli e se visualizzare l'esperienza di installazione agli utenti. Questo articolo mostra tutte le opzioni disponibili nello strumento. Per informazioni su come usare lo strumento, vedere Panoramica dello strumento di distribuzione di Office.

Nota

Procedura consigliata: Le opzioni in questo articolo mostrano gli elementi e gli attributi XML 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, è possibile modificare il file di configurazione per scaricare l'edizione inglese a 64 bit di Microsoft 365 Apps oppure installare l'edizione inglese a 64 bit di Microsoft 365 Apps con il Contratto di licenza con l'utente finale (EULA) accettato automaticamente e senza Editore.

Quando si crea il file di configurazione, è consigliabile partire da un file di esempio e aggiornarlo con le opzioni appropriate per l'ambiente. Per iniziare, copiare e incollare l'esempio seguente in un file di testo e salvarlo con un nome a scelta. Utilizzare il file per modificare gli elementi e gli attributi XML e utilizzare il resto di questo articolo per ottenere ulteriori dettagli su ogni elemento e attributo.

Questo file di configurazione include gli elementi e gli attributi più comunemente usati e può essere usato per scaricare e installare Microsoft 365 Apps 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 con i file di installazione disponibili in tale posizione.
Aggiungere OfficeClientEdition="64"
Download e installazione dell'edizione a 64 bit di Office
Add Channel="MonthlyEnterprise"
Office viene installato tramite il Canale Enterprise mensile.
Product ID="O365ProPlusRetail"
Download e installazione di 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.

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 Microsoft 365 Apps. Se lo strumento ODT viene eseguito in modalità di download, definisce la posizione in cui salvare i file. Se non è incluso, lo strumento ODT cerca i file di installazione nella stessa cartella dello strumento e usa quindi la rete per la distribuzione di contenuti (CDN). Se non è incluso e lo strumento ODT viene eseguito in modalità download, i file di installazione di Microsoft 365 Apps vengono scaricati nella stessa cartella dello strumento.

Quando si scarica Microsoft 365 Apps in una cartella che contiene già quella versione di Microsoft 365 Apps, lo ODT conserva la larghezza di banda di rete scaricando solo i file mancanti. Ad esempio, se si usa lo strumento ODT per scaricare Microsoft 365 Apps in inglese e tedesco in una cartella che contiene già Microsoft 365 Apps in inglese, verrà scaricato solo il Language Pack tedesco.

Valori di esempio:

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

Il valore SourcePath non deve includere la parte /Office o il nome della cartella in cui vengono scaricati i dati di Office.

Attributo versione (parte dell'elemento Add)

Facoltativo. Il valore predefinito è la versione più recente disponibile se non specificato.

Quando si utilizza 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, anche se è disponibile una versione più recente. Questa impostazione può semplificare l'aggiunta di Language Pack o di Visio e Project senza eseguire l'aggiornamento a una versione più recente. Quando si usa Version="MatchInstalled", l'attributo Channel è obbligatorio.

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 Microsoft 365 Apps non è installato nel dispositivo e OfficeClientEdition non è impostato, lo strumento ODT seleziona automaticamente l'edizione a 64 bit. Seleziona tuttavia l'edizione a 32 bit se il dispositivo usa una versione a 32 bit di Windows o ha meno di 4 GB di RAM. Se Microsoft 365 Apps è installato e OfficeClientEdition non viene specificato, lo strumento ODT corrisponde all'architettura dell'installazione esistente di Microsoft 365 Apps. Se Microsoft 365 Apps è installato ed è specificato OfficeClientEdition, allora deve corrispondere all'architettura già installata. In caso contrario, l'installazione non riesce, perché le architetture miste non sono supportate.

Valori consentiti:

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

Nota

I dispositivi basati su ARM richiedono Windows 11 o versione successiva per eseguire Microsoft 365 Apps. La versione a 32 bit di Microsoft 365 Apps non è supportata in questi dispositivi. Quando installi la versione a 64 bit in un dispositivo basato su Arm, include automaticamente i componenti ottimizzati per Arm, migliorando le prestazioni e garantendo la compatibilità con l'architettura Arm.

Attributo del canale (parte dell'elemento Add)

Facoltativo.

Definisce il canale da usare per installare Microsoft 365 Apps. Se Microsoft 365 Apps non è installato nel dispositivo, l'impostazione predefinita per l'attributo Channel è Corrente. Se Microsoft 365 Apps è installato nel dispositivo e l'attributo di canale non è specificato, lo strumento 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 l'impostazione dei Criteri di gruppo. Se esiste un'impostazione di questo tipo con un canale di aggiornamento diverso, il cambio di canale viene eseguito dopo l'installazione durante il ciclo di aggiornamento successivo. Per altre informazioni, vedere Modificare il canale di aggiornamento di 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="semestrale"

Nota

  • È possibile continuare a usare i valori consentiti in precedenza per ogni canale di aggiornamento, il che significa che non è necessario aggiornare i file XML di configurazione precedenti.
  • Il canale Beta (talvolta indicato come Insider Fast) non è una build supportata, quindi dovrebbe essere usato solo in ambienti di test e da un piccolo gruppo di utenti selezionati, come il personale IT o gli sviluppatori di applicazioni.

Se si distribuisce Microsoft Office Long Term Servicing Channel (LTSC) Professional Plus 2024 o Office LTSC Standard 2024, che sono versioni con contratto multilicenza, è necessario usare un canale di aggiornamento diverso: PerpetualVL2024. Per altre informazioni, vedere Canale di aggiornamento per Office LTSC 2024.

Se si distribuisce Microsoft Office Long Term Servicing Channel (LTSC) Professional Plus 2021 o Office LTSC Standard 2021, che sono versioni con contratto multilicenza, è necessario usare un canale di aggiornamento diverso: PerpetualVL2021. Per ulteriori informazioni, consultare il Canale di aggiornamento per Office LTSC 2021.

Se si distribuisce Office Professional Plus 2019 o Office Standard 2019, che sono versioni con contratto multilicenza, è necessario usare un canale di aggiornamento diverso: PerpetualVL2019. Per ulteriori informazioni, consulta il Canale di aggiornamento per Office 2019.

Attributo DownloadPath (parte dell'elemento Add)

Facoltativo. Il valore predefinito è CDN, se non specificato.

Nota

La connettività di rete è necessaria quando si esegue ODT in modalità download, anche se il download verrà eseguito dal percorso specificato con DownloadPath.

Definisce la posizione da cui vengono scaricati i file di installazione quando si esegue ODT in modalità di download. Più comunemente usato per distribuire lingue e prodotti specifici per Microsoft 365 Apps da una posizione centrale nella rete a un'altra posizione. Quando si usa DownloadPath, è necessario specificare una versione, 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. Il valore predefinito è False se non specificato.

Per utilizzare la rete CDN 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, lo strumento ODT cerca prima i file di origine nella posizione specificata nell'attributo SourcePath. Se il Language Pack non è disponibile in quella posizione e l'impostazione AllowCdnFallback è impostata su True, lo strumento ODT userà i file di origine della rete CDN.

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. Il valore predefinito è False se non specificato.

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

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

Attributo OfficeMgmtCOM (parte dell'elemento Add)

Facoltativo. Il valore predefinito è False se non specificato.

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. Obbligatorio quando si usa Gestione configurazione per gli aggiornamenti di Microsoft 365 Apps. Quando l'oggetto COM di Office è abilitato, l'opzione Aggiorna adesso nella pagina Account di Microsoft 365 Apps viene disabilitata automaticamente per i dispositivi client.

Per altre informazioni, vedere Gestire gli aggiornamenti di 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 di Office, come specificato dall'attributo ID, a seconda che un prodotto di Office basato su MSI sia già installato o meno nel dispositivo. Ad esempio, se nel dispositivo è già installata una versione basata su MSI di Project Professional, installare il client desktop di Microsoft Project.

È possibile specificare qualsiasi prodotto di 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 multilicenza o una versione definitiva del prodotto, purché tale versione del prodotto sia stata installata con MSI.

MSICondition riconosce le versioni 2007, 2010, 2013 e 2016 del prodotto Office specificato. Ma non è possibile specificare una versione particolare. Ad esempio, non è possibile fare in modo che MSICondition cerchi specificamente 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 che si trova nel file Setup.xml in {product}. 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 le installazioni di Project Standard o Project Professional, con contratto multilicenza o con licenza.

Nota

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

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

Esempio di attributo MSICondition

Nell'esempio seguente, Project 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.

<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 vuole cambiare la lingua dell'interfaccia utente della shell dopo la prima installazione, è necessario disinstallare e reinstallare Microsoft 365 Apps.

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 supportino il prodotto che si sta installando. In caso contrario, l'installazione non riesce.

Ad esempio, Microsoft 365 Apps supporta inglese (Regno Unito), francese (Canada) e spagnolo (Messico), ma Project e Visio non supportano queste 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 Microsoft 365 Apps non supporta tale lingua o se lo strumento ODT non riesce a trovare il Language Pack corretto nei file di origine locali. Per risolvere il problema, è consigliabile specificare una lingua di backup e consentire allo strumento ODT di usare la rete CDN per i file mancanti. A tale scopo, usare gli attributi Fallback e AllowCdnFallBack.

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

Attributo Fallback (parte dell'elemento Language)

Facoltativo.

Quando si usa MatchOS, specificare una lingua di fallback da installare se la lingua corrispondente non è supportata da Microsoft 365 Apps o non è disponibile nei file di origine locali. A tale scopo, utilizza l'attributo "Fallback". Per ulteriori 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 usi MatchInstalled, puoi specificare se vuoi abbinare l'elenco delle lingue già installate per un prodotto specifico o la combinazione di tutti i prodotti installati. Per assegnare un prodotto specifico, è possibile specificare qualsiasi ID prodotto supportato. Se si desidera la 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 con MatchInstalled non viene specificato alcun TargetProduct, lo strumento ODT tenta di trovare la corrispondenza con lo 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 far corrispondere le lingue già installate per questo prodotto.

Valori di esempio:

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

Elemento Display

Definisce ciò che l'utente vede quando viene installato Microsoft 365 Apps.

Esempio

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

Attributo Level (parte dell'elemento Display)

Facoltativo. Il valore predefinito è impostato su Completo se non specificato.

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

Se il livello è impostato su Completo, Microsoft 365 Apps 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 vede la finestra di dialogo Condizioni di licenza software Microsoft. Se questo attributo è impostato su FALSE o non è incluso, l'utente potrebbe vedere una finestra di dialogo Condizioni di licenza software Microsoft. È consigliabile che gli amministratori impostino AcceptEULA su TRUE.

Valori consentiti:

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

Elemento ExcludeApp

Definisce quali prodotti di Microsoft 365 Apps non devono essere installati. OneDrive viene installato automaticamente con Microsoft 365 Apps o con singole applicazioni come Word, Excel, PowerPoint, Publisher, Visio o Skype. Se non si vuole installare OneDrive con queste applicazioni, usare l'elemento ExcludeApp per rimuoverlo. Per altre informazioni, vedere Escludere OneDrive durante l'installazione di Microsoft 365 Apps o di 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 un file di configurazione con ExcludeApp viene usato per installare Office in un dispositivo in cui è già installato Microsoft 365 Apps, l'impostazione ExcludeApp viene trattata in modo diverso in base all'elenco di lingue:

  • Se nel file di configurazione sono elencate tutte le lingue già installate nel dispositivo, l'impostazione ExcludeApp sostituisce le impostazioni ExcludeApp precedenti. Questo vale anche se l'elenco delle lingue del file include sia le lingue installate che le lingue aggiuntive.
  • Se l'elenco delle lingue nel file di configurazione non include tutte le lingue installate, l'impostazione ExcludeApp nel file di configurazione viene combinata con l'impostazione ExcludeApp nel dispositivo.

Attributo ID (parte dell'elemento ExcludeApp)

Obbligatorio.

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

Valori consentiti:

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

Nota

Elemento Property

Definisce determinati comportamenti e proprietà di Microsoft 365 Apps.

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"/>
<Property Name="TenantAssociationKey" Value="TAK" />

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 i prodotti di Microsoft 365 Apps. 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 Microsoft 365 Apps. 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 dallo strumento ODT condividono lo stesso ID pacchetto App-V. Gli amministratori possono utilizzare PACKAGEGUID per specificare un ID pacchetto diverso. Consente di pubblicare più pacchetti App-V di Microsoft 365 Apps in un server di gestione App-V. Tuttavia, non consente di distribuire più di un pacchetto di Microsoft 365 Apps App-V in un singolo computer. È possibile usare lo strumento ODT per creare pacchetti App-V per Microsoft 365 Apps. La creazione di pacchetti per le versioni con contratto multilicenza 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 in computer condivisi tramite Servizi Desktop remoto.

Per ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi 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.

Imposta SCLCacheOverride su 1 se usi l'attivazione di un computer condiviso e vuoi effettuare 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 ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi 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 di un computer condiviso e si vuole effettuare il roaming del token di licenza. Usare la proprietà con SCLCacheOverride. Questa proprietà è necessaria solo se si sceglie di spostare il token di licenza dal percorso predefinito.

Per ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi 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 gestione delle licenze di Office per l'attivazione basata su dispositivo. Per altre informazioni, vedere Licenze basate su dispositivo 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 scelta rapida per i prodotti Microsoft 365 Apps vengono aggiunte alla barra delle applicazioni di Windows in Windows 7 e Windows 8.1. Se si installa Microsoft 365 Apps con un account di sistema, come avviene spesso 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

Proprietà TenantAssociationKey (parte dell'elemento Property)

Nota

Disponibile nella versione 16.0.19929.20062 o successiva dello Strumento di distribuzione di Office.

Facoltativo.

Definisce la chiave specifica del tenant che associa un dispositivo all'organizzazione in Inventario nell'interfaccia di amministrazione di Microsoft 365 Apps. La chiave di associazione del tenant è un valore alfanumerico, in genere più lungo di 300 caratteri, che è possibile trovare nell'interfaccia di amministrazione di Microsoft 365 Apps accedendo e selezionando Configura dal riquadro di spostamento sinistro. Quando si include questo valore nel codice XML, lo strumento di distribuzione di Office registrerà automaticamente i dispositivi connessi nell'inventario.

Valori di esempio:

  • Property Name="TenantAssociationKey" Value="ReplaceWithTAK"

Esempio

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="MatchOS" />
    </Product>
  </Add>  
  <Property Name="TenantAssociationKey" Value="ReplaceWithTAK" />
</Configuration>

Esempio

<Configuration>
  <Property Name="TenantAssociationKey" Value="ReplaceWithTAK" />
</Configuration>

Elemento Remove

Definisce quali prodotti e lingue 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 questo caso, lo strumento ODT individua e rimuove automaticamente tutte le lingue installate per il prodotto.

Per ulteriori 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 di Microsoft 365 Apps vengono rimossi, inclusi Project e Visio.

Valori consentiti:

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

Elemento Updates

Definisce il modo in cui Microsoft 365 Apps viene aggiornato 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, Microsoft 365 Apps verifica la disponibilità di aggiornamenti. Se impostato su FALSE, Microsoft 365 Apps non verifica la disponibilità di aggiornamenti, ma l'utente può verificare la disponibilità di aggiornamenti andando a Opzioni diaggiornamento>dell'account>file>Aggiorna adesso.

Valori consentiti:

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

Attributo UpdatePath (parte dell'elemento Updates)

Facoltativo. Il valore predefinito è CDN, se non specificato.

Definisce da dove provengono gli aggiornamenti per Microsoft 365 Apps. UpdatePath può specificare un percorso di rete, locale o HTTP di un'origine per i file di installazione. Variabili di ambiente possono essere utilizzate in rete o percorsi locali.

Se si usano i criteri di gruppo con i file modello amministrativi (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. Per impostazione predefinita viene usata la versione più recente dal percorso di aggiornamento specificato.

Definisce la versione a cui viene aggiornato Microsoft 365 Apps. Se TargetVersion è impostato su un numero di build specifico, Microsoft 365 Apps tenta di eseguire l'aggiornamento a tale versione.

Se usi i criteri di gruppo con i file modello amministrativo (ADMX/ADML) per Office, puoi 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 è specificata in Coordinated Universal Time (UTC). È possibile usare Scadenza con la versione di destinazione per assicurarsi che Microsoft 365 Apps sia aggiornato a una determinata versione entro una determinata data. È 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 l'installazione degli aggiornamenti. Se Microsoft 365 Apps non viene aggiornato entro la scadenza, gli utenti visualizzano una notifica che indica che gli aggiornamenti verranno applicati entro 15 minuti. Questa notifica offre agli utenti l'opportunità di salvare i documenti su cui stanno lavorando e di chiudere le applicazioni di Microsoft 365 aperte. Se gli utenti non chiudono le applicazioni Microsoft 365, queste vengono chiuse automaticamente allo scadere dei 15 minuti, con conseguente perdita di dati.

Dopo la chiusura di Microsoft 365 Apps, 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 Microsoft 365 Apps sia sempre aggiornato, è necessario modificare la scadenza ogni volta che è disponibile un nuovo aggiornamento.

Per usare questo attributo, Office deve eseguire almeno Service Pack 1 (versione 15.0.4569.1507). Se si usano i criteri di gruppo con i file modello amministrativi (ADMX/ADML) per Office, è possibile impostare la scadenza usando l'impostazione del criterio Aggiorna scadenza. 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 è Corrente.

Definisce il canale da usare per aggiornare Microsoft 365 Apps dopo l'installazione. Sono disponibili due attributi di canale: il canale per l'elemento Add viene usato per specificare un canale di aggiornamento durante l'installazione di Microsoft 365 Apps e il canale per l'elemento Aggiornamenti viene usato per cambiare il canale per un'installazione esistente di Microsoft 365 Apps.

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

Se si usano i criteri di gruppo con i file modello amministrativo (ADMX/ADML) per Office, è possibile impostare il canale usando l'impostazione dei criteri Aggiorna canale. 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="semestrale"

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.
  • È possibile continuare a usare i valori consentiti in precedenza per ogni canale di aggiornamento, il che significa che non è necessario aggiornare i file XML di configurazione precedenti.
  • Il canale Beta (talvolta indicato come Insider Fast) non è una build supportata, quindi dovrebbe essere usato solo in ambienti di test e da un piccolo gruppo di utenti selezionati, come il personale IT o gli sviluppatori di applicazioni.

Se si distribuisce Office LTSC Professional Plus 2024 o Office LTSC Standard 2024, che sono versioni con contratto multilicenza, è necessario usare questo canale di aggiornamento: PerpetualVL2024. Per altre informazioni, vedere Canale di aggiornamento per Office LTSC 2024.

Se si distribuisce Office LTSC Professional Plus 2021 o Office LTSC Standard 2021, che sono versioni con contratto multilicenza, è necessario usare questo canale di aggiornamento: PerpetualVL2021. Per ulteriori informazioni, consultare il Canale di aggiornamento per Office LTSC 2021.

Se si distribuisce Office Professional Plus 2019 o Office Standard 2019, che sono versioni con contratto multilicenza di Office, è necessario usare un canale di aggiornamento diverso: PerpetualVL2019. Per ulteriori informazioni, consulta il Canale di aggiornamento per Office 2019.

Elemento RemoveMSI

Facoltativo.

Specifica se le versioni 2007, 2010, 2013 o 2016 di Office, Visio e Project installate tramite 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 delle 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 lo Strumento di personalizzazione di Office per A portata di clic, un'applicazione Web con un'interfaccia utente completa. È inoltre possibile utilizzare lo strumento per ulteriori 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>
  • Last updated on