Opções de configuração da Ferramenta de Implantação do Office

Use a ODT (Ferramenta de Implantação do Office) para baixar e implantar o Microsoft 365 Apps nos computadores cliente. A ODT fornece mais controle sobre a instalação, permitindo que você defina quais produtos e idiomas instalar, como atualizá-los e se exibir a experiência de instalação aos usuários. Este artigo explica todas as opções disponíveis na ferramenta. Para saber como usar a ferramenta, consulte Visão geral da Ferramenta de Implantação do Office.

Exemplo de um arquivo de configuração padrão

A ODT é composta por 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 64 bits do Microsoft 365 Apps ou editar o arquivo para instalar a edição em inglês de 64 bits do Microsoft 365 Apps com o Contrato de Licença de Usuário Final (EULA) aceito automaticamente e sem o Editor.

Ao criar o arquivo de configuração, recomendamos começar com um arquivo de exemplo e atualizá-lo com as opções apropriadas para seu ambiente. Você pode começar copiando e colando o exemplo a seguir em um arquivo de texto e salvando-o com um nome de sua escolha. Use o arquivo para modificar os elementos e atributos XML e use o restante deste artigo para saber mais detalhes sobre cada um dos elementos e atributos.

Esse arquivo de configuração inclui os elementos e atributos mais usados e pode ser usado para baixar e instalar o Microsoft 365 Apps em um computador cliente.

<Configuration>
  <Add SourcePath="\\Server\Share" 
       OfficeClientEdition="64"
       Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
    <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
  </Add>
  <Updates Enabled="TRUE" 
           UpdatePath="\\Server\Share" />
   <Display Level="None" AcceptEULA="TRUE" />  
</Configuration>

Elemento add

Define os produtos e idiomas a serem baixados ou instalados.

Exemplo

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

Atributo SourcePath (parte do elemento Add)

Opcional.

Define o local dos arquivos de instalação do Microsoft 365 Apps. Se a ODT for executada no modo download, defina onde salvar os arquivos. Se não estiver incluído, o ODT procura arquivos de instalação na mesma pasta que a ferramenta e usa a CDN (Rede de Distribuição de Conteúdo). Se não estiverem incluídos e a ODT for executada no modo de download, os arquivos de instalação do Microsoft 365 Apps serão baixados na mesma pasta que a ferramenta.

Quando você baixa o Microsoft 365 Apps para uma pasta que já contém essa versão do Microsoft 365 Apps, a ODT conserva a largura de banda da rede baixando somente os arquivos ausentes. Por exemplo, se você usar a ODT para baixar o Microsoft 365 Apps em inglês e alemão para uma pasta que já contenha o Microsoft 365 Apps em inglês, somente o pacote de idiomas alemão será baixado.

Valores de exemplo:

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

O valor SourcePath não deve incluir a parte /Office ou o nome da pasta na qual os dados do Office são baixados.

Atributo Version (parte do elemento Add)

Opcional. O padrão é a versão mais recente disponível se não for especificada.

Ao usar o atributo Version, recomendamos incluir o atributo Channel também. Se você não incluir o atributo Channel, o canal padrão será usado, o que pode não corresponder à versão especificada.

Se o Microsoft 365 Apps já estiver instalado em um dispositivo, você poderá usar Version="MatchInstalled" para instalar a mesma versão, mesmo que uma versão mais recente esteja disponível. Essa configuração pode facilitar a adição de pacotes de idiomas ou o Visio e o Project sem atualizar para uma versão mais recente. Quando você usa Version="MatchInstalled", o atributo Channel é necessário.

Valores de exemplo:

• Versão = "16.0.15330.20306"
• Versão="MatchInstalled"

Atributo OfficeClientEdition (parte do elemento Add)

Opcional.

Define se a edição de 32 bits ou 64 bits do Microsoft 365 Apps é baixada ou instalada. Se o Microsoft 365 Apps não estiver instalado no dispositivo e o OfficeClientEdition não estiver definido, a ODT selecionará automaticamente a edição de 64 bits. No entanto, ele selecionará a edição de 32 bits se o dispositivo usar uma versão de 32 bits do Windows ou tiver menos de 4 GB de RAM. Se o Microsoft 365 Apps estiver instalado e o OfficeClientEdition não estiver especificado, a ODT corresponderá à arquitetura da instalação existente do Microsoft 365 Apps. Se o Microsoft 365 Apps estiver instalado e o OfficeClientEdition for especificado, ele deverá corresponder à arquitetura já instalada. Caso contrário, a instalação falhará, pois não há suporte para arquiteturas mistas.

