Opções de configuração da Ferramenta de Implantação do OfficeConfiguration options for the Office Deployment Tool

Com a ODT (Ferramenta de Implantação do Office), é possível baixar e implantar o Microsoft 365 Apps em seus computadores cliente. A ODT dá mais controle sobre uma instalação do Office: você pode definir quais produtos e idiomas são instalados, como os produtos devem ser atualizados e se deseja ou não exibir a experiência de instalação para os usuários. Este artigo explica todas as opções disponíveis na ferramenta. Para saber como usar a ferramenta em si, confira Visão geral da Ferramenta de Implantação do Office.With the Office Deployment Tool (ODT), you can download and deploy Microsoft 365 Apps to your client computers. 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. This article covers all the available options in the tool. To learn how to use the tool itself, see Overview of the Office Deployment Tool.

Observação

Prática recomendada: As opções neste artigo mostram os elementos XML e os atributos no arquivo de configuração. Você pode continuar a criar o arquivo de configuração em um editor de texto, mas é recomendável usar a Ferramenta de Implantação do Office. Com a Ferramenta de Implantação do Office, você pode criar e modificar facilmente arquivos de configuração em uma interface baseada na Web. Para saber mais, confira Visão geral da Ferramenta de Implantação do Office.Best practice: The options in this article show the XML elements and attributes in the configuration file. You can continue to create the configuration file in a text editor, but we recommend using the Office Customization Tool instead. With the Office Customization Tool, you can easily create and modify configuration files in a web-based interface. For more information, see Overview of the Office Customization Tool.

Exemplo de um arquivo de configuração padrãoExample of a standard configuration file

A ODT consiste em dois arquivos: setup.exe e configuration.xml. Para trabalhar com a ferramenta, você edita o arquivo de configuração para definir quais opções deseja e executa setup.exe da linha de comando. Por exemplo, você pode editar o arquivo de configuração para baixar a edição em inglês de 32 bits do Office ou pode editar o arquivo para instalar a edição em inglês de 32 bits do Office com o EULA automaticamente aceito e sem 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.

Ao criar o arquivo de configuração, recomendamos começar com um arquivo de exemplo e atualizá-lo com as opções apropriadas para o seu ambiente. É possível iniciar copiando e colando um dos exemplos a seguir em um arquivo de texto e salvando-o com um nome de sua escolha. Use o arquivo para modificar os atributos e elementos XML e use o restante deste artigo para saber mais detalhes sobre cada um dos atributos e elementos.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.

Este arquivo de configuração inclui os elementos e atributos mais comuns e pode ser usado para baixar e instalar o Office em um computador clienteThis 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" />  
</Configuration>
ValorValue DescriçãoDescription
Add SourcePath="\\Server\Share"Add SourcePath="\\Server\Share"
O Office será baixado em "\servidor\compartilhamento" na sua rede e implantado usando arquivos de instalação nesse local.Office will be downloaded to "\\server\share" on your network and deployed using installation files at that location.
Adicionar OfficeClientEdition="32"Add OfficeClientEdition="32"
Baixa e instala a edição de 32 bits do Office.Downloads and installs the 32-bit edition of Office
Adicionar canal = "Semestral"Add Channel="SemiAnnual"
O Office será instalado usando o Canal Empresarial Semestral.Office will be installed using Semi-Annual Enterprise Channel.
ID do produto="O365ProPlusRetail"Product ID="O365ProPlusRetail"
Baixa e instala os Aplicativos do Microsoft 365 para empresas.Downloads and installs Microsoft 365 Apps for enterprise.
ID do idioma="en-us"Language ID="en-us"
ID do idioma="ja-jp"Language ID="ja-jp"
Baixa e instala as versões em inglês e japonês do Office.Downloads and installs English and Japanese versions of Office.
Updates Enabled="TRUE"Updates Enabled="TRUE"
O Office verificará se há atualizações.Office will check for updates.
Updates UpdatePath="\\Server\Share"Updates UpdatePath="\\Server\Share"
O Office verifica se há atualizações em "\servidor\compartilhamento" na sua rede.Office checks for updates at "\server\share" on your network.
Display Level="None" AcceptEULA="TRUE"Display Level="None" AcceptEULA="TRUE"
Ao instalar o Office, nenhuma interface do usuário é exibida.When installing Office, no user interface is displayed.

Observação

O elemento Log não tem mais suporte como uma opção de configuração para a Ferramenta de Implantação do Office.The Logging element is no longer supported as a configuration option for the Office Deployment Tool. Os arquivos de log podem ser encontrados na pasta %temp%.Log files can be found in the %temp% folder.

Adicionar elementoAdd element

Define os produtos e idiomas a serem baixados e instalados.Defines the products and languages to download or install

ExemploExample

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

Atributo SourcePath (parte do elemento Add)SourcePath attribute (part of Add element)

Opcional.Optional.

Define o local dos arquivos de instalação do Office. Se a ODT for executada no modo de download, definirá onde salvar os arquivos. Se não for incluído, a ODT procurará os arquivos de instalação na mesma pasta que a ferramenta e usará a CDN (rede de distribuição de conteúdo) do Office. Se não for incluído e a ODT for executada no modo de download, os arquivos de instalação do Office serão baixados para a mesma pasta que a ferramenta.Defines the location of the Office installation files. If the ODT is run in download mode, defines where to save the files. 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). 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 você baixa o Office em uma pasta que já contém essa versão do Office, a ODT conservará a largura de banda da rede baixando apenas os arquivos ausentes. Por exemplo, se você usar a ODT para baixar o Office em inglês e alemão para uma pasta que já contém o Office em inglês, apenas o pacote de idiomas alemão será baixado.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.

