Opzioni di configurazione per lo Strumento di distribuzione di OfficeConfiguration options for the Office Deployment Tool

Con lo strumento di distribuzione di Office (ODT, Office Deployment Tool), è possibile scaricare e distribuire App di Microsoft 365 ai computer client.With the Office Deployment Tool (ODT), you can download and deploy Microsoft 365 Apps to your client computers. 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.The ODT gives you more control over an Office installation: you can define which products and languages are installed, how those products should be updated, and whether or not to display the install experience to your users. In questo articolo vengono illustrate tutte le opzioni disponibili nello strumento.This article covers all the available options in the tool. Per informazioni su come usare lo strumento, vedere Panoramica dello Strumento di distribuzione di Office.To learn how to use the tool itself, see Overview of the Office Deployment Tool.

Nota

Procedura consigliata: le opzioni in questo articolo illustrano gli elementi e gli attributi XML presenti nel file di configurazione.Best practice: The options in this article show the XML elements and attributes in the configuration file. È possibile continuare a creare il file di configurazione in un editor di testo, ma è consigliabile usare lo Strumento di personalizzazione di Office.You can continue to create the configuration file in a text editor, but we recommend using the Office Customization Tool instead. Con lo Strumento di personalizzazione di Office è possibile creare e modificare facilmente i file di configurazione in un'interfaccia Web.With the Office Customization Tool, you can easily create and modify configuration files in a web-based interface. Per altre informazioni, vedere Panoramica dello Strumento di personalizzazione di Office.For more information, see Overview of the Office Customization Tool.

Esempio di un file di configurazione standardExample of a standard configuration file

Lo strumento ODT è costituito da due file: setup.exe e configuration.xml. Per usare lo strumento, modificare il file di configurazione per definire le opzioni desiderate, quindi eseguire setup.exe dalla riga di comando. Ad esempio, è possibile modificare il file di configurazione per scaricare la versione a 32 bit in lingua inglese di Office oppure per installare la versione a 32 bit in lingua inglese di Office con il contratto di licenza accettato automaticamente e senza Publisher.The ODT consists of two files: setup.exe and configuration.xml. To work with the tool, you edit the configuration file to define what options you want, and then run setup.exe from the command line. For example, you can edit the configuration file to download the 32-bit English edition of Office, or you can edit the file to install the 32-bit English edition of Office with the EULA automatically accepted and without Publisher.

Quando si crea il file di configurazione, è consigliabile iniziare con un file di esempio e aggiornarlo con le opzioni adatte per il proprio ambiente. È possibile iniziare copiando e incollando l'esempio riportato di seguito in un file di testo e salvandolo con un nome a scelta. Utilizzare il file per modificare gli attributi e gli elementi XML e usare il resto di questo articolo per trovare ulteriori dettagli su ognuno degli elementi e degli attributi. When creating the configuration file, we recommend starting with an example file and updating it with the appropriate options for your environment. You can start by copying and pasting the example below into a text file and saving it with a name of your choosing. Use the file to modify the XML elements and attributes and use the rest of this article to learn more details about each of the elements and attributes.

Questo file di configurazione include gli elementi e gli attributi più utilizzati e può essere utilizzato per scaricare e installare Office su un computer clientThis configuration file includes the most-commonly used elements and attributes, and can be used to download and install Office on a client computer

<Configuration>
  <Add SourcePath="\\Server\Share" 
       OfficeClientEdition="32"
       Channel="SemiAnnual" >
    <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" />  
  <Logging Level="Standard" Path="%temp%" /> 
</Configuration>
ValoreValue DescrizioneDescription
Add SourcePath="\\Server\Share"Add SourcePath="\\Server\Share"
Office verrà scaricato nel percorso di rete "\\server\share" e distribuito mediante i file di installazione presenti in tale percorso.Office will be downloaded to "\\server\share" on your network and deployed using installation files at that location.
Add OfficeClientEdition="32"Add OfficeClientEdition="32"
Consente di scaricare e installare la versione di Office a 32 bitDownloads and installs the 32-bit edition of Office
Add Channel="SemiAnnual"Add Channel="SemiAnnual"
Office verrà installato tramite il Canale Enterprise semestrale.Office will be installed using Semi-Annual Enterprise Channel.
Product ID="O365ProPlusRetail"Product ID="O365ProPlusRetail"
Consente di scaricare e installare Microsoft 365 Apps for enterprise.Downloads and installs Microsoft 365 Apps for enterprise.
Language ID="en-us"Language ID="en-us"
Language ID="ja-jp"Language ID="ja-jp"
Consente di scaricare e installare versioni di Office in lingua inglese e giapponese.Downloads and installs English and Japanese versions of Office.
Updates Enabled="TRUE"Updates Enabled="TRUE"
Office verificherà la disponibilità di aggiornamenti.Office will check for updates.
Updates UpdatePath="\\Server\Share"Updates UpdatePath="\\Server\Share"
Office verifica la disponibilità di aggiornamenti al percorso di rete "\server\share".Office checks for updates at "\server\share" on your network.
Display Level="None" AcceptEULA="TRUE"Display Level="None" AcceptEULA="TRUE"
Durante l'installazione di Office, non viene visualizzata nessuna interfaccia utente.When installing Office, no user interface is displayed.
Logging Level="Standard" Path="%temp%"Logging Level="Standard" Path="%temp%"
I file di log vengono archiviati nella cartella %temp%.Log files are stored in the %temp% folder.

Elemento AddAdd element

Definisce i prodotti e le lingue da scaricare o installareDefines the products and languages to download or install

EsempioExample

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="32"
     Channel="SemiAnnual" 
     Version="16.0.8201.2193" >
  <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)SourcePath attribute (part of Add element)

Facoltativo.Optional.

Definisce il percorso dei file di installazione di Office.Defines the location of the Office installation files. Se lo strumento ODT viene eseguito in modalità di download, definisce la posizione in cui salvare i file.If the ODT is run in download mode, defines where to save the files. Se non è incluso, lo strumento ODT cercherà i file di installazione nella stessa cartella dello strumento, quindi userà la rete per la distribuzione di contenuti (CDN) di Office.If not included, the ODT will look for installation files in the same folder as the tool, and then use the Office Content Delivery Network (CDN). 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.If not included and the ODT is run in download mode, the Office installation files are downloaded to the same folder as the tool.