Valores permitidos:

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

Atributo Channel (parte do elemento Add)

Opcional.

Define qual canal usar para instalar o Microsoft 365 Apps. Se o Microsoft 365 Apps não estiver instalado no dispositivo, a configuração padrão para o atributo do Canal será Atual. Se o Microsoft 365 Apps estiver instalado no dispositivo e o atributo de canal não for especificado, a ODT corresponderá ao canal da instalação existente.

Esse valor determina o canal a ser instalado, independentemente de um canal de atualização especificado opcionalmente no elemento Atualizações ou por meio da Configuração da Política de Grupo. Se houver essa configuração com um canal de atualização diferente, a troca de canal será executada após a instalação durante o próximo ciclo de atualização. Para obter mais informações, consulte Alterar o canal de atualização do Microsoft 365 Apps.

Para obter mais informações sobre canais de atualização, confira Visão geral de canais de atualização para o Microsoft 365 Apps.

Valores permitidos:

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

Se você estiver implantando o Canal de Manutenção em Longo Prazo do Microsoft Office (LTSC) Professional Plus 2024 ou o Office LTSC Standard 2024, que são versões licenciadas por volume, há um canal de atualização diferente que você precisa usar: PerpetualVL2024. Para obter mais informações, consulte Canal de atualização para o Office LTSC 2024.

Se você estiver implantando o Canal de Manutenção em Longo Prazo do Microsoft Office (LTSC) Professional Plus 2021 ou o Office LTSC Standard 2021, que são versões licenciadas por volume, há um canal de atualização diferente que você precisa usar: PerpetualVL2021. Para obter mais informações, consulte Canal de atualizações do Office LTSC 2021.

Se estiver implantando o Office Professional Plus 2019 ou o Office Standard 2019, que são versões licenciadas por volume, há um canal de atualização diferente que você precisa usar: PerpetualVL2019. Para obter mais informações, confira Canal de atualização do Office 2019.

Atributo DownloadPath (parte do elemento Add)

Opcional. O padrão é a CDN se não for especificado.

Define de onde os arquivos de instalação são baixados ao executar a ODT no modo de download. Mais comumente usado para distribuir idiomas e produtos específicos para o Microsoft 365 Apps de um local central na rede para outro local. Você deve especificar uma versão ao usar DownloadPath, conforme mostrado no exemplo.

Valores de exemplo:

• DownloadPath="\\servera\share"

Exemplo

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

Opcional. O padrão é False se não for especificado.

Para usar a CDN como uma fonte de backup para pacotes de idiomas, inclua o atributo "AllowCdnFallback" no arquivo de configuração, conforme mostrado no exemplo.

Quando você instala idiomas, a ODT primeiro procura arquivos de origem no local fornecido 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.

Valores permitidos:

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

Exemplo

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

Atributo MigrateArch (parte de Adicionar elemento)

Opcional. O padrão é False se não for especificado.

Se definido como TRUE, sua instalação existente do Microsoft 365 Apps será alterada para a arquitetura (às vezes chamada de número de bit) especificada no atributo OfficeClientEdition. Por exemplo, você pode usar esse atributo para alterar uma instalação de 32 bits do Microsoft 365 Apps para uma instalação de 64 bits.

Para obter mais informações sobre como usar o MigrateArch, consulte Alterar uma instalação do Microsoft 365 Apps de 32 bits para 64 bits.

Atributo OfficeMgmtCOM (parte de Adicionar elemento)

Opcional. O padrão é False se não for especificado.

Se definido como True, um objeto COM será registrado, o que é necessário para permitir que soluções de gerenciamento de atualizações (por exemplo, o Microsoft Configuration Manager) gerenciem as atualizações. Necessário ao usar o Gerenciador de Configurações para atualizações do Microsoft 365 Apps. Quando o objeto COM do Office está habilitado, a opção Atualizar Agora na página Conta do Microsoft 365 Apps é desabilitada automaticamente para dispositivos cliente.