Valores de exemplo:Example values:

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

Atributo Version (parte do elemento Add)Version attribute (part of Add element)

Opcional. O padrão é a versão mais recente disponível, caso não seja especificada.Optional. Defaults to the latest version available if not specified.

Ao usar o atributo de versão, recomendamos incluir também o atributo de canal. Se você não incluir o atributo de canal, o canal padrão será usado, que pode não corresponder à versão especificada.When you use the Version attribute, we recommend including the Channel attribute as well. If you don't include the Channel attribute, the default channel will be used, which might not match the specified version.

Se as Microsoft 365 Apps já estiverem instalados em um dispositivo, você poderá usar a versão = "MatchInstalled" para instalar a mesma versão do Office, mesmo que uma versão mais recente esteja disponível. Essa configuração pode facilitar a adição de pacotes de idiomas ou do Visio e do Project sem a atualização do Office para uma versão mais 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. This setting can make it easier to add language packs or Visio and Project without updating Office to a newer version.

Valores de exemplo:Example values:

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

Atributo OfficeClientEdition (parte do elemento Add)OfficeClientEdition attribute (part of Add element)

Opcional.Optional.

Define se a edição de 32 bits ou 64 bits do Microsoft 365 Apps será baixada ou instalada. Se o Office não estiver instalado no dispositivo e OfficeClientEdition não for especificado, a ODT usará o padrão para a versão de 64 bits, a menos que o dispositivo execute uma edição de 32 bits do Windows ou tenha menos de 4 GB de RAM. Se o Office estiver instalado e OfficeClientEdition não especificado, a ODT corresponderá à arquitetura da instalação existente do Office. Se o Office estiver instalado e OfficeClientEdition for especificado, ele deve corresponder à arquitetura já instalada. Caso contrário, a instalação falhará, uma vez que não há suporte para arquiteturas misturadas.Defines whether the 32-bit or 64-bit edition of Microsoft 365 Apps is downloaded or installed. 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. If Office is installed and OfficeClientEdition not specified, the ODT will match the architecture of the existing installation of Office. If Office is installed and OfficeClientEdition is specified, then it must match the already installed architecture. If it doesn't, the installation will fail, since mixed architectures are not supported.

Valores permitidos:Allowed values:

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

Atributo Channel (parte do elemento Add)Channel attribute (part of Add element)

Opcional.Optional.

Define o canal a ser usado para a instalação do Office. Se o Office não estiver instalado no dispositivo, a configuração padrão para o atributo de canal será Atual. Se o Office estiver instalado no dispositivo e o atributo de canal não for especificado, a ODT fará a correspondência entre o canal da instalação existente.Defines which channel to use for installing Office. If Office is not installed on the device, the default setting for the Channel attribute is Current. If Office is installed on the device and the channel attribute is not specified, the ODT will match the channel of the existing installation.

Esse valor define o canal a ser instalado, independentemente de um canal de atualização especificado opcional no elemento atualizações ou por meio da configuração da política de grupo. Caso haja essa configuração com outro canal de atualização, a opção canal será realizada após a instalação, durante o ciclo de atualização seguinte. Para obter mais informações, confira alterar o canal de atualização de Microsoft 365 Apps.This value determines the channel to be installed, regardless of an optionally specified update channel in the Updates element or via Group Policy Setting. If there is such setting with a different update channel, the channel switch is performed after the installation during the next update cycle. For more information, see Change the Microsoft 365 Apps update channel.

Para obter mais informações sobre canais de atualização, confira Visão geral de canais de atualização para os Microsoft 365 Apps.For more information about update channels, see Overview of update channels for Microsoft 365 Apps.

Valores permitidos: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"

Observação

  • Para usar esses valores de atributo, você precisa estar usando pelo menos a versão 16.0.12827.20268 da Ferramenta de Implantação do Office, lançada na terça-feira, 9 de junho de 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.
  • Os valores permitidos anteriores de cada canal de atualização ainda podem ser usados, o que significa que você não precisa atualizar os arquivos XML de configuração mais antigos.Previous allowed values for each update channel can still be used, which means you don't have to update your older configuration XML files.
  • O Canal Beta (às vezes chamado de Participante do Programa Windows Insider - Modo Rápido) não é uma compilação compatível, portanto, deve ser usado somente em ambientes de teste e por um pequeno grupo de usuários selecionados, como a equipe de TI ou desenvolvedores de aplicativos.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 você estiver implantando o Office Professional Plus 2019, que é uma versão licenciada de volume do Office, há um canal de atualizações diferente que você precisa usar: PerpetualVL2019. Para saber mais, confira Canal de atualizações para o 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.

Atributo DownloadPath (parte do elemento Add)DownloadPath attribute (part of Add element)

Opcional. O padrão é a CDN, caso não seja especificada.Optional. Defaults to the CDN if not specified.

