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

  • Artigo

Com a ODT (Ferramenta de Implantação do Office), você pode baixar e implantar 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, consulte Visão geral da Ferramenta de Implantação do Office.

Observação

Prática recomendada: As opções neste artigo mostram os elementos XML e atributos no arquivo de configuração. Você pode continuar a criar o arquivo de configuração em um editor de texto, mas recomendamos usar a Ferramenta de Personalização do Office . Com a Ferramenta de Personalizaçã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 Personalizaçã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 Office ou editar o arquivo para instalar a edição em inglês de 64 bits do Office com o EULA aceito automaticamente e sem o 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 elementos e atributos XML e use o restante deste artigo para saber mais detalhes sobre cada um dos elementos e atributos.

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 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>
Valor Descrição
Adicionar SourcePath="\\Server\Share"
 O Office é baixado para "\\server\share" em sua rede e implantado usando arquivos de instalação nesse local.
Adicionar OfficeClientEdition="64"
 Baixa e instala a edição de 64 bits do Office
Adicionar Channel="MonthlyEnterprise"
 O Office está instalado usando o Canal Da Empresa Mensal.
ID do produto="O365ProPlusRetail"
 Baixa e instala Microsoft 365 Apps para Grandes Empresas.
ID do idioma="en-us"
ID do idioma="ja-jp"
Baixa e instala as versões em inglês e japonês do Office.
Updates Enabled="TRUE"
 O Office verifica se há atualizações.
Atualizações UpdatePath="\\Server\Share"
 O Office verifica se há atualizações em "\server\share" em sua rede.
Display Level="None" AcceptEULA="TRUE"
Ao instalar o Office, nenhuma interface do usuário é exibida.

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. Os arquivos de log podem ser encontrados na pasta %temp% do usuário, bem como em C:\Windows\Temp.

Elemento add

Define os produtos e idiomas a serem baixados e 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 Office. Se a ODT for executada no modo download, defina onde salvar os arquivos. Se não estiver incluído, o ODT procurará arquivos de instalação na mesma pasta que a ferramenta e, em seguida, use a CDN (Rede de Entrega de Conteúdo do Office). Se não estiverem incluídos e a ODT for executada em modo download, os arquivos de instalação do Office serão baixados para a mesma pasta da ferramenta.

Quando você baixa o Office em uma pasta que já contém essa versão do Office, o ODT conserva sua largura de banda de rede baixando apenas os arquivos ausentes. Por exemplo, se você usar o 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.

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 foram baixados.

Atributo Version (parte do elemento Add)

Opcional. Padrão para a versão mais recente disponível se não for especificado.

Quando você usa 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 Microsoft 365 Apps já estiver instalado em um dispositivo, você poderá usar Version="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 Visio e Project sem atualizar o Office para uma versão mais recente.

Valores de exemplo:

  • Version="16.0.15330.20306"
  • Version="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 Office não estiver instalado no dispositivo e o OfficeClientEdition não for especificado, o ODT será padrão para a edição de 64 bits, a menos que o dispositivo esteja executando uma edição de 32 bits do Windows ou tenha menos de 4 GB de RAM. Se o Office estiver instalado e o OfficeClientEdition não for especificado, o ODT corresponderá à arquitetura da instalação existente do Office. Se o Office estiver instalado e o OfficeClientEdition for especificado, ele deverá corresponder à arquitetura já instalada. Se não o fizer, a instalação falhará, já que arquiteturas misturadas não têm suporte.

Valores permitidos:

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

Atributo Channel (parte do elemento Add)

Opcional.

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

Esse valor determina o canal a ser instalado, independentemente de um canal de atualização opcionalmente especificado no elemento Atualizações ou por meio de Política de Grupo Configuração. Se houver essa configuração com um canal de atualização diferente, a opção 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 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="SemiAnnual"