Para obter mais informações, confira Gerenciar atualizações para os Microsoft 365 Apps com o Microsoft Configuration Manager.

Valores permitidos:

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

Exemplo

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

Elemento Product

Define quais produtos baixar ou instalar. 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 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 nas instalações existentes do Microsoft 365 Apps.

Exemplo

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

Obrigatório.

Define a ID do produto a ser baixado e instalado.

Valores de exemplo:

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

Para obter uma lista de todas as IDs de produto com suporte, confira IDs de produto sem suporte na Ferramenta de Implantação do Office para o Clique para Executar

Atributo MSICondition (parte do elemento Product)

Opcional.

Permite que você controle a instalação de um produto do Office, conforme especificado pelo atributo de ID, com base no fato de um determinado produto do Office baseado em MSI já estar instalado no dispositivo. Por exemplo, se uma versão do Project Professional baseada em MSI já estiver instalada no dispositivo, instale o Cliente da Área de Trabalho do Project Online.

Você pode especificar qualquer produto do Office instalado pelo Windows Installer (MSI), mas o MSICondition é mais comumente usado para instalações do Project ou do Visio. O valor especificado para o atributo MSICondition pode ser uma versão licenciada por volume ou uma versão de varejo do produto, desde que essa versão do produto tenha sido instalada usando o MSI.

O MSICondition reconhece as versões de 2007, 2010, 2013 e 2016 do produto Office que você especificar. No entanto, você não pode especificar uma versão específica. Por exemplo, você não pode fazer com que o MSICondition procure especificamente o Visio Standard 2013. O MSICondition procura 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.

O valor especificado para o atributo MSICondition é a ID de Configuração encontrada no arquivo Setup.xml no {product}. Pasta WW dos arquivos de instalação da sua versão existente do produto Office. Por exemplo, o arquivo Setup.xml para Visio Professional 2016 é encontrado na pasta VisPro.WW. Vários tipos de produtos do Office podem ser especificados, 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, licenciado por volume ou comercial.

Exemplo de atributo MSICondition

No exemplo a seguir, o Cliente da Área de Trabalho do Project Online é 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 é removido do dispositivo como parte da instalação do Cliente de Área de Trabalho do Project Online.

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

Elemento Language

Define quais idiomas baixar ou instalar. Se você definir vários idiomas, o primeiro idioma do arquivo de configuração determinará a cultura de interface de usuário do Shell, incluindo atalhos, menus de contexto do botão direito e dicas de ferramentas. Se você quiser alterar o idioma da interface do usuário do Shell após a primeira instalação, deverá desinstalar e reinstalar o Microsoft 365 Apps.

Exemplo

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

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

Atributo ID (parte do elemento Language)

Obrigatório.

Define a ID do idioma a ser baixado e instalado.

Valores de exemplo

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

Certifique-se de que os idiomas especificados sejam compatíveis com o produto que você está instalando. Caso contrário, a instalação falhará.

Por exemplo, o Microsoft 365 Apps dá suporte a inglês (Reino Unido), francês (Canadá) e espanhol (México), mas o Project e o Visio não dão suporte a esses idiomas.

• Para obter uma lista de idiomas compatíveis com o Microsoft 365 Apps, consulte Idiomas, códigos de cultura e idiomas de revisão de texto complementares.
• Para obter uma lista de idiomas suportados pelo Visio, consulte Exibir idiomas suportados no aplicativo da área de trabalho do Visio.
• O Project dá suporte aos mesmos idiomas que o Visio.

Para obter mais informações sobre MatchPreviousMSI, consulte Remover versões MSI existentes do Office ao atualizar para o Microsoft 365 Apps.

MatchOS e MatchInstalled não poderão instalar os idiomas do sistema operacional se o Microsoft 365 Apps não for compatível com esse idioma ou se a ODT não encontrar o pacote de idiomas correto nos arquivos de origem locais. Para ajudar a resolver esse problema, recomendamos que você especifique um idioma de backup e permita que a ODT use a CDN para arquivos ausentes. Para fazer isso, use os atributos Fallback e AllowCdnFallBack.