Opcional. Define de onde os arquivos de instalação são baixados. Mais comumente usado para distribuir idiomas e produtos específicos para o Office de um local central na sua rede para outro local. Para usar essa configuração, execute o ODT no modo de download. Se este não estiver incluído, os arquivos são baixados da CDN do Office. Observe que você deve especificar uma versão ao usar o DownloadPath, conforme mostrado no exemplo.Defines where the installation files are downloaded from when running ODT in download mode. Most commonly used to distribute specific languages and products for Office from a central location on your network to another location. Note that you must specify a version when using DownloadPath, as shown in the example.

Valores de exemplo:Example values:

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

ExemploExample

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

Atributo AllowCdnFallback (parte do elemento Add)AllowCdnFallback attribute (part of Add element)

Opcional. O padrão é falso caso não especificado.Optional. Defaults to False if not specified.

Para usar a CDN do Office como uma fonte de backup para pacotes de idiomas, inclua o atributo "AllowCdnFallback" no arquivo de configuração, conforme mostrado no exemplo.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.

Ao instalar os idiomas, a ODT procurará primeiro os arquivos de origem no local especificado no atributo SourcePath. Se o pacote de idiomas não estiver disponível nesse local e a configuração AllowCdnFallback estiver definida como True, a ODT usará arquivos de origem da CDN do 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.

Valores permitidos:Allowed values:

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

ExemploExample

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

Atributo MigrateArch (parte do elemento Add)MigrateArch attribute (part of Add element)

Opcional. O padrão é falso caso não especificado.Optional. Defaults to False if not specified.

Se definido como VERDADEIRO, a instalação existente dos Aplicativos do Microsoft 365 será alterada para a arquitetura (às vezes chamada de número de bit) especificada no atributo OfficeClientEdition. Por exemplo, você pode usar isso para alterar uma instalação de 32 bits do Microsoft 365 Apps para uma instalação de 64 bits.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. For example, you can use this to change a 32-bit installation of Microsoft 365 Apps to a 64-bit installation.

Para saber mais sobre como usar o MigrateArch, confira Alterar uma instalação dos Microsoft 365 Apps de 32 bits para 64 bits.For more information about using MigrateArch, see Change a Microsoft 365 Apps installation from 32-bit to 64-bit.

Atributo OfficeMgmtCOM (parte do elemento Add)OfficeMgmtCOM attribute (part of Add element)

Opcional. O padrão é falso caso não especificado.Optional. Defaults to False if not specified.

Para que o Configuration Manager possa gerenciar as atualizações de aplicativos do Microsoft 365, um objeto COM do Office precisa estar habilitado no computador no qual o Office está instalado. Se definida como TRUE, o objeto COM do Office usa comandos do Configuration Manager para baixar e instalar as atualizações do cliente. Quando o objeto COM do Office está habilitado, a opção Atualizar agora na página conta para os aplicativos do Microsoft 365 é desabilitada automaticamente para dispositivos clientes.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. If set to TRUE, the Office COM object takes commands from Configuration Manager to download and install client updates. 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.

Para obter mais informações, confira Gerenciar atualizações para os Microsoft 365 Apps com o Microsoft Endpoint Configuration Manager.For more information, see Manage updates to Microsoft 365 Apps with Microsoft Endpoint Configuration Manager.

Valores permitidos:Allowed values:

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

ExemploExample

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

Elemento ProductProduct element

Define quais produtos serão baixados ou instalados. Se você definir vários produtos, os produtos serão instalados na ordem que são exibidos no arquivo de configuração. O primeiro produto determina o contexto da 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.

Você também pode usar o elemento Product para adicionar pacotes de idiomas às instalações existentes do Microsoft 365 Apps. Para obter mais informações, incluindo um arquivo de configuração de exemplo, consulte Implantar idiomas em instalações existentes do Microsoft 365 Apps.You can also use the Product element to add language packs to existing installations of Microsoft 365 Apps. For more information, including an example configuration file, see Deploy languages to existing installations of Microsoft 365 Apps.

ExemploExample

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

Atributo ID (parte do elemento Product)ID attribute (part of Product element)

Obrigatório.Required.

Define a ID do produto a ser baixado ou instalado.Defines the ID of the product to download or install.

Valores de exemplo:Example values:

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

Confira uma lista de todas as IDs de produto com suporte em IDs de produto sem suporte na Ferramenta de Implantação do Office para o Clique para ExecutarFor a list of all supported product IDs, see Product IDs that are supported by the Office Deployment Tool for Click-to-Run

Atributo MSICondition (parte do elemento Product)MSICondition attribute (part of Product element)

Opcional.Optional.

O permite que você controle a instalação de um produto do Office, conforme especificado pelo Atributo de identificação, com base na existência de um determinado produto do Office baseado em MSI. Por exemplo, se uma versão baseada em MSI do Project Professional já estiver instalada no dispositivo, instale o cliente de desktop do Project online.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. For example, if an MSI-based version of Project Professional is already installed on the device, then install Project Online Desktop Client.