Observação

  • Para usar esses valores de atributo, você precisa usar pelo menos a versão 16.0.12827.20268 da Ferramenta de Implantação do Office, que foi lançada na terça-feira, 9 de junho de 2020.
  • Valores permitidos anteriores para cada canal de atualização ainda podem ser usados, o que significa que você não precisa atualizar seus arquivos XML de configuração mais antigos.
  • O Canal Beta (às vezes chamado de Insider Fast) não é um build com suporte, portanto, deve ser usado apenas em ambientes de teste e por um pequeno grupo de usuários selecionados, como equipe de TI ou desenvolvedores de aplicativos.

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

Se você estiver implantando Office Professional Plus 2019 ou 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.

Atributo DownloadPath (parte do elemento Add)

Opcional. Padrão para a CDN se não for especificado.

Define de onde os arquivos de instalação são baixados ao executar o ODT no modo de download. Mais comumente usado para distribuir idiomas específicos e produtos do Office a partir de um local central da 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. Padrão para False se não for especificado.

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

Ao instalar idiomas, o ODT procura primeiro 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, o ODT usará arquivos de origem da CDN do Office.

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 do elemento Adicionar)

Opcional. Padrão para False se não for especificado.

Se definido como TRUE, a instalação existente de Microsoft 365 Apps será alterada para a arquitetura (às vezes chamada de bit) especificada no atributo OfficeClientEdition. Por exemplo, você pode usar esse atributo para alterar uma instalação de 32 bits de 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 de Microsoft 365 Apps de 32 bits para 64 bits.

Atributo OfficeMgmtCOM (parte do elemento Add)

Opcional. Padrão para 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, Microsoft Configuration Manager) gerenciem as atualizações do Office. Necessário ao usar Configuration Manager para atualizações de Microsoft 365 Apps. Quando o objeto COM do Office está habilitado, a opção Atualizar Agora na página Conta para Microsoft 365 Apps é desabilitada automaticamente para dispositivos cliente.

Para obter mais informações, consulte Gerenciar atualizações para Microsoft 365 Apps com a 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 de Microsoft 365 Apps. Para obter mais informações, incluindo um arquivo de configuração de exemplo, consulte Implantar idiomas em instalações existentes de 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 controlar a instalação de um produto do Office, conforme especificado pelo atributo ID, com base em se um determinado produto office baseado em MSI já está instalado no dispositivo. Por exemplo, se uma versão baseada em MSI do Project Professional já estiver instalada no dispositivo, instale Project Online Cliente da Área de Trabalho.

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

A MSICondition reconhece as versões 2007, 2010, 2013 e 2016 do produto do Office especificadas. Mas não é possível especificar uma versão específica. Por exemplo, você não pode ter MSICondition procurando especificamente Visio Standard 2013. A MSICondition procura todas as instalações baseadas em MSI de Visio Standard, incluindo Visio Standard 2007, Visio Standard 2010, Visio Standard 2013 e Visio Standard 2016.

O valor que você especifica para o atributo MSICondition é a ID de Configuração encontrada no arquivo Setup.xml no {product}. Pasta WW dos arquivos de instalação para sua versão existente do produto do Office. Por exemplo, o arquivo Setup.xml para Visio Professional 2016 é encontrado na pasta VisPro.WW. 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 de Project Standard ou Project Professional, licenciados por volume ou varejo.

Observação

Recomendamos que você remova os produtos do Office baseados em MSI existentes como parte da instalação dos produtos especificados em seu arquivo XML. Para remover produtos baseados em MSI existentes, use o elemento RemoveMSI.

Você também pode watch um vídeo sobre como usar o MSICondition em combinação com o RemoveMSI para simplificar sua atualização.

Exemplo do atributo MSICondition

No exemplo a seguir, Project Online Cliente da Área de Trabalho será instalado no dispositivo somente se uma versão baseada em MSI do Project Standard já estiver instalada no dispositivo. Além disso, Project Standard é removido do dispositivo como parte da instalação do Project Online Cliente de Área de Trabalho.

<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 decidir que deseja alterar o idioma da interface do usuário do Shell após uma instalação inicial, você precisará desinstalar e reinstalar o Office.

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 são compatíveis com o produto que você está instalando. Caso contrário, sua instalação falhará.

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

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