MatchInstalled só poderá ser usado se houver pelo menos um produto Clique para Executar já instalado. Ela não pode ser usada com a opção /download para a ODT. Para obter mais informações sobre MatchInstalled, consulte Visão geral da implantação de linguagens e Criar pacotes dinâmicos, enxutos e universais para o Microsoft 365 Apps.

Atributo Fallback (parte do elemento Language)

Opcional.

Ao usar o MatchOS, especifique um idioma de fallback a ser instalado se o idioma correspondente não tiver suporte no Microsoft 365 Apps ou não estiver disponível nos arquivos de origem locais. Para fazer isso, use o atributo "Fallback". Para obter mais informações, consulte Instalar os mesmos idiomas do sistema operacional.

Valores de exemplo:

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

Atributo TargetProduct (parte do elemento Language)

Opcional.

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 para um produto específico, você pode especificar qualquer ID de produto compatível. Se você quiser corresponder aos idiomas de todos os produtos já instalados, especifique "Todos". Em seguida, a ODT instala o novo produto com o mesmo conjunto de idiomas especificado no TargetProduct.

Se não houver nenhum TargetProduct especificado com MatchInstalled, a ODT tentará corresponder à mesma ID do produto à qual a marca de idioma pertence no arquivo de configuração. Por exemplo, se você estiver usando MatchInstalled durante a instalação do "VisioProRetail" sem um TargetProduct, o ODT tentará corresponder aos idiomas já instalados para esse produto.

Valores de exemplo:

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

Elemento Display

Define o que o usuário vê quando o Microsoft 365 Apps é instalado.

Exemplo

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

Atributo Level (parte do elemento Display)

Opcional. O padrão é definido como Completo se não for especificado.

Se Level estiver definido como None, o Microsoft 365 Apps será instalado sem nenhuma interface do usuário: nenhuma barra de progresso, telas de conclusão, mensagens de erro ou outra interface do usuário serão exibidas.

Se Level estiver definido como Full, o Microsoft 365 Apps será instalado com a experiência de instalação normal.

Valores permitidos:

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

Atributo AcceptEULA (parte do elemento Display)

Opcional. O padrão é FALSE se não for especificado.

Se AcceptEULA estiver definido como TRUE, o usuário não verá uma caixa de diálogo Termos de Licença para Software Microsoft. Se esse atributo estiver definido como FALSO ou não estiver incluído, o usuário poderá ver uma caixa de diálogo Termos de Licença para Software Microsoft. Recomendamos que os administradores definam o AcceptEULA como TRUE.

Valores permitidos:

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

Elementos de ExcludeApp

Define quais produtos do Microsoft 365 Apps não devem ser instalados. O OneDrive é instalado automaticamente com o Microsoft 365 Apps ou com aplicativos individuais como o Word, Excel, PowerPoint, Publisher, Visio ou Skype. Se você não quiser que o OneDrive seja instalado com esses aplicativos, use o elemento ExcludeApp para removê-lo. Para obter mais informações, consulte Excluir o OneDrive ao instalar o Microsoft 365 Apps ou outros aplicativos.

Exemplo

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

Se um arquivo de configuração com ExcludeApp for usado para instalar o Office em um dispositivo que já tenha o Microsoft 365 Apps instalado, a configuração do ExcludeApp será tratada de forma diferente com base na lista de idiomas:

• Se o arquivo de configuração listar todos os idiomas já instalados no dispositivo, sua configuração ExcludeApp substituirá todas as configurações anteriores do ExcludeApp. Isso se aplica mesmo quando a lista de idiomas do arquivo inclui os idiomas instalados e idiomas extras.
• Se a lista de idiomas no arquivo de configuração não incluir todos os idiomas instalados, a configuração ExcludeApp no arquivo de configuração será combinada com a configuração ExcludeApp no dispositivo.

Atributo da ID (parte do elemento ExcludeApp)

Obrigatório.

Define a ID do produto que não deve ser instalado.

Valores permitidos:

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

Elemento Property

Define determinados comportamentos e propriedades do Microsoft 365 Apps.

Exemplo

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

Atributo Name (parte do elemento Property)

Obrigatório.

Define a propriedade específica cujo valor você deseja definir.