Você pode especificar todos os produtos do Office que foram instalados pelo Windows Installer (MSI), mas MSICondition é usado com mais frequência para instalações do Project ou do Visio. O valor que você especificar para o atributo MSICondition pode ser uma versão licenciada ou de varejo do produto, desde que a versão do produto tenha sido instalada usando o MSI.You can specify any Office product that was installed by Windows Installer (MSI), but MSICondition is most commonly used for Project or Visio installations. 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 reconhecerá a versão 2007, 2010, 2013 e 2016 do produto do Office que você especificar. No entanto, não é possível especificar uma versão específica. Por exemplo, não é possível ter MSICondition aparência específica para o Visio Standard 2013. MSICondition procurará todas as instalações baseadas em MSI do Visio Standard, incluindo o Visio Standard 2007, o Visio Standard 2010, o Visio Standard 2013 e o Visio Standard 2016.MSICondition will recognize 2007, 2010, 2013, and 2016 versions of the Office product that you specify. But, you can't specify a particular version. For example, you can't have MSICondition look specifically for Visio Standard 2013. 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.

O valor que você especificar para o atributo MSICondition é a ID de instalação que é encontrada no arquivo setup.xml no {Product}. Pasta WW dos arquivos de instalação do para a sua versão atual do Office. Por exemplo, o arquivo setup.xml para o Visio Professional 2016 se encontra na pasta VisPro. SS. Você pode especificar vários tipos de um produto do Office, separados por uma vírgula. Por exemplo, você pode especificar "PrjStd, PrjStdR, PrjPro, PrjProR" para procurar instalações do Project Standard ou do Project Professional, tanto de licenciamento quanto de varejo.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. For example, the Setup.xml file for Visio Professional 2016 is found in the VisPro.WW folder. You can specify multiple types of an Office product, separated by a comma. For example, you can specify "PrjStd,PrjStdR,PrjPro,PrjProR" to look for installations of Project Standard or Project Professional, either volume licensed or retail.

Observação

  • Recomendamos que você remova os produtos existentes baseados em MSI do Office como parte da instalação dos produtos especificados no arquivo XML. Para remover produtos baseados em MSI existentes, use o elemento RemoveMSI.We recommend that you remove the existing MSI-based Office products as part of installing the products specified in your XML file. To remove existing MSI-based products, use the RemoveMSI element.

Exemplo de atributo MSIConditionExample of MSICondition attribute

No exemplo a seguir, o cliente de área de trabalho do Project online será instalado no dispositivo somente se uma versão baseada em MSI do Project Standard já estiver instalada no dispositivo. Além disso, o Project Standard será removido do dispositivo como parte da instalação do cliente de desktop do Project online.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. 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 idiomaLanguage element

Define quais idiomas devem ser baixados ou instalados. Se você definir vários idiomas, o primeiro idioma no arquivo de configuração determinará a cultura da interface do usuário do Shell, incluindo atalhos, menus de contexto e dicas de ferramentas de atalho. Se você decidir que deseja alterar o idioma da interface do usuário do Shell após uma instalação inicial, precisará desinstalar e reinstalar o 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.

ExemploExample

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

Atributo ID (parte do elemento Language)ID attribute (part of Language element)

Obrigatório.Required.

Define a ID do idioma a ser baixado ou instalado.Defines the ID of the language to download or install.

Valores de exemploExample 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"

Confira a lista de todos os idiomas em Idiomas, códigos de cultura e idiomas de revisão de texto complementares.For a list of all languages, see Languages, culture codes, and companion proofing languages.

Para obter mais informações sobre MatchPreviousMSI, confira Remover as versões de MSI existentes do Office durante a atualização para os Microsoft 365 Apps.For more information about MatchPreviousMSI, see Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps.

MatchOS e MatchInstalled não podem instalar os idiomas do sistema operacional se o Office não oferecer suporte a esse idioma ou se a ODT não puder encontrar o pacote de idioma correto nos arquivos de origem locais. Para ajudar a resolver esse problema, recomendamos que você especifique um idioma de backup e permita que o ODT use o CDN do Office para arquivos ausentes. Para fazer isso, use o atributo Fallback e o atributo AllowCdnFallBack.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. 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. To do so, use the Fallback attribute and AllowCdnFallBack attribute.

MatchInstalled pode ser usado somente se houver pelo menos um produto com Clique para executar. Não é possível usá-lo com a opção/download da ODT. Para obter mais informações sobre o MatchInstalled, confira Visão geral sobre a implantação de idiomas e Criar pacotes dinâmicos, enxutos e universais para os Microsoft 365 Apps.MatchInstalled can be used only if there is at least one Click-to-Run product already installed. It can't be used with the /download switch for the ODT. For more information about MatchInstalled, see Overview of deploying languages and Build dynamic, lean, and universal packages for Microsoft 365 Apps.

Atributo Fallback (parte do elemento Language)Fallback attribute (part of Language element)

Opcional.Optional.

Ao usar MatchOS, recomendamos que você especifique um idioma de fallback para ser instalado quando um idioma correspondente não for compatível com o Office ou não puder ser encontrado nos arquivos de origem locais. Para fazer isso, use o atributo "Fallback". Para saber mais, confira Instalar os mesmos idiomas do sistema operacional.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. To do so, use the "Fallback" attribute. For more information, see Install the same languages as the operating system.

Valores de exemplo:Example values:

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

Atributo TargetProduct (parte do elemento Language)TargetProduct attribute (part of Language element)

Opcional.Optional.