MatchOS e MatchInstalled não poderão instalar os idiomas do sistema operacional se o Office não oferecer suporte a esse idioma ou se o ODT não conseguir 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 o ODT use a CDN do Office para arquivos ausentes. Para fazer isso, use o atributo Fallback e o atributo AllowCdnFallBack.

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

Atributo Fallback (parte do elemento Language)

Opcional.

Ao usar o MatchOS, recomendamos que você especifique uma linguagem de fallback para instalar quando um idioma correspondente não tiver suporte pelo Office ou não puder ser encontrado nos arquivos de origem locais. Para fazer isso, use o atributo "Fallback". Para obter mais informações, consulte Instalar os mesmos idiomas que o 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 um produto específico, você pode especificar qualquer ID de produto com suporte. Se você quiser corresponder aos idiomas de todos os produtos já instalados, especifique "Todos". Em seguida, o ODT instala o novo produto com o mesmo conjunto de idiomas que o especificado em TargetProduct.

Se não houver nenhum TargetProduct especificado com MatchInstalled, o ODT tentará corresponder à mesma ID do produto à qual a marca Language pertence no arquivo de configuração. Por exemplo, se você estiver usando o MatchInstalled durante a instalação de "VisioProRetail" sem um TargetProduct, o ODT tentará corresponder aos idiomas já instalados para este 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 Office é instalado.

Exemplo

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

Atributo Level (parte do elemento Display)

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

Se o Nível for definido como Nenhum, o Office 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 Office será instalado com a experiência normal de instalação.

Valores permitidos:

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

Atributo AcceptEULA (parte do elemento Display)

Opcional. O padrão será 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 de Software da Microsoft. Se esse atributo estiver definido como FALSE ou não estiver incluído, o usuário poderá ver uma caixa de diálogo Termos de Licença de Software da Microsoft. Recomendamos que os administradores definam o AcceptEULA como TRUE.

Valores permitidos:

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

Observação

Se você implantar uma versão do Office antes da versão 1803, essa configuração será aplicada somente se você instalar com a conta do usuário. A Microsoft Configuration Manager e outras ferramentas de distribuição de software que usam a conta SYSTEM para instalação não aplicarão a configuração.

Elementos de ExcludeApp

Define quais Microsoft 365 Apps produtos não devem ser instalados. O OneDrive é instalado automaticamente quando você instala Microsoft 365 Apps ou instala aplicativos individuais, como 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 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á tem Microsoft 365 Apps instalado, a configuração ExcludeApp será tratada de forma diferente com base na lista de idiomas:

  • 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 excludeApp existente no dispositivo. Isso também será verdade se a lista de idiomas no arquivo de configuração incluir todos os idiomas instalados e idiomas adicionais.
  • 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="Bing"
  • ID="Excel"
  • ID="Groove"
  • ID="Lync"
  • ID="OneDrive"
  • ID="OneNote"
  • ID="Outlook"
  • ID="PowerPoint"
  • ID="Publisher"
  • ID="Teams"
  • ID="Word"

Observação

Elemento Property

Define determinadas propriedades e comportamentos do Office.

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

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 será 0 se não for especificado.

Como Microsoft 365 Apps está definido para ativar automaticamente, você não deve definir essa propriedade para Microsoft 365 Apps produtos. 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 os aplicativos que estão impedindo a instalação do Office a serem desligados. Poderá 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 de App-V criados pelo ODT compartilham a mesma ID do pacote App-V. Os administradores podem usar PACKAGEGUID para especificar um ID de pacote diferente. Isto permite que você publique vários pacotes App-V do Office a um Servidor de Gerenciamento de App-V. Porém, isso não permite que você implante mais de um pacote de App-V do Office em um único computador. Você pode usar o ODT para criar pacotes de App-V para Microsoft 365 Apps. Não há suporte para a criação de pacotes para versões licenciadas por volume de Office Professional Plus ou 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 Microsoft 365 Apps em computadores compartilhados usando os Serviços de Área de Trabalho Remota.