Atributo Value (parte do elemento Property)

Define o valor da propriedade nomeada.

Propriedade AUTOACTIVATE (parte do elemento Property)

Opcional. O padrão é 0 se não for especificado.

Como o Microsoft 365 Apps está configurado para ser ativado automaticamente, você não deve definir essa propriedade para produtos do Microsoft 365 Apps. Para outros produtos, você pode definir AUTOACTIVATE como 1 para que o produto seja ativado automaticamente.

Valores permitidos:

• Nome da propriedade="AUTOACTIVATE" value="0"
• Nome da propriedade="AUTOACTIVATE" value="1"

Propriedade FORCEAPPSHUTDOWN (parte do elemento Property)

Opcional. O padrão é FALSE se não for especificado.

Quando definido como TRUE, força todos os aplicativos que estão bloqueando a instalação do Microsoft 365 Apps a serem desligados. Pode ocorrer perda de dados.

Valores permitidos:

• Nome da propriedade="FORCEAPPSHUTDOWN" value="FALSE"
• Nome da propriedade="FORCEAPPSHUTDOWN" value="TRUE"

Propriedade PACKAGEGUID (parte do elemento Property)

Opcional.

Por padrão, os pacotes do App-V criados pela ODT compartilham a mesma ID de pacote do App-V. Os administradores podem usar PACKAGEGUID para especificar um ID de pacote diferente. Ele permite que você publique vários pacotes App-V de Microsoft 365 Apps em um Servidor de Gerenciamento App-V. No entanto, ele não permite que você implante mais de um pacote do Microsoft 365 Apps App-V em um único computador. Você pode usar a ODT para criar pacotes App-V para o Microsoft 365 Apps. Não há suporte para a criação de pacotes para as versões licenciadas por volume do Office Professional Plus ou do Office Standard.

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

Caso use qualquer outro caractere, o pacote do App-V será criado com a ID padrão do pacote.

Valores de exemplo:

• Nome da propriedade="PACKAGEGUID" value="12345678-ABCD-1234-ABCD-1234567890AB"

Propriedade SharedComputerLicensing (parte do elemento Property)

Opcional. O valor padrão será 0 se não for especificado.

Defina SharedComputerLicensing como 1 se você implantar o Microsoft 365 Apps em computadores compartilhados usando os Serviços de Área de Trabalho Remota.

Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Microsoft 365 Apps.

Valores permitidos:

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

Propriedade SCLCacheOverride (parte do elemento Property)

Opcional. O valor padrão será 0 se não for especificado.

Defina SCLCacheOverride como 1 se você estiver usando a ativação de computador compartilhado e quiser mover o token de licenciamento. Use essa propriedade com SCLCacheOverrideDirectory. Essa propriedade só será necessária se você optar por mover o token de licenciamento de seu local padrão. Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Microsoft 365 Apps.

Valores permitidos:

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

Propriedade SCLCacheOverrideDirectory (parte do elemento Property)

Opcional.

Defina SCLCacheOverrideDirectory para especificar um local de pasta para o token de licenciamento se você estiver usando a ativação de computador compartilhado e quiser fazer roaming do token de licenciamento. Use a propriedade com SCLCacheOverride. Essa propriedade só será necessária se você optar por mover o token de licenciamento de seu local padrão.

Para obter mais informações, confira Visão geral de ativação de computador compartilhado para os Microsoft 365 Apps.

Valores de exemplo:

• Nome da propriedade="SCLCacheOverrideDirectory" value="%appdata%\Microsoft"
• Nome da propriedade="SCLCacheOverrideDirectory" value="\\server\share\%username%"

Propriedade DeviceBasedLicensing (parte do elemento Propriedade)

Opcional. O valor padrão será 0 se não for especificado.

Define o modo de licenciamento do Office para ativação baseada em dispositivo. Para obter mais informações, consulte Licenciamento baseado em dispositivo para o Microsoft 365 Apps para Grandes Empresas.

Valores permitidos:

• Nome da propriedade="DeviceBasedLicensing" value="1"
• Nome da propriedade="DeviceBasedLicensing" value="0"

Propriedade PinIconsToTaskBar (parte do elemento Property)

Opcional. O valor padrão será True se não for especificado.