Quando si scarica Office in una cartella che contiene già la suddetta versione di Office, ODT limiterà la larghezza di banda di rete, scaricando solo i file mancanti. Ad esempio, se si usa ODT per scaricare Office in inglese e in tedesco in una cartella che contiene già Office in inglese, verrà scaricato solo il language pack tedesco.When you download Office to a folder that already contains that version of Office, the ODT will conserve your network bandwidth by downloading only the missing files. For example, if you use the ODT to download Office in English and German to a folder that already contains Office in English, only the German language pack will be downloaded.

Valori di esempio:Example values:

  • SourcePath="\\server\share"SourcePath="\\server\share"
  • SourcePath="c:\preload\office"SourcePath="c:\preload\office"

Attributo versione (parte dell'elemento Add)Version attribute (part of Add element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato sull'ultima versione disponibile.Defaults to the latest version available if not specified.

Se si usa l'attributo Version, è consigliabile includere anche l'attributo Channel.When you use the Version attribute, we recommend including the Channel attribute as well. Se non si include l'attributo Channel verrà usato il canale predefinito, che potrebbe non corrispondere alla versione specificata.If you don't include the Channel attribute, the default channel will be used, which might not match the specified version.

Se App di Microsoft 365 è già installato in un dispositivo, è possibile usare Version="MatchInstalled" per installare la stessa versione di Office, anche se è disponibile una versione più recente.If Microsoft 365 Apps is already installed on a device, you can use Version="MatchInstalled" to install the same version of Office, even if a newer version is available. Questa impostazione consente di aggiungere più facilmente i Language Pack oppure Visio e Project, senza aggiornare Office a una versione più recente.This setting can make it easier to add language packs or Visio and Project without updating Office to a newer version.

Valori di esempio:Example values:

  • Version="16.0.8201.2193"Version="16.0.8201.2193"
  • Version="MatchInstalled"Version="MatchInstalled"

Attributo OfficeClientEdition (parte dell'elemento Add)OfficeClientEdition attribute (part of Add element)

Facoltativo.Optional.

Definisce se è stata scaricata o installata la versione di App di Microsoft 365 a 32 o a 64 bit.Defines whether the 32-bit or 64-bit edition of Microsoft 365 Apps is downloaded or installed. Se Office non è installato sul dispositivo e non viene specificato OfficeClientEdition, l’ODT sarà impostato in maniera predefinita alla versione a 64 bit, a meno che sul dispositivo non sia in esecuzione una versione di Windows a 32 bit o con una RAM inferiore a 4 GB.If Office is not installed on the device and OfficeClientEdition is not specified, the ODT will default to the 64-bit edition, unless the device is running a 32-bit edition of Windows or has less than 4 GB RAM. Se Office è installato e non viene specificato OfficeClientEdition, l’ODT corrisponderà all'architettura dell'installazione esistente di Office.If Office is installed and OfficeClientEdition not specified, the ODT will match the architecture of the existing installation of Office. Se Office è installato e viene specificato OfficeClientEdition, deve corrispondere all'architettura già installata.If Office is installed and OfficeClientEdition is specified, then it must match the already installed architecture. In caso contrario, l'installazione avrà esito negativo, perché le architetture combinate non sono supportate.If it doesn't, the installation will fail, since mixed architectures are not supported.

Valori consentiti:Allowed values:

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

Attributo del canale (parte dell'elemento Add)Channel attribute (part of Add element)

Facoltativo.Optional.

Definisce il canale da utilizzare per l'installazione di Office.Defines which channel to use for installing Office. Se Office non è installato sul dispositivo, l'impostazione predefinita per l'attributo del canale è Current.If Office is not installed on the device, the default setting for the Channel attribute is Current. Se Office è installato sul dispositivo e non viene specificato l'attributo del canale, l’ODT corrisponderà al canale dell'installazione esistente.If Office is installed on the device and the channel attribute is not specified, the ODT will match the channel of the existing installation.

Questo valore determina il canale da installare, indipendentemente dal canale di aggiornamento eventualmente specificato nell'elemento Updates o tramite l'impostazione dei Criteri di gruppo.This value determines the channel to be installed, regardless of an optionally specified update channel in the Updates element or via Group Policy Setting. Se esiste questa impostazione con un canale di aggiornamento diverso, il cambio del canale viene eseguito dopo l'installazione durante il ciclo di aggiornamento successivo.If there is such setting with a different update channel, the channel switch is performed after the installation during the next update cycle. Per altre informazioni, vedere Modificare il canale di aggiornamento per Microsoft 365 Apps.For more information, see Change the Microsoft 365 Apps update channel.

Per ulteriori informazioni sui canali di aggiornamento, vedere Panoramica dei canali di aggiornamento per App di Microsoft 365.For more information about update channels, see Overview of update channels for Microsoft 365 Apps.

Valori consentiti:Allowed values:

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

Nota

  • Per usare questi valori degli attributi, è necessario usare almeno la versione 16.0.12827.20268 dello Strumento di distribuzione di Office, rilasciata martedì 9 giugno 2020.To use these attribute values, you need to be using at least version 16.0.12827.20268 of the Office Deployment Tool, which was released on Tuesday June 9, 2020.
  • È ancora possibile usare i valori precedenti consentiti per ogni canale di aggiornamento, quindi non è necessario aggiornare i file XML di configurazione precedenti.Previous allowed values for each update channel can still be used, which means you don't have to update your older configuration XML files.
  • Il canale Beta, a volte chiamato 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.Beta Channel (sometimes referred to as Insider Fast) is not a supported build so should only be used in test environments and by a small group of select users, such as IT staff or application developers.

Se distribuisci Office Professional Plus 2019, ovvero una versione di Office con contratto multilicenza, c'è un canale di aggiornamento diverso da utilizzare. Per ulteriori informazioni, consulta Canale di aggiornamento per Office 2019.If you're deploying Office Professional Plus 2019, which is a volume licensed version of Office, there is a different update channel you need to use: PerpetualVL2019. For more information, see Update channel for Office 2019.

Attributo DownloadPath (parte dell'elemento Add)DownloadPath attribute (part of Add element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato sulla rete CDN.Defaults to the CDN if not specified.

Definisce il percorso dal quale vengono scaricati i file di installazione quando si esegue l'ODT in modalità di download.Defines where the installation files are downloaded from when running ODT in download mode. In genere, viene utilizzato per distribuire determinate lingue e prodotti per Office da un percorso centrale della rete a un'altra posizione.Most commonly used to distribute specific languages and products for Office from a central location on your network to another location. Si noti che è necessario specificare una versione quando si usa DownloadPath, come mostrato nell'esempio.Note that you must specify a version when using DownloadPath, as shown in the example.

Valori di esempio:Example values:

  • DownloadPath="\\servera\share"DownloadPath="\\servera\share"

EsempioExample

<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)AllowCdnFallback attribute (part of Add element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su False.Defaults to False if not specified.

Per usare la rete CDN di Office come origine di backup per i Language Pack, includere l'attributo "AllowCdnFallback" nel file di configurazione, come mostrato nell'esempio.To use the Office CDN as a backup source for language packs, include the "AllowCdnFallback" attribute in the configuration file, as shown in the example.

Durante l'installazione delle lingue, lo strumento ODT cerca inizialmente i file di origine nel percorso specificato nell'attributo SourcePath. Se il language pack non è disponibile in quel percorso e AllowCdnFallback è impostata su True, lo strumento ODT utilizzerà i file di origine della rete CDN di Office.When installing languages, the ODT looks first for source files in the location specified in the SourcePath attribute. If the language pack isn't available at that location and the AllowCdnFallback setting is set to True, then the ODT will use source files from the Office CDN.

Valori consentiti:Allowed values:

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

EsempioExample

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

Attributo MigrateArch (parte dell'elemento Add)MigrateArch attribute (part of Add element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su False.Defaults to False if not specified.

Se impostato su TRUE, l'installazione di App di Microsoft 365 verrà modificata nell'architettura (talvolta detta anche numero di bit) specificata nell'attributo OfficeClientEdition.If set to TRUE, then your existing installation of Microsoft 365 Apps will be changed to the architecture (sometimes referred to as the bitness) that is specified in the OfficeClientEdition attribute. Ad esempio, è possibile utilizzarlo per modificare un'installazione a 32 bit di App di Microsoft 365 in un'installazione a 64 bit.For example, you can use this to change a 32-bit installation of Microsoft 365 Apps to a 64-bit installation.

Per ulteriori informazioni sull'uso di MigrateArch, vedere Modificare un'installazione di App di Microsoft 365 da 32 bit a 64 bit.For more information about using MigrateArch, see Change a Microsoft 365 Apps installation from 32-bit to 64-bit.

Attributo OfficeMgmtCOM (parte dell'elemento Add)OfficeMgmtCOM attribute (part of Add element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su False.Defaults to False if not specified.

Affinché Configuration Manager sia in grado di gestire gli aggiornamenti di App di Microsoft 365, è necessario che un oggetto Office COM sia abilitato nel computer in cui è installato Office.For Configuration Manager to be able to manage Microsoft 365 Apps updates, an Office COM object needs to be enabled on the computer where Office is installed. Se impostato su TRUE, l'oggetto Office COM accetta i comandi da Configuration Manager per scaricare e installare gli aggiornamenti del client.If set to TRUE, the Office COM object takes commands from Configuration Manager to download and install client updates. Quando l'oggetto Office COM è abilitato, l'opzione Aggiorna nella pagina Account di App di Microsoft 365 verrà automaticamente disabilitata per i dispositivi client.When the Office COM object is enabled, the Update Now option on the Account page for Microsoft 365 Apps is automatically disabled for client devices.

Per ulteriori informazioni, vedere Gestire gli aggiornamenti ad App di Microsoft 365 con Microsoft Endpoint Configuration Manager.For more information, see Manage updates to Microsoft 365 Apps with Microsoft Endpoint Configuration Manager.

Valori consentiti:Allowed values:

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

EsempioExample

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

Elemento ProductProduct element

Definisce quali prodotti scaricare o installare. Se si definiscono più prodotti, questi vengono installati nell'ordine indicato nel file di configurazione. Il primo prodotto determina il contesto per Microsoft Office First Run Experience. Defines which products to download or install. If you define multiple products, the products are installed in the order in the configuration file. The first product determines the context for the Microsoft Office First Run Experience.

È inoltre possibile usare l'elemento Product per aggiungere i Language Pack alle installazioni esistenti di App di Microsoft 365.You can also use the Product element to add language packs to existing installations of Microsoft 365 Apps. Per altre informazioni, incluso un file di configurazione di esempio, vedere Distribuire lingue a installazioni esistenti di Microsoft 365 Apps.For more information, including an example configuration file, see Deploy languages to existing installations of Microsoft 365 Apps.

EsempioExample

<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)ID attribute (part of Product element)

Obbligatorio.Required.

Definisce l'ID del prodotto da scaricare o installare.Defines the ID of the product to download or install.

Valori di esempio:Example values:

  • ID="O365ProPlusRetail"ID="O365ProPlusRetail"
  • ID="VisioProRetail"ID="VisioProRetail"
  • ID="ProjectProRetail"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 clicFor a list of all supported product IDs, see Product IDs that are supported by the Office Deployment Tool for Click-to-Run

Attributo MSICondition (parte dell’elemento Product)MSICondition attribute (part of Product element)

Facoltativo.Optional.

Consente di controllare l'installazione di un prodotto Office, come specificato dall’attributo ID, a seconda che nel dispositivo sia già installato un particolare prodotto Office basato su MSI.Allows you to control the installation of an Office product, as specified by the ID attribute, based on whether a particular MSI-based Office product is already installed on the device. Se, ad esempio, una versione basata su MSI di Project Professional è già installata nel dispositivo, installare il Client desktop di Project online.For example, if an MSI-based version of Project Professional is already installed on the device, then install Project Online Desktop Client.

È possibile specificare qualsiasi prodotto Office installato da Windows Installer (MSI), ma MSICondition viene in genere usato per le installazioni di Project o Visio.You can specify any Office product that was installed by Windows Installer (MSI), but MSICondition is most commonly used for Project or Visio installations. Il valore specificato per l'attributo MSICondition può corrispondere a un contratto multilicenza o a una versione definitiva del prodotto, purché la versione del prodotto sia stata installata con MSI.The value that you specify for the MSICondition attribute can be either a volume licensed or a retail version of the product, as long as that version of the product was installed by using MSI.

MSICondition riconoscerà le versioni 2007, 2010, 2013 e 2016 del prodotto Office specificato.MSICondition will recognize 2007, 2010, 2013, and 2016 versions of the Office product that you specify. Tuttavia, non è possibile specificare una versione particolare.But, you can't specify a particular version. Ad esempio, non è possibile chiedere a MSICondition di controllare nello specifico Visio Standard 2013.For example, you can't have MSICondition look specifically for Visio Standard 2013. MSICondition cercherà tutte le installazioni basate su MSI di Visio Standard, tra cui Visio Standard 2007, Visio Standard 2010, Visio Standard 2013 e Visio Standard 2016.MSICondition will look for all MSI-based installations of Visio Standard, including Visio Standard 2007, Visio Standard 2010, Visio Standard 2013, and Visio Standard 2016.

Il valore specificato per l’attributo MSICondition è l'ID configurazione che si trova nel file Setup.xml all'interno della cartella {prodotto}..WW dei file di installazione per la versione esistente del prodotto Office.The value that you specify for the MSICondition attribute is the Setup ID that is found in the Setup.xml file in the {product}.WW folder of the installation files for your existing version of the Office product. Ad esempio, il file Setup.xml per Visio Professional 2016 si trova nella cartella VisPro.WW.For example, the Setup.xml file for Visio Professional 2016 is found in the VisPro.WW folder. È possibile specificare diversi tipi di un prodotto Office, separati da una virgola.You can specify multiple types of an Office product, separated by a comma. Ad esempio, è possibile specificare "PrjStd,PrjStdR,PrjPro,PrjProR" per cercare installazioni di Project standard o Project Professional, con contratto multilicenza o versione definitiva.For example, you can specify "PrjStd,PrjStdR,PrjPro,PrjProR" to look for installations of Project Standard or Project Professional, either volume licensed or retail.

Nota

  • È consigliabile rimuovere gli prodotti Office basati su MSI esistenti come parte dell'installazione dei prodotti specificati nel file XML.We recommend that you remove the existing MSI-based Office products as part of installing the products specified in your XML file. Per rimuovere i prodotti basati su MSI esistenti, usare l'elemento RemoveMSI.To remove existing MSI-based products, use the RemoveMSI element.

Esempio di attributo MSIConditionExample of MSICondition attribute

Nell'esempio seguente, il Client desktop di Project Online verrà installato nel dispositivo solo se nel dispositivo è già installata una versione di Project standard basata su MSI.In the following example, Project Online Desktop Client will be installed on the device only if an MSI-based version of Project Standard is already installed on the device. Inoltre, Project standard verrà rimosso dal dispositivo nell'ambito dell'installazione del Client desktop di Project online.Also, Project Standard will be removed from the device as part of the installation of Project Online Desktop Client.

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

Elemento LanguageLanguage element

Definisce quali lingue scaricare o installare. Se si definiscono più lingue, la prima nel file di configurazione determina le impostazioni cultura dell'interfaccia utente della 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 della shell dopo l'installazione iniziale, è necessario disinstallare e reinstallare Office.Defines which languages to download or install. If you define multiple languages, the first language in the configuration file determines the Shell UI culture, including shortcuts, right-click context menus, and tooltips. If you decide that you want to change the Shell UI language after an initial installation, you have to uninstall and reinstall Office.

EsempioExample

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

Attributo ID (parte dell'elemento Language)ID attribute (part of Language element)

Obbligatorio.Required.

Definisce l'ID della lingua da scaricare o installare.Defines the ID of the language to download or install.

Valori di esempioExample values

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

Per un elenco di tutte le lingue, vedere Lingue, codici della lingua e lingue di correzione complementari.For a list of all languages, see Languages, culture codes, and companion proofing languages.

Per ulteriori informazioni su MatchPreviousMSI, vedere Rimuovere le versioni MSI esistenti di Office durante l'aggiornamento ad App di Microsoft 365.For more information about MatchPreviousMSI, see Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps.

MatchOS e MatchInstalled non possono installare le lingue del sistema operativo se Office non supporta la lingua oppure se il file ODT non trova il language pack corretto nei file di origine locali.MatchOS and MatchInstalled cannot install the operating system languages if Office doesn't support that language or if the ODT cannot find the correct language pack in the local source files. Per risolvere il problema, è consigliabile specificare una lingua di backup e consentire allo strumento ODT di usare la rete CDN di Office per i file mancanti.To help address this issue, we recommend that you specify a backup language and allow the ODT to use the Office CDN for missing files. A questo scopo, usare l'attributo Fallback e l'attributo AllowCdnFallBack.To do so, use the Fallback attribute and AllowCdnFallBack attribute.

MatchInstalled può essere usato solo se è già stato installato almeno un prodotto A portata di clic.MatchInstalled can be used only if there is at least one Click-to-Run product already installed. Non può essere usato con il parametro /download per lo strumento ODT.It can't be used with the /download switch for the ODT. Per altre informazioni su MatchInstalled, vedere Panoramica della distribuzione delle lingue e Creare pacchetti dinamici, leggeri e universali per Microsoft 365 Apps.For more information about MatchInstalled, see Overview of deploying languages and Build dynamic, lean, and universal packages for Microsoft 365 Apps.

Attributo Fallback (parte dell'elemento Language)Fallback attribute (part of Language element)

Facoltativo.Optional.

Quando si usa MatchOS e una lingua corrispondente non è supportata da Office o non viene trovata nei file di origine locale, si consiglia di specificare una lingua di fallback da installare. When using MatchOS, we recommend that you specify a fallback language to install when a matched language isn't supported by Office or can't be found in the local source files. A questo scopo, usare l'attributo "Fallback".To do so, use the "Fallback" attribute. Per altre informazioni, vedere Installare le stesse lingue del sistema operativo.For more information, see Install the same languages as the operating system.

Valori di esempio:Example values:

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

Attributo TargetProduct (parte dell'elemento Language)TargetProduct attribute (part of Language element)

Facoltativo.Optional.

Se si usa MatchInstalled, è necessario specificare se si vuole che corrisponda a uno specifico prodotto già installato o alla somma di tutte le lingue già installate.When using MatchInstalled, you have to specify if you want to match a specific already installed product or the sum of all already installed languages. Per scegliere un prodotto specifico, è possibile specificare qualsiasi ID di prodotto supportato.To target a specific product, you can specify any supported product ID. Se si vuole una corrispondenza con tutte le lingue già installate, è possibile specificare "All".If you want to match all already installed languages, you can specify "All". Lo strumento ODT installerà il nuovo prodotto con lo stesso set di lingue specificato in TargetProduct.ODT will then install the new product with the same set of languages as the one specified in TargetProduct.

Valori di esempio:Example values:

  • <Language ID="MatchInstalled" TargetProduct="O365ProPlusRetail"<Language ID="MatchInstalled" TargetProduct="O365ProPlusRetail"
  • <Language ID="MatchInstalled" TargetProduct="All"<Language ID="MatchInstalled" TargetProduct="All"

Elemento DisplayDisplay element

Definisce cosa viene visualizzato dall'utente quando viene installato Office.Defines what the user sees when Office is installed.

EsempioExample

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

Attributo Level (parte dell'elemento Display)Level attribute (part of Display element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su Full.Default is set to Full if not specified.

Se Level è impostato su None, Office viene installato senza interfaccia utente: non vengono visualizzati indicatori di stato, schermate di completamento, messaggi di errore o altri elementi dell'interfaccia utente.If Level is set to None, Office is installed with no user interface: no progress bars, completion screens, error messages, or other user interface are displayed.

Se Level è impostato su Full, Office viene installato con l'esperienza di installazione normale.If Level is set to Full, Office is installed with the normal installation experience.

Valori consentiti:Allowed values:

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

Attributo AcceptEULA (parte dell'elemento Display)AcceptEULA attribute (part of Display element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su FALSE.Defaults to FALSE if not specified.

Se **AcceptEULA ** è impostato su TRUE, l'utente non visualizzerà la finestra di dialogo Condizioni di licenza software Microsoft.If AcceptEULA is set to TRUE, the user does not see a Microsoft Software License Terms dialog box. Se questo attributo è impostato su FALSE o non è incluso, l'utente può visualizzare la finestra di dialogo Condizioni di licenza software Microsoft.If this attribute is set to FALSE or is not included, the user may see a Microsoft Software License Terms dialog box. È consigliabile per gli amministratori impostareAcceptEULA su TRUE.We recommend that administrators set AcceptEULA to TRUE.

Valori consentiti:Allowed values:

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

Nota

Se si distribuisce una versione di Office precedente alla versione 1803, questa impostazione verrà applicata solo se l'installazione viene eseguita con l'account utente. L'impostazione non verrà applicata a Microsoft Endpoint Configuration Manager e agli altri strumenti di distribuzione del software che utilizzano l'account di sistema per l'installazione.If you deploy a version of Office before Version 1803, this setting will be applied only if you install with the user's account. Microsoft Endpoint Configuration Manager and other software distribution tools that use the SYSTEM account for installation will not apply the setting.

Elemento ExcludeAppExcludeApp element

Definisce i prodotti di App di Microsoft 365 da non installare.Defines which Microsoft 365 Apps products should not be installed. OneDrive viene installato automaticamente quando si installa Microsoft 365 Apps o singole applicazioni, come Word, Excel, PowerPoint, Publisher, Visio o Skype.OneDrive is automatically installed when you install Microsoft 365 Apps or install individual applications, such as Word, Excel, PowerPoint, Publisher, Visio, or Skype. Se non si vuole che OneDrive venga installato insieme a tali applicazioni, usare l'elemento ExcludeApp per rimuoverlo.If you don't want OneDrive installed with those applications, use the ExcludeApp element to remove it. Per ulteriori informazioni, vedere Escludi OneDrive quando si installa Microsoft 365 Apps o altre applicazioni.For more information, see Exclude OneDrive when installing Microsoft 365 Apps or other applications.

EsempioExample

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

Se viene usato un file di configurazione con ExcludeApp per installare Office su un dispositivo che già include App di Microsoft 365, l'impostazione ExcludeApp viene trattata in modo diverso in base all'elenco delle lingue:If a configuration file with ExcludeApp is used to install Office on a device that already has Microsoft 365 Apps installed, the ExcludeApp setting is treated differently based on the list of languages:

  • Se l'elenco delle lingue nel file di configurazione include tutte le lingue installate, l'impostazione ExcludeApp nel file sostituisce qualsiasi impostazione ExcludeApp esistente nel dispositivo.If the list of languages in the configuration file includes all the installed languages, then the ExcludeApp setting in the file replaces any existing ExcludeApp setting on the device. Questo vale anche se l'elenco delle lingue nel file di configurazione include tutte le lingue installate e le altre lingue.This is also true if the list of languages in the configuration file includes both all the installed languages and additional languages.
  • Se l'elenco delle lingue nel file di configurazione non include tutte le lingue installate, l'impostazione ExcludeApp nel file di configurazione verrà abbinata all’impostazione ExcludeApp nel dispositivo.If the list of languages in the configuration file doesn't include all the installed languages, then the ExcludeApp setting in the configuration file will be combined with the ExcludeApp setting on the device.

Attributo ID (parte dell'elemento ExcludeApp)ID attribute (part of ExcludeApp element)

Obbligatorio.Required.

Definisce l'ID del prodotto da non installare.Defines the ID of the product that should not be installed.

Valori consentiti:Allowed values:

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

Per OneDrive for Business, usare Groove. Per Skype for Business, usare Lync.For OneDrive for Business, use Groove. For Skype for Business, use Lync.

Per altre informazioni su Microsoft Teams, vedere Distribuire Microsoft Teams con App di Microsoft 365.For more information about Microsoft Teams, see Deploy Microsoft Teams with Microsoft 365 Apps.

Elemento LoggingLogging element

Definisce le opzioni per la registrazione dell'ODT.Defines options for ODT logging.

EsempioExample

<Logging Level="Standard" 
         Path="%temp%" />

Attributo Level (parte dell'elemento Logging)Level attribute (part of Logging element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su Standard.Default is Standard if not specified.

Attiva o disattiva la registrazione.Turns logging on or off.

Valori consentiti:Allowed values:

  • Level="Off"Level="Off"
  • Level="Standard"Level="Standard"

Attributo Path (parte dell'elemento Logging)Path attribute (part of Logging element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su %temp%.Default is %temp% if not specified.

Definisce il percorso dei file di log.Defines the location of the log files.

Valori di esempio:Example values:

  • Path="%temp%"Path="%temp%"
  • Path="\\server\share\userlogs"Path="\\server\share\userlogs"

Elemento PropertyProperty element

Definisce alcune proprietà e comportamenti di Office.Defines certain Office behaviors and properties.

EsempioExample

<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)Name attribute (part of Property element)

Obbligatorio.Required.

Definisce la proprietà specifica di cui si vuole impostare il valore.Defines the specific property whose value you want to set.

Attributo Value (parte dell'elemento Property)Value attribute (part of Property element)

Definisce il valore della proprietà denominata.Defines the value of the named property.

Proprietà AUTOACTIVATE (parte dell'elemento Property)AUTOACTIVATE property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su 0.Default is 0 if not specified.

Dato che App di Microsoft 365 è impostato in modo da attivarsi automaticamente, non è necessario impostare questa proprietà per i prodotti App di Microsoft 365. Because Microsoft 365 Apps is set to activate automatically, you should not set this property for Microsoft 365 Apps products. Per altri prodotti, è possibile impostare AUTOACTIVATE su 1 per far sì che il prodotto si attivi automaticamente.For other products, you can set AUTOACTIVATE to 1 to have the product activate automatically.

Valori consentiti:Allowed values:

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

Proprietà FORCEAPPSHUTDOWN (parte dell'elemento Property)FORCEAPPSHUTDOWN property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è FALSE.Default is FALSE if not specified.

Se è impostata su TRUE, forza l'arresto delle app che impediscono l'installazione di Office.When set to TRUE, forces any apps that are blocking the install of Office to shut down. Potrebbero verificarsi perdite di dati.Data loss may occur.

Valori consentiti:Allowed values:

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

Proprietà PACKAGEGUID (parte dell'elemento Property)PACKAGEGUID property (part of Property element)

Facoltativo.Optional.

Per impostazione predefinita, i pacchetti di App-V creati da ODT condividono lo stesso ID pacchetto di App-V.By default, App-V packages created by the ODT share the same App-V Package ID. Gli amministratori possono usare PACKAGEGUID per specificare un altro ID pacchetto.Administrators can use PACKAGEGUID to specify a different Package ID. In questo modo è possibile pubblicare più pacchetti di Office su un server di gestione App-V.This allows you to publish multiple App-V packages of Office to an App-V Management Server. Tuttavia, non consente di distribuire più pacchetti di Office a un singolo computer.But, this doesn't enable you to deploy more than one Office App-V package to a single computer. È possibile utilizzare ODT per creare pacchetti App-V per App di Microsoft 365.You can use the ODT to create App-V packages for Microsoft 365 Apps. Non è supportata la creazione di pacchetti per le versioni con contratto multilicenza di Office Professional Plus od Office Standard.Creating packages for the volume-licensed versions of Office Professional Plus or Office Standard is not supported.

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, FThe Package ID must follow the format of the example and can only use these characters: 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.If you use any other characters, the App-V package is created with the default Package ID.

Valori di esempio:Example values:

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

Proprietà SharedComputerLicensing (parte dell'elemento Property)SharedComputerLicensing property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è 0.Default value is 0 if not specified.

Impostare SharedComputerLicensing su 1 se si distribuisce App di Microsoft 365 a computer condivisi tramite Servizi Desktop remoto.Set SharedComputerLicensing to 1 if you deploy Microsoft 365 Apps to shared computers by using Remote Desktop Services.

Per ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi per App di Microsoft 365.For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valori consentiti:Allowed values:

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

Proprietà SCLCacheOverride (parte dell'elemento Property)SCLCacheOverride property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è 0.Default value is 0 if not specified.

Impostare SCLCacheOverride su 1 se si usa l'attivazione di computer condivisi e si vuole eseguire il roaming del token di licenza.Set SCLCacheOverride to 1 if you're using shared computer activation and you want to roam the licensing token. Usare in combinazione con SCLCacheOverrideDirectory.Use in conjunction with SCLCacheOverrideDirectory. Questa operazione è necessaria solo se si sceglie di spostare il token di licenza dalla posizione predefinita.This is only needed if you choose to move the licensing token from its default location. Per ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi per App di Microsoft 365.For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valori consentiti:Allowed values:

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

Proprietà SCLCacheOverrideDirectory (parte dell'elemento Property)SCLCacheOverrideDirectory property (part of Property element)

Facoltativo.Optional.

Impostare SCLCacheOverrideDirectory in modo da specificare un percorso per il token di licenza se si usa l'attivazione di computer condivisi e si vuole eseguire il roaming del token di licenza.Set SCLCacheOverrideDirectory to specify a folder location for the licensing token if you're using shared computer activation and you want to roam the licensing token. Usare in combinazione con SCLCacheOverride.Use in conjunction with SCLCacheOverride. Questa operazione è necessaria solo se si sceglie di spostare il token di licenza dalla posizione predefinita.This is only needed if you choose to move the licensing token from its default location.

Per ulteriori informazioni, vedere Panoramica dell'attivazione di computer condivisi per App di Microsoft 365.For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valori di esempio:Example values:

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

Proprietà DeviceBasedLicensing (parte dell'elemento Property)DeviceBasedLicensing property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è 0.Default value is 0 if not specified.

Definisce la modalità di gestione delle licenze di Office per l'attivazione basata su dispositivo.Defines the Office licensing mode for device-based activation. Per ulteriori informazioni, vedere Licenze basate su dispositivi per Microsoft 365 Apps for enterprise.For more information, see Device-based licensing for Microsoft 365 Apps for enterprise.

Valori consentiti:Allowed values:

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

Proprietà PinIconsToTaskBar (parte dell'elemento Property)PinIconsToTaskBar property (part of Property element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato su True.The default value is True if not specified.

Definisce se le icone dei collegamenti per i prodotti di Office vengono aggiunte alla barra delle applicazioni di Windows in Windows 7 e 8.1. Se si installa Office usando un account di sistema, che è più comune durante la distribuzione con Microsoft Endpoint Configuration Manager, le icone non verranno aggiunte anche se questa proprietà è impostata su True.Defines whether shortcut icons for Office products are added to the Windows taskbar in Windows 7 and 8.1. If you install Office using a system account, which is common when deploying with Microsoft Endpoint Configuration Manager, the icons will not be pinned even if this property is set to True.

Valori consentiti:Allowed values:

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

Nota

Microsoft 365 Apps non è più supportato su Windows 7.Microsoft 365 Apps is no longer supported on Windows 7. Per ulteriori informazioni, vedere Fine del supporto di Windows 7 e Microsoft 365 Apps.For more information, see Windows 7 end of support and Microsoft 365 Apps.

Elemento RemoveRemove element

Definisce i prodotti e le lingue da rimuovere da una precedente installazione di App di Microsoft 365.Defines which products and languages to remove from a previous installation of Microsoft 365 Apps. Per rimuovere una lingua installata, è necessario specificare sia il prodotto che la lingua, come nell'esempio.To remove an installed language, you must provide both the product and the language, as in the example. Per rimuovere tutte le lingue installate, non includere l'attributo per la lingua.To remove all the installed languages, do not include the language attribute. In questo caso, l'ODT individua e rimuove automaticamente tutte le lingue installate per il prodotto.In that case, the ODT automatically discovers and removes all installed languages for the product.

Per ulteriori informazioni, vedere Panoramica dello Strumento di distribuzione di Office.For more information, see Overview of the Office Deployment Tool.

EsempioExample

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

Attributo All (parte dell'elemento Remove)All attribute (part of Remove element)

Facoltativo.Optional. Se non specificato, il valore predefinito è FALSE.The default value is FALSE is not specified.

Se impostato su TRUE, verranno rimossi tutti i prodotti e le lingue di App di Microsoft 365, compresi Project e Visio.If set to TRUE, all Microsoft 365 Apps products and languages will be removed, including Project and Visio.

Valori consentiti:Allowed values:

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

Elemento UpdatesUpdates element

Definisce la modalità di aggiornamento di Office dopo l'installazione.Defines how Office is updated after it's installed.

EsempioExample

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

Attributo Enabled (parte dell'elemento Updates)Enabled attribute (part of Updates element)

Facoltativo.Optional. Se non specificato, il valore predefinito è TRUE.The default value is TRUE if not specified.

Se impostato su TRUE, Office verificherà la disponibilità di aggiornamenti. Se impostato su FALSE, Office non verificherà la disponibilità di aggiornamenti, ma l'utente potrà farlo andando su File > Account > Opzioni di aggiornamento > Aggiorna ora.If set to TRUE, Office will check for updates. If set to FALSE, Office won't check for updates, but the user can check for updates by going to File > Account > Update Options > Update Now.

Valori consentiti:Allowed values:

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

Attributo UpdatePath (parte dell'elemento Updates)UpdatePath attribute (part of Updates element)

Facoltativo.Optional. Se non specificato, il valore predefinito è impostato sulla rete CDN.Defaults to the CDN if not specified.

Definisce la provenienza degli aggiornamenti per Office.Defines where the updates for Office come from. UpdatePath può specificare un percorso di rete, locale o HTTP di un'origine per i file di installazione di Office.UpdatePath can specify a network, local, or HTTP path of a source for Office installation files. È possibile usare variabili di ambiente per i percorsi di rete o locali.Environment variables can be used for network or local paths.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set UpdatePath by using the Update Path policy setting.If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set UpdatePath by using the Update Path policy setting. Questa impostazione dei criteri è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valori di esempio:Example values:

Attributo TargetVersion (parte dell'elemento Updates)TargetVersion attribute (part of Updates element)

Facoltativo.Optional. Il valore predefinito è impostato sulla versione più recente dal percorso di aggiornamento specificato.Defaults to the latest version from the specified update path.

Definisce a quale versione aggiornare Office.Defines which version Office updates to. Se TargetVersion è impostato su uno specifico numero di build, Office tenta di eseguire l'aggiornamento a tale versione.If TargetVersion is set to a specific build number, Office attempts to update to that version.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set TargetVersion by using the Target Version policy setting.If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set TargetVersion by using the Target Version policy setting. Questa impostazione dei criteri è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valori di esempio:Example values:

  • TargetVersion="15.1.2.3"TargetVersion="15.1.2.3"
  • TargetVersion=""TargetVersion=""

Attributo Deadline (parte dell'elemento Updates)Deadline attribute (part of Updates element)

Facoltativo.Optional.

Definisce una data scadenza entro la quale devono essere applicati gli aggiornamenti. La data di scadenza è specificata in Coordinated Universal Time (UTC). È possibile usare Deadline con TargetVersion 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. Defines a deadline by which updates must be applied. The deadline is specified in Coordinated Universal Time (UTC). You can use Deadline with Target Version to make sure that Office is updated to a particular version by a particular date. We recommend that you set the deadline at least a week in the future to allow users time to install the updates.

Prima della scadenza, gli utenti riceveranno diversi promemoria relativi all'installazione degli aggiornamenti.Prior to the deadline, users receive multiple reminders to install the updates. Se Office non viene aggiornato entro il termine, gli utenti riceveranno una notifica che indica che gli aggiornamenti verranno applicati dopo 15 minuti.If Office isn't updated by the deadline, users see a notification that the updates will be applied in 15 minutes. Questo intervallo consente agli utenti di salvare i documenti di Office su cui stanno lavorando e di chiudere gli altri programmi di Office aperti.This gives users the opportunity to save the Office documents that they are working on and to close any Office programs that are open. Se gli utenti non chiudono le applicazioni di Office, queste verranno chiuse automaticamente trascorsi i 15 minuti e potrebbero verificarsi perdite di dati.If users don't close the Office programs, the programs are closed automatically when the 15 minutes are up, which might result in data loss.

Dopo aver chiuso tutte le applicazioni di Office, gli aggiornamenti vengono applicati automaticamente.After the Office programs are closed, the updates are applied automatically. La scadenza si applica solo a uno specifico set di aggiornamenti.The deadline only applies to one set of updates. Per usare una scadenza per assicurarsi che Office sia sempre aggiornato, è necessario modificare la data di scadenza ogni volta che viene reso disponibile un aggiornamento per Office.If you want to use a deadline to make sure that Office is always up to date, you must change the deadline every time a new update for Office is available.

To use this attribute, Office must be running at least Service Pack 1 (version 15.0.4569.1507).To use this attribute, Office must be running at least Service Pack 1 (version 15.0.4569.1507). If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Deadline by using the Update Deadline policy setting.If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Deadline by using the Update Deadline policy setting. Questa impostazione dei criteri è disponibile in Configurazione computer\Criteri\Modelli amministrativi\Microsoft Office 2016 (computer)\Aggiornamenti.You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valore di esempio:Example value:

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

Attributo Channel (parte dell'elemento Updates)Channel attribute (part of Updates element)

Facoltativo.Optional. L'impostazione predefinita è Current.The default is Current.

Definisce il canale da usare per l'aggiornamento di Office dopo l'installazione.Defines which channel to use for updating Office after it is installed. Esistono due attributi del canale: il canale per l'elemento Add viene usato per specificare un canale di aggiornamento durante l'installazione di Office, mentre il canale per l'elemento Update viene usato per modificare il canale per un'installazione esistente di Office.There are two channel attributes: the channel for the Add element is used to specify an update channel while installing Office, and the channel for the Updates element is used to change the channel for an existing installation of Office.

Per ulteriori informazioni sui canali di aggiornamento, vedere Panoramica dei canali di aggiornamento per App di Microsoft 365.For more information about update channels, see Overview of update channels for Microsoft 365 Apps.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Channel by using the Update Channel policy setting.If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Channel by using the Update Channel policy setting. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates. If enabled, this Group Policy setting takes precedence over the Channel value set by using the Office Deployment Tool.If enabled, this Group Policy setting takes precedence over the Channel value set by using the Office Deployment Tool.

Valori consentiti:Allowed values:

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

Nota

  • Per usare questi valori degli attributi, è necessario usare almeno la versione 16.0.12827.20268 dello Strumento di distribuzione di Office, rilasciata martedì 9 giugno 2020.To use these attribute values, you need to be using at least version 16.0.12827.20268 of the Office Deployment Tool, which was released on Tuesday June 9, 2020.
  • È ancora possibile usare i valori precedenti consentiti per ogni canale di aggiornamento, quindi non è necessario aggiornare i file XML di configurazione precedenti.Previous allowed values for each update channel can still be used, which means you don't have to update your older configuration XML files.
  • Il canale Beta, a volte chiamato 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.Beta Channel (sometimes referred to as Insider Fast) is not a supported build so should only be used in test environments and by a small group of select users, such as IT staff or application developers.

Se distribuisci Office Professional Plus 2019, ovvero una versione di Office con contratto multilicenza, c'è un canale di aggiornamento diverso da utilizzare. Per ulteriori informazioni, consulta Canale di aggiornamento per Office 2019.If you're deploying Office Professional Plus 2019, which is a volume licensed version of Office, there is a different update channel you need to use: PerpetualVL2019. For more information, see Update channel for Office 2019.

Elemento RemoveMSIRemoveMSI element

Facoltativo.Optional.

Specifica se le versioni 2007, 2010, 2013 o 2016 di Office, Visio e Project installate tramite Windows Installer (MSI) sono disinstallate dal computer prima dell'installazione del prodotto specifico, ad esempio Microsoft 365 Apps.Specifies whether any 2007, 2010, 2013, or 2016 versions of Office, Visio, and Project that were installed using Windows Installer (MSI) are uninstalled from the computer prior to the installation of the specified product, such as Microsoft 365 Apps.

È consigliabile disinstallare le versioni precedenti di Office prima di installare Microsoft 365 Apps.We recommend that you uninstall any previous versions of Office before installing Microsoft 365 Apps. Per ulteriori informazioni sull'utilizzo di RemoveMSI, vedere Rimuovere le versioni MSI esistenti di Office durante l'aggiornamento a Microsoft 365 Apps.For more information about using RemoveMSI, see Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps.

Attributo IgnoreProduct (parte dell'elemento RemoveMSI)IgnoreProduct attribute (part of RemoveMSI element)

Facoltativo.Optional.

Se si specifica un ID, quel prodotto di Windows Installer (MSI) non verrà disinstallato dal computer.If an ID is specified, that Windows Installer (MSI) product won't be uninstalled from the computer.

Valori di esempio:Example values:

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

Elemento AppSettingsAppSettings element

Facoltativo.Optional.

Definisce le preferenze dell'applicazione per App di Microsoft 365, incluse le notifiche delle Macro VBA, i percorsi file predefiniti e i formati di file predefiniti.Defines application preferences for Microsoft 365 Apps, including VBA Macro notifications, default file locations, and default file format. Per creare un file di configurazione con preferenze dell'applicazione, si consiglia di usare lo Strumento di personalizzazione di Office per A portata di clic, un'applicazione Web con un'interfaccia utente completa.To create a configuration file with application preferences, we recommend you use the Office Customization Tool for Click-to-Run, a web application with a full user interface. È possibile usare questo strumento anche per ottenere altre informazioni sulle preferenze disponibili per l'applicazione.You can also use the tool to learn more about the available application preferences.

Per altre informazioni sulle preferenze dell'applicazione, vedere Applicare le preferenze dell'applicazione e Applicare le preferenze dell'applicazione per un'installazione esistente di Office.For more information about application preferences, see Apply application preferences and Apply application preferences to an existing installation of Office.

EsempioExample

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