Ao usar MatchInstalled, você pode especificar se deseja corresponder à lista de idiomas já instalados para um produto específico ou a combinação de todos os produtos instalados. Para direcionar um produto específico, você pode especificar qualquer ID de produto suportado. Se quiser combinar os idiomas de todos os produtos já instalados, você especifica "Todos". O ODT instalará então o novo produto com o mesmo conjunto de idiomas que o especificado no TargetProduct.When using MatchInstalled, you can specify if you want to match the list of already installed languages for a specific product or the combination of all installed products. To target a specific product, you can specify any supported product ID. If you want to match the languages of all already installed products, you specify "All". ODT will then install the new product with the same set of languages as the one specified in TargetProduct.

Se não houver TargetProduct especificado com MatchInstalled, o ODT tentará corresponder ao mesmo ID do Produto ao qual o rótulo de idioma pertence no arquivo de configuração.If there is no TargetProduct specified with MatchInstalled, the ODT will attempt to match the same Product ID that the Language tag belongs to in the configuration file. Por exemplo, se você estiver usando MatchInstalled ao instalar o “VisioProRetail” sem um TargetProduct, a ODT tentará corresponder os idiomas já instalados para este produto.For example, if you are using MatchInstalled while installing "VisioProRetail" without a TargetProduct, ODT will attempt to match the already installed languages for this product.

Valores de exemplo:Example values:

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

Elemento DisplayDisplay element

Define o que o usuário vê quando o Office é instalado.Defines what the user sees when Office is installed.

ExemploExample

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

Atributo Level (parte do elemento Display)Level attribute (part of Display element)

Opcional. O padrão é definido para Completo se não for especificado.Optional. Default is set to Full if not specified.

Se o Nível estiver definido como Nenhum, o Office será instalado sem interface do usuário: nenhuma barra de progresso, telas de conclusão, mensagens de erro ou outra interface do usuário serão exibidas.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 o Nível estiver definido como Completo, o Office será instalado com a experiência de instalação normal.If Level is set to Full, Office is installed with the normal installation experience.

Valores permitidos:Allowed values:

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

Atributo AcceptEULA (parte do elemento Display)AcceptEULA attribute (part of Display element)

Opcional. O padrão é FALSO, caso não especificado.Optional. Defaults to FALSE if not specified.

Se AcceptEULA estiver definida como VERDADEIRO, o usuário não verá uma caixa de diálogo de termos de licença para software da Microsoft. Se esse atributo estiver definido para FALSO ou não for incluído, o usuário poderá ver uma caixa de diálogo de termos de licença para software da Microsoft. Recomendamos que os administradores definam AcceptEULA para VERDADEIRO.If AcceptEULA is set to TRUE, the user does not see a Microsoft Software License Terms dialog box. If this attribute is set to FALSE or is not included, the user may see a Microsoft Software License Terms dialog box. We recommend that administrators set AcceptEULA to TRUE.

Valores permitidos:Allowed values:

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

Observação

Se você implantar uma versão do Office antes da Versão 1803, essa configuração será aplicada apenas se você fizer a instalação com a conta do usuário. O Microsoft Endpoint Configuration Manager ou outras ferramentas de distribuição de software que utilizam a conta do SISTEMA para a instalação não aplicará a configuração.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.

Elementos de ExcludeAppExcludeApp element

Define quais produtos do Microsoft 365 aplicativos não devem ser instalados. O OneDrive é instalado automaticamente quando você instala os aplicativos do Microsoft 365 ou instala aplicativos individuais, como o Word, Excel, PowerPoint, Publisher, Visio ou Skype. Se você não quiser instalar o OneDrive com esses aplicativos, use o elemento ExcludeApp para remover. Para saber mais, confira Excluir o OneDrive ao instalar os Microsoft 365 Apps ou outros aplicativos.Defines which Microsoft 365 Apps products should not be installed. OneDrive is automatically installed when you install Microsoft 365 Apps or install individual applications, such as Word, Excel, PowerPoint, Publisher, Visio, or Skype. If you don't want OneDrive installed with those applications, use the ExcludeApp element to remove it. For more information, see Exclude OneDrive when installing Microsoft 365 Apps or other applications.

ExemploExample

<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 um arquivo de configuração com ExcludeApp for usado para instalar o Office em um dispositivo que já tem os Microsoft 365 Apps instalados, a configuração ExcludeApp será tratada de forma diferente com base na lista de idiomas: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 a lista de idiomas no arquivo de configuração incluir todos os idiomas instalados, a configuração ExcludeApp no arquivo substituirá qualquer configuração existente de ExcludeApp no dispositivo. Isso também é verdadeiro se a lista de idiomas no arquivo de configuração incluir todos os idiomas instalados e outros idiomas.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. This is also true if the list of languages in the configuration file includes both all the installed languages and additional languages.
  • Se a lista de idiomas no arquivo de configuração não inclui todos os idiomas instalados, a configuração ExcludeApp no arquivo de configuração será combinada com a configuração ExcludeApp no 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.

Atributo da ID (parte do elemento ExcludeApp)ID attribute (part of ExcludeApp element)

Obrigatório.Required.

Define a ID do produto que não deve ser instalada.Defines the ID of the product that should not be installed.

Valores permitidos: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"

Para o OneDrive for Business, use o Groove. Para o Skype for Business, use o Lync.For OneDrive for Business, use Groove. For Skype for Business, use Lync.

Para obter mais informações sobre o Microsoft Teams, confira Implantar o Microsoft Teams com o Microsoft 365 Apps.For more information about Microsoft Teams, see Deploy Microsoft Teams with Microsoft 365 Apps.