Define se os ícones de atalho para produtos do Microsoft 365 Apps são adicionados à barra de tarefas do Windows no Windows 7 e no Windows Windows 8.1. Se você instalar o Microsoft 365 Apps usando uma conta do sistema, o que é comum ao implantar com o Microsoft Configuration Manager, os ícones não serão fixados, mesmo que essa propriedade esteja definida como True.

Valores permitidos:

• Nome da propriedade="PinIconsToTaskbar" value="FALSE"
• Nome da propriedade="PinIconsToTaskbar" value="TRUE"

Propriedade TenantAssociationKey (parte do elemento Property)

Opcional.

Define a chave específica do locatário que associa um dispositivo à sua organização no Inventário no centro de administração do Microsoft 365 Apps. A chave de associação de locatário é um valor alfanumérico, normalmente com mais de 300 caracteres, que você pode encontrar no centro de administração do Microsoft 365 Apps entrando e selecionando Configuração na navegação à esquerda. Quando você incluir esse valor no XML, a Ferramenta de Implantação do Office registrará automaticamente os dispositivos conectados no Inventário.

Valores de exemplo:

• Nome da propriedade="TenantAssociationKey" Value="ReplaceWithTAK"

Exemplo

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

Exemplo

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

Elemento Remove

Define quais produtos e idiomas remover de uma instalação anterior do Microsoft 365 Apps. Para remover um idioma instalado, forneça 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 e remove automaticamente todos os idiomas instalados para o produto.

Para obter mais informações, consulte Visão geral da Ferramenta de Implantação do Office.

Exemplo

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

Atributo All (parte do elemento Remove)

Opcional. O valor padrão será FALSE se não for especificado.

Se definido como TRUE, todos os produtos e idiomas do Microsoft 365 Apps serão removidos, incluindo o Project e o Visio.

Valores permitidos:

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

Elemento Updates

Define como o Microsoft 365 Apps é atualizado após a instalação.

Exemplo

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

Atributo Enabled (parte do elemento Updates)

Opcional. O valor padrão será TRUE se não for especificado.

Se definido como TRUE, o Microsoft 365 Apps verificará se há atualizações. Se definido como FALSE, o Microsoft 365 Apps não marca se há atualizações, mas o usuário pode marcar se há atualizações acessando Arquivo>Conta>Opções> de AtualizaçãoAtualizar Agora.

Valores permitidos:

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

Atributo UpdatePath (parte do elemento Updates)

Opcional. O padrão é a CDN se não for especificado.

Define de onde vêm as atualizações para o Microsoft 365 Apps. O UpdatePath pode especificar um caminho de rede, local ou HTTP de uma origem para os arquivos de instalação. As variáveis de ambiente podem ser usadas para os caminhos de rede ou locais.

Se você usar a Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) para Office, poderá definir UpdatePath usando a configuração de política de Caminho de Atualização. É possível encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.

Valores de exemplo:

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

Atributo TargetVersion (parte do elemento Updates)

Opcional. O padrão é a versão mais recente do caminho de atualização especificado.

Define para qual versão o Microsoft 365 Apps será atualizado. Se TargetVersion estiver definido como um número de build específico, o Microsoft 365 Apps tentará atualizar para essa versão.

Se você usar a Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) do Office, poderá definir TargetVersion usando a configuração da política Versão de Destino. É possível encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.

Valores de exemplo:

• TargetVersion="16.0.12345.12345"
• TargetVersion=""

Atributo Deadline (parte do elemento Updates)

Opcional.

Define uma data limite a partir da qual as atualizações devem ser aplicadas. A data limite é especificada no UTC (Tempo Universal Coordenado). Você pode usar o Prazo com a Versão de Destino para garantir que o Microsoft 365 Apps seja atualizado para uma versão específica em uma data específica. Recomendamos que você defina a data limite como pelo menos uma semana no futuro para que os usuários tenham tempo de instalar as atualizações.