Para obter mais informações, consulte Visão geral da ativação compartilhada do computador para 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 do computador compartilhado e quiser percorrer 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, consulte Visão geral da ativação compartilhada do computador para 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 do computador compartilhado e quiser percorrer o 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, consulte Visão geral da ativação compartilhada do computador para 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 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 é True se não for especificado.

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

Valores permitidos:

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

Observação

Elemento Remove

Define quais produtos e idiomas remover de uma instalação anterior de 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, o 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 é FALSE se não for especificado.

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

Valores permitidos:

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

Elemento Updates

Define como o Office será atualizado após sua instalação.

Exemplo

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

Atributo Enabled (parte do elemento Updates)

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

Se definido como TRUE, o Office verificará se há atualizações. Se definido como FALSE, o Office não marcar para atualizações, mas o usuário pode marcar para atualizações acessando Asopções> de atualizaçãoda conta> de arquivo>atualize agora.

Valores permitidos:

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

Atributo UpdatePath (parte do elemento Updates)

Opcional. Padrão para a CDN se não for especificado.

Define a origem das atualizações do Office. UpdatePath pode especificar uma rede, local ou caminho HTTP de uma fonte de Office arquivos de instalação. Variáveis de ambiente podem ser usadas para rede ou caminhos locais.

Se você usar Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) para o 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. Padrão para a versão mais recente do caminho de atualização especificado.

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

Se você usar Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) para o Office, poderá definir TargetVersion usando a configuração de política de 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 Deadline com o Target Version 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 para instalar as atualizações.

Antes do prazo, os usuários recebem vários lembretes para instalar as atualizações. Se Office não é atualizado no prazo, os usuários verão uma notificação de que as atualizações serão aplicadas em 15 minutos. Essa notificação oferece aos usuários a oportunidade de salvar os documentos do Office nos quais estão trabalhando e fechar todos os programas do Office abertos. Se os usuários não fechem os programas de Office, os programas estão fechados automaticamente quando os 15 minutos para cima, que pode resultar em perda de dados.

Após os programas de Office são fechados, 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 Office esteja sempre atualizado, altere o prazo sempre que uma nova atualização do Office 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 Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) para o Office, poderá definir o Deadline usando a configuração de política de Atualização do 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 Office depois de instalado. Há dois atributos de canal: o canal para o elemento Add é usado para especificar um canal de atualização durante a instalação do Office e o canal do elemento Atualizações é usado para alterar o canal para uma instalação existente do Office.

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 Política de Grupo com os arquivos de Modelo Administrativo (ADMX/ADML) para o Office, poderá definir o Canal usando a configuração de política do Update Channel. É 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="SemiAnnual"

Observação

  • Para usar esses valores de atributo, você precisa usar pelo menos a versão 16.0.12827.20268 da Ferramenta de Implantação do Office, que foi lançada na terça-feira, 9 de junho de 2020.
  • Valores permitidos anteriores para cada canal de atualização ainda podem ser usados, o que significa que você não precisa atualizar seus arquivos XML de configuração mais antigos.
  • O Canal Beta (às vezes chamado de Insider Fast) não é um build com suporte, portanto, deve ser usado apenas em ambientes de teste e por um pequeno grupo de usuários selecionados, como equipe de TI ou desenvolvedores de aplicativos.

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

Se você estiver implantando Office Professional Plus 2019 ou 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 2007, 2010, 2013 ou 2016 do Office, Visio e Project instaladas usando o MSI (Windows Installer) são desinstaladas do computador antes da instalação do produto especificado, como Microsoft 365 Apps.

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

Atributo IgnoreProduct (parte do elemento RemoveMSI)

Opcional.

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

Valores de exemplo:

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

Elemento AppSettings

Opcional.

Define as preferências do aplicativo para Microsoft 365 Apps, incluindo notificações de Macro do VBA, locais de arquivo padrão e formato de arquivo padrão. Para criar um arquivo de configuração com preferências de aplicativo, é recomendável usar o Ferramenta de Personalização do Office para 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 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>