Elemento PropertyProperty element

Define determinadas propriedades e comportamentos do Office.Defines certain Office behaviors and properties.

ExemploExample

<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"/>

Atributo Name (parte do elemento Property)Name attribute (part of Property element)

Obrigatório.Required.

Define a propriedade específica cujo valor você deseja definir.Defines the specific property whose value you want to set.

Atributo Value (parte do elemento Property)Value attribute (part of Property element)

Define o valor da propriedade nomeada.Defines the value of the named property.

Propriedade AUTOACTIVATE (parte do elemento Property)AUTOACTIVATE property (part of Property element)

Opcional. O padrão é 0, caso não especificado.Optional. Default is 0 if not specified.

Como os Microsoft 365 Apps estão configurados para ativar automaticamente, você não deve definir essa propriedade para os produtos do Microsoft 365 aplicativos. Para outros produtos, você pode definir AUTOATIVAR para 1 para que o produto seja ativado automaticamente.Because Microsoft 365 Apps is set to activate automatically, you should not set this property for Microsoft 365 Apps products. For other products, you can set AUTOACTIVATE to 1 to have the product activate automatically.

Valores permitidos:Allowed values:

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

Propriedade FORCEAPPSHUTDOWN (parte do elemento Property)FORCEAPPSHUTDOWN property (part of Property element)

Opcional. O padrão é FALSO, caso não especificado.Optional. Default is FALSE if not specified.

Quando definido como TRUE, força os aplicativos que estejam impedindo a instalação do Office a serem desligados. Poderá ocorrer perda de dados.When set to TRUE, forces any apps that are blocking the install of Office to shut down. Data loss may occur.

Valores permitidos:Allowed values:

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

Propriedade PACKAGEGUID (parte do elemento Property)PACKAGEGUID property (part of Property element)

Opcional.Optional.

Por padrão, pacotes App-V criados pela ODT compartilham a mesma ID de pacote App-V. os administradores podem usar PACKAGEGUID para especificar uma ID de pacote diferente. Isso permite que você publique vários pacotes App-V do Office em um servidor de gerenciamento de App-V. No entanto, isso não permite que você implante mais de um pacote de aplicativos do Office para um único computador. Você pode usar a ODT para criar pacotes App-V para aplicativos do Microsoft 365. não há suporte para a criação de pacotes para as versões licenciadas por volume do Office Professional Plus ou Office Standard.By default, App-V packages created by the ODT share the same App-V Package ID. Administrators can use PACKAGEGUID to specify a different Package ID. This allows you to publish multiple App-V packages of Office to an App-V Management Server. But, this doesn't enable you to deploy more than one Office App-V package to a single computer. You can use the ODT to create App-V packages for Microsoft 365 Apps. Creating packages for the volume-licensed versions of Office Professional Plus or Office Standard is not supported.

A ID do pacote deve seguir o formato do exemplo e só pode usar estes caracteres: 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

Caso use qualquer outro caractere, o pacote do App-V será criado com a ID padrão do pacote.If you use any other characters, the App-V package is created with the default Package ID.

Valores de exemplo:Example values:

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

Propriedade SharedComputerLicensing (parte do elemento Property)SharedComputerLicensing property (part of Property element)

Opcional. O valor padrão é 0, caso não especificado.Optional. Default value is 0 if not specified.

Defina SharedComputerLicensing como 1 se você implantar os Microsoft 365 Apps para computadores compartilhados usando os Serviços de Área de Trabalho Remota.Set SharedComputerLicensing to 1 if you deploy Microsoft 365 Apps to shared computers by using Remote Desktop Services.

Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Aplicativos do Microsoft 365.For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valores permitidos:Allowed values:

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

Propriedade SCLCacheOverride (parte do elemento Property)SCLCacheOverride property (part of Property element)

Opcional. O valor padrão é 0, caso não especificado.Optional. Default value is 0 if not specified.

Defina SCLCacheOverride para 1 se você estiver usando a ativação de computador compartilhado e deseja movimentar o token de licenciamento. Use o em conjunto com o SCLCacheOverrideDirectory. Isso só será necessário se você optar por mover o token de licenciamento do seu local padrão. Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Microsoft 365 Apps.Set SCLCacheOverride to 1 if you're using shared computer activation and you want to roam the licensing token. Use in conjunction with SCLCacheOverrideDirectory. This is only needed if you choose to move the licensing token from its default location. For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valores permitidos:Allowed values:

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

Propriedade SCLCacheOverrideDirectory (parte do elemento Property)SCLCacheOverrideDirectory property (part of Property element)

Opcional.Optional.

Defina SCLCacheOverrideDirectory para especificar um local de pasta para o token de licenciamento se você estiver usando a ativação de computador compartilhado e deseja movimentar o token de licenciamento. Use o em conjunto com o SCLCacheOverride. Isso só será necessário se você optar por mover o token de licenciamento do seu local padrão.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. Use in conjunction with SCLCacheOverride. This is only needed if you choose to move the licensing token from its default location.

Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Microsoft 365 Apps.For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Valores de exemplo: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%"

Propriedade DeviceBasedLicensing (parte do elemento Property)DeviceBasedLicensing property (part of Property element)

Opcional. O valor padrão é 0, caso não especificado.Optional. Default value is 0 if not specified.

