Condividi tramite

Opzioni di configurazione per lo Strumento di distribuzione di Office

  • Articolo

Usare Office Deployment Tool (ODT) per scaricare e distribuire Microsoft 365 Apps nei computer client. 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 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, è possibile modificare il file di configurazione per scaricare l'edizione inglese a 64 bit di Microsoft 365 Apps oppure modificare il file per installare l'edizione inglese a 64 bit di Microsoft 365 Apps con il contratto di licenza dell'utente finale accettato automaticamente e senza Publisher.

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ù 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 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.

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 Microsoft 365 Apps. Se lo strumento ODT viene eseguito in modalità di download, definisce la posizione in cui salvare i file. Se non è incluso, ODT cerca i file di installazione nella stessa cartella dello strumento e quindi usa la rete cdn (Content Delivery Network). Se non è incluso e l'ODT viene eseguito in modalità di download, i file di installazione 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, ODT consente di risparmiare larghezza di banda di rete scaricando solo i file mancanti. Ad esempio, se si usa ODT per scaricare Microsoft 365 Apps in inglese e tedesco in una cartella che contiene già Microsoft 365 Apps in inglese, viene 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. 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, anche se è disponibile una versione più recente. Questa impostazione può semplificare l'aggiunta di Language Pack o Visio e Project senza eseguire l'aggiornamento 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 Microsoft 365 Apps non è installato nel dispositivo e OfficeClientEdition non è impostato, ODT seleziona automaticamente l'edizione a 64 bit. Tuttavia, seleziona 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 è specificato, ODT corrisponde all'architettura dell'installazione esistente di Microsoft 365 Apps. Se Microsoft 365 Apps è 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"

Nota

I dispositivi basati su Arm richiedono Windows 11 o versioni successive per eseguire Microsoft 365 Apps. La versione a 32 bit di Microsoft 365 Apps non è supportata in questi dispositivi. Quando si installa 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 l'installazione di Microsoft 365 Apps. Se Microsoft 365 Apps non è installato nel dispositivo, l'impostazione predefinita per l'attributo Channel è Current. Se Microsoft 365 Apps è 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

  • È 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.

Se si distribuisce Microsoft Office Long Term Servicing Channel (LTSC) Professional Plus 2021 o Office LTSC Standard 2021, ovvero versioni con contratti 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, ovvero versioni con contratti 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. Se non specificato, viene impostata per impostazione predefinita sulla rete CDN.

Nota

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

Definisce da dove 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. È 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 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 innanzitutto 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.

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 che è necessario per consentire alle soluzioni di gestione degli aggiornamenti (ad esempio, Microsoft Configuration Manager) di gestire gli aggiornamenti. 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 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 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 vuole modificare la lingua dell'interfaccia utente shell dopo la prima installazione, è necessario disinstallare e quindi 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 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 Microsoft 365 Apps 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 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, 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, 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 ciò che l'utente vede quando viene installato Microsoft 365 Apps.

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, 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 Level è impostato su Full, Microsoft 365 Apps viene installato con la normale esperienza di installazione.

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 software Microsoft. Se questo attributo è impostato su FALSE o non è incluso, l'utente potrebbe visualizzare 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 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 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 tutte le lingue già installate nel dispositivo, l'impostazione ExcludeApp sostituisce tutte le impostazioni di ExcludeApp precedenti. Questo vale anche quando 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="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 determinati comportamenti e proprietà 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"/>

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 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 da 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 Microsoft 365 Apps App-V 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 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.

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 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 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 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 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 Microsoft 365 Apps prodotti vengono aggiunte alla barra delle applicazioni di Windows in Windows 7 e Windows 8.1. Se si installa Microsoft 365 Apps 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 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 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 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 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 Microsoft 365 Apps aggiornamenti. Se TargetVersion è impostato su un numero di build specifico, Microsoft 365 Apps 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 è specificata in Coordinated Universal Time (UTC). È possibile usare Scadenza con versione di destinazione per assicurarsi che Microsoft 365 Apps venga aggiornato a una determinata versione entro una data specifica. È 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 Microsoft 365 Apps non viene aggiornato entro la scadenza, gli utenti visualizzano una notifica che indica che gli aggiornamenti verranno applicati tra 15 minuti. Questa notifica offre agli utenti l'opportunità di salvare i documenti su cui stanno lavorando e di chiudere tutte le applicazioni di Microsoft 365 aperte. Se gli utenti non chiudono le applicazioni di Microsoft 365, le applicazioni vengono chiuse automaticamente quando i 15 minuti sono attivi, il che potrebbe causare la 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 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.

Definisce il canale da usare per l'aggiornamento Microsoft 365 Apps 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 Microsoft 365 Apps e il canale per l'elemento Aggiornamenti viene usato per modificare 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 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.

Se si distribuisce Office LTSC Professional Plus 2021 o Office LTSC Standard 2021, ovvero versioni con contratti 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, ovvero versioni con contratti 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 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>