Antes do prazo, os usuários recebem vários lembretes para instalar as atualizações. Se o Microsoft 365 Apps não for atualizado até o prazo, os usuários verão uma notificação de que as atualizações serão aplicadas em 15 minutos. Essa notificação dá aos usuários a oportunidade de salvar os documentos nos quais estão trabalhando e fechar todos os aplicativos do Microsoft 365 que estão abertos. Se os usuários não fecharem os aplicativos do Microsoft 365, eles serão fechados automaticamente quando os 15 minutos acabarem, o que pode resultar em perda de dados.

Depois que o Microsoft 365 Apps for fechado, as atualizações serão aplicadas automaticamente. A data limite só se aplica a um conjunto de atualizações. Se você quiser usar um prazo para garantir que o Microsoft 365 Apps esteja sempre atualizado, altere o prazo sempre que uma nova atualização estiver disponível.

Para usar esse atributo, o Office deve estar executando pelo menos o Service Pack 1 (versão 15.0.4569.1507). Se você usar a Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) do Office, poderá definir o Prazo usando a configuração de política Atualizar Prazo. É possível encontrar essa configuração de política em Configuração do Computador\Políticas\Modelos Administrativos\Microsoft Office 2016 (Computador)\Atualizações.

Valor de exemplo:

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

Atributo Channel (parte do elemento Updates)

Opcional. O padrão é Atual.

Define qual canal usar para atualizar o Microsoft 365 Apps após a instalação. Há dois atributos de canal: o canal para o elemento Add é usado para especificar um canal de atualização durante a instalação do Microsoft 365 Apps, e o canal para o elemento Atualizações é usado para alterar o canal para uma instalação existente do Microsoft 365 Apps.

Para obter mais informações sobre canais de atualização, confira Visão geral de canais de atualização para o Microsoft 365 Apps.

Se você usar a Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) do Office, poderá definir o Canal usando a configuração de política do Canal de Atualização. É possível 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 Channel definido usando a Ferramenta de Implantação do Office.

Valores permitidos:

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

Se você implantar o Office LTSC Professional Plus 2024 ou o Office LTSC Standard 2024, que são versões licenciadas por volume, deverá usar este canal de atualização: PerpetualVL2024. Para obter mais informações, consulte Canal de atualização para o Office LTSC 2024.

Se você implantar o Office LTSC Professional Plus 2021 ou o Office LTSC Standard 2021, que são versões licenciadas por volume, deverá usar este canal de atualização: PerpetualVL2021. Para obter mais informações, consulte Canal de atualizações do Office LTSC 2021.

Se estiver implantando o Office Professional Plus 2019 ou o Office Standard 2019, que são versões licenciadas por volume do Office, há um canal de atualização diferente que você precisa usar: PerpetualVL2019. Para obter mais informações, confira Canal de atualização do Office 2019.

Elemento RemoveMSI

Opcional.

Especifica se as versões de 2007, 2010, 2013 ou 2016 do Office, do Visio e do Project que foram instaladas usando o Windows Installer (MSI) foram desinstaladas do computador antes da instalação do produto especificado, como o Microsoft 365 Apps.

Recomendamos que você desinstale todas as versões anteriores do Office antes de instalar o Microsoft 365 Apps. Para obter mais informações sobre como usar RemoveMSI, consulte Remover versões MSI existentes do Office ao atualizar para o Microsoft 365 Apps.

Atributo IgnoreProduct (parte do elemento RemoveMSI)

Opcional.

Se uma ID for especificada, o produto do Windows Installer (MSI) não será desinstalado do computador.

Valores de exemplo:

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

Elemento AppSettings

Opcional.

Define as preferências de aplicativo para o Microsoft 365 Apps, incluindo notificações de macro VBA, locais de arquivo padrão e formato de arquivo padrão. Para criar um arquivo de configuração com preferências do aplicativo, recomendamos que você use o Ferramenta de Personalização do Office para Clique para Executar, um aplicativo da web com uma interface de usuário completa. Você também pode usar a ferramenta para saber mais sobre as preferências do aplicativo disponíveis.

Para obter mais informações sobre preferências de aplicativo, consulte Aplicar preferências de aplicativo e Aplicar preferências de aplicativo a uma instalação existente do Office.

Exemplo

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

Artigos relacionados

• Visão geral da Ferramenta de Implantação do Office
• Guia de implantação para Aplicativos do Microsoft 365
• Idiomas, códigos de cultura e idiomas de revisão de texto complementares