Define o modo de licenciamento do Office para ativação baseada em dispositivo. Para saber mais, confira Licenciamento baseado em dispositivo para Microsoft 365 Apps para Grandes Empresas.Defines the Office licensing mode for device-based activation. For more information, see Device-based licensing for Microsoft 365 Apps for enterprise.

Valores permitidos:Allowed values:

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

Propriedade PinIconsToTaskBar (parte do elemento Property)PinIconsToTaskBar property (part of Property element)

Opcional. O valor padrão é VERDADEIRO se não especificado.Optional. The default value is True if not specified.

Define se os ícones de atalho para produtos do Office são adicionados na barra de tarefas do Windows no Windows 7 e 8.1. Se você instalar o Office usando uma conta do sistema, o que é comum ao implantar com o Microsoft Endpoint Configuration Manager, os ícones não serão fixados mesmo se essa propriedade estiver definida como Verdadeira.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.

Valores permitidos:Allowed values:

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

Observação

Os aplicativos do Microsoft 365 não têm mais suporte no Windows 7. Para obter mais informações, confira fim do suporte do Windows 7 e os Microsoft 365 Apps.Microsoft 365 Apps is no longer supported on Windows 7. For more information, see Windows 7 end of support and Microsoft 365 Apps.

Elemento RemoveRRemove element

Define quais produtos e idiomas devem ser removidos de uma instalação anterior do Microsoft 365 Apps. Para remover um idioma instalado, você deve fornecer o produto e o idioma, como no exemplo. Para remover todos os idiomas instalados, não inclua o atributo de idioma. Nesse caso, a ODT descobre automaticamente e remove todos os idiomas instalados para o produto.Defines which products and languages to remove from a previous installation of Microsoft 365 Apps. To remove an installed language, you must provide both the product and the language, as in the example. To remove all the installed languages, do not include the language attribute. In that case, the ODT automatically discovers and removes all installed languages for the product.

Para saber mais, confira Visão geral da Ferramenta de Implantação do Office.For more information, see Overview of the Office Deployment Tool.

ExemploExample

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

Atributo All (parte do elemento Remove)All attribute (part of Remove element)

Opcional.Optional. O valor padrão é FALSO caso não seja especificado.The default value is FALSE if not specified.

Se definido como VERDADEIRO, todos os produtos e idiomas dos Microsoft 365 Apps serão removidos, incluindo o Project e o Visio.If set to TRUE, all Microsoft 365 Apps products and languages will be removed, including Project and Visio.

Valores permitidos:Allowed values:

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

Elemento UpdatesUpdates element

Define como o Office será atualizado após sua instalação.Defines how Office is updated after it's installed.

ExemploExample

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

Atributo Enabled (parte do elemento Updates)Enabled attribute (part of Updates element)

Opcional. O valor padrão é VERDADEIRO se não especificado.Optional. The default value is TRUE if not specified.

Se definido como TRUE, o Office verificará se há atualizações. Se definido como FALSE, o Office não verificará se há atualizações, mas o usuário pode verificar isso acessando Arquivo > Conta > Opções de Atualização > Atualizar Agora.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.

Valores permitidos:Allowed values:

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

Atributo UpdatePath (parte do elemento Updates)UpdatePath attribute (part of Updates element)

Opcional. O padrão é a CDN, caso não seja especificada.Optional. Defaults to the CDN if not specified.

Define de onde vêm as atualizações do Office. UpdatePate pode especificar um caminho de rede, local ou HTTP de uma fonte para arquivos de instalação do Office. Variáveis de ambiente podem ser usadas para rede ou caminhos locais.Defines where the updates for Office come from. UpdatePath can specify a network, local, or HTTP path of a source for Office installation files. Environment variables can be used for network or local paths.

Se você usar a Política de Grupo com os arquivos de modelo administrativo (ADMX/ADML) do Office, será possível definir UpdatePath usando a configuração de política Caminho de Atualização. Você pode encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.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. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valores de exemplo:Example values:

Atributo TargetVersion (parte do elemento Updates)TargetVersion attribute (part of Updates element)

Opcional. O padrão é a versão mais recente disponível, caso não seja especificada.Optional. Defaults to the latest version from the specified update path.

Define a versão de atualização do Office para o. Se TargetVersion estiverem definidas para um número de Build específico, o Office tentará atualizá-la para essa versão.Defines which version Office updates to. If TargetVersion is set to a specific build number, Office attempts to update to that version.

Se usar a Política de grupo com os arquivos de modelo administrativo (ADMX/ADML) do Office, você poderá definir TargetVersion usando a configuração de política Versão de Destino. Você pode encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.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. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valores de exemplo:Example values:

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

Atributo Deadline (parte do elemento Updates)Deadline attribute (part of Updates element)

Opcional.Optional.

Define um prazo no qual as atualizações deverão ser aplicadas. A data limite é especificada em UTC (Tempo Universal Coordenado). Você pode usar tempo Limite com Versão de Destino para garantir que o Office seja atualizado para uma versão específica em uma data específica. É recomendável definir o prazo pelo menos uma semana no futuro para dar aos usuários tempo de instalar as atualizações.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.

Antes do prazo, os usuários recebem vários lembretes para instalar as atualizações. Se o Office não for atualizado no prazo, os usuários verão uma notificação de que as atualizações serão aplicadas em 15 minutos. Isso oferece aos usuários a oportunidade de salvar os documentos do Office em que eles estão trabalhando e fechar os programas do Office que estão abertos. Se os usuários não fecharem os programas do Office, os programas serão fechados automaticamente quando os 15 minutos tiverem terminado, o que pode resultar em perda de dados.Prior to the deadline, users receive multiple reminders to install the updates. If Office isn't updated by the deadline, users see a notification that the updates will be applied in 15 minutes. This gives users the opportunity to save the Office documents that they are working on and to close any Office programs that are open. 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.

Depois que os programas do Office forem fechados, as atualizações serão aplicadas automaticamente. A data limite só se aplica a um conjunto de atualizações. Se quiser usar uma data limite para garantir que o Office fique sempre atualizado, você deverá alterar a data limite sempre que uma nova atualização para o Office estiver disponível.After the Office programs are closed, the updates are applied automatically. The deadline only applies to one set of updates. 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.

Para usar esse atributo, o Office deverá estar executando pelo menos o Service Pack 1 (15.0.4569.1507). Se você usar a Política de Grupo com os arquivos do Modelo Administrativo (ADMX/ADML) do Office, será possível definir a Data Limite usando a configuração de política de Data Limite de Atualização. Você pode encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.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. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Valor de exemplo:Example value:

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

Atributo Channel (parte do elemento Updates)Channel attribute (part of Updates element)

Opcional. O padrão é Atual.Optional. The default is Current.

Define o canal a ser usado para atualizar o Office após a instalação. Há dois atributos de canal: o canal para o Adicionar elemento é usado para especificar um canal de atualização durante a instalação do Office, e o canal para o elemento Update é usado para alterar o canal para uma instalação existente do Office.Defines which channel to use for updating Office after it is installed. 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.

Para obter mais informações sobre canais de atualização, confira Visão geral de canais de atualização para os Microsoft 365 Apps.For more information about update channels, see Overview of update channels for Microsoft 365 Apps.

Se usar a Política de Grupo com Arquivos de Modelo Administrativo (ADMX/ADML) do Office, você poderá definir o Channel usando a configuração da política Canal de Atualização. Você pode encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações. Se for habilitada, essa configuração de política de grupo terá precedência sobre o valor de Channel definido usando a Ferramenta de Implantação do Office.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. If enabled, this Group Policy setting takes precedence over the Channel value set by using the Office Deployment Tool.

Valores permitidos: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"

Observação

  • Para usar esses valores de atributo, você precisa estar usando pelo menos a versão 16.0.12827.20268 da Ferramenta de Implantação do Office, lançada na terça-feira, 9 de junho de 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.
  • Os valores permitidos anteriores de cada canal de atualização ainda podem ser usados, o que significa que você não precisa atualizar os arquivos XML de configuração mais antigos.Previous allowed values for each update channel can still be used, which means you don't have to update your older configuration XML files.
  • O Canal Beta (às vezes chamado de Participante do Programa Windows Insider - Modo Rápido) não é uma compilação compatível, portanto, deve ser usado somente em ambientes de teste e por um pequeno grupo de usuários selecionados, como a equipe de TI ou desenvolvedores de aplicativos.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 você estiver implantando o Office Professional Plus 2019, que é uma versão licenciada de volume do Office, há um canal de atualizações diferente que você precisa usar: PerpetualVL2019. Para saber mais, confira Canal de atualizações para o 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

Opcional.Optional.

Especifica se as versões 2007, 2010, 2013 ou 2016 do Office, Visio e Project que foram instaladas usando o Windows Installer (MSI) serão desinstaladas do computador antes da instalação de um produto específico, como o 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.

Recomendamos que você desinstale todas as versões anteriores do Office antes de instalar os aplicativos do Microsoft 365. Para obter mais informações sobre como usar o RemoveMSI, confira Remover as versões do MSI existentes do Office durante a atualização para o Microsoft 365 Apps.We recommend that you uninstall any previous versions of Office before installing Microsoft 365 Apps. For more information about using RemoveMSI, see Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps.

Atributo IgnoreProduct (parte do elemento RemoveMSI)IgnoreProduct attribute (part of RemoveMSI element)

Opcional.Optional.

Se uma ID for especificada, o produto Windows Installer (MSI) não será desinstalado do computador.If an ID is specified, that Windows Installer (MSI) product won't be uninstalled from the computer.

Valores de exemplo:Example values:

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

Elemento AppSettingsAppSettings element

Opcional.Optional.

Define as preferências do aplicativo para os aplicativos do Microsoft 365, incluindo as notificações de macro do VBA, os locais de arquivos padrão e o formato de arquivo padrão. Para criar um arquivo de configuração com as preferências do aplicativo, recomendamos que você use a Ferramenta de personalização do Office para o Clique-para-Executar, um aplicativo Web com uma interface de usuário completa. Você também pode usar a ferramenta para saber mais sobre as preferências de aplicativos disponíveis.Defines application preferences for Microsoft 365 Apps, including VBA Macro notifications, default file locations, and default file format. 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. You can also use the tool to learn more about the available application preferences.

Para obter mais informações sobre as preferências do aplicativo, consulte Aplicar preferências de aplicativo e Aplicar preferências de aplicativo a uma instalação existente do Office.For more information about application preferences, see Apply application preferences and Apply application preferences to an existing installation of Office.

ExemploExample

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