Referência do arquivo Config.xml para o Office 2013

 

Aplica-se a: Office 2013

Tópico modificado em: 2016-12-16

**Resumo:**fornece informações sobre como usar o arquivo Config.xml para personalizar instalações do Office 2013 baseadas no Windows Installer.

Público: profissionais de TI

Os administradores usam o arquivo Config.xml para executar tarefas de instalação e manutenção para o Office 2013.

A principal ferramenta usada pelos administradores para personalizar a instalação de produtos baseados no Windows Installer no Office 2013 é a Ferramenta de Personalização do Office (OCT). As ferramentas e os métodos de personalização no Office 2013 são os mesmos que para o Office 2010 e o Office 2007. Para obter mais informações sobre como usar a OCT para criar um arquivo de personalização da Instalação e aprender sobre as atualizações para a OCT no Office 2013, consulte Referência da Ferramenta de Personalização do Office (OCT) do Office 2013.

Use o arquivo Config.xml para configurar tarefas de instalação e usá-las somente ao executar a Instalação. O Config.xml não é instalado ou armazenado em cache nos computadores dos usuários. Os administradores podem editar o arquivo Config.xml a fim de personalizar a instalação. Por padrão, o arquivo Config.xml armazenado na pasta de produto principal, core_product_folder_name.WW, direciona a Instalação para instalar esse produto. Por exemplo, o arquivo Config.xml na pasta ProPlus.WW instala o Office Professional Plus 2013.

Use o arquivo Config.xml para executar as seguintes tarefas de instalação:

• Especificar o caminho do ponto de instalação na rede.

• Selecionar qual produto instalar.

• Personalizar as opções da Instalação, como o registro em log e o local do arquivo de personalização da Instalação e atualizações de software.

• Definir as opções de instalação, como nome de usuário e de empresa.

• Copiar o LIS (Local Install Source) no computador do usuário sem instalar o Office.

• Adicionar ou remover idiomas da instalação.

Também é possível usar o arquivo Config.xml para operações de manutenção como adição ou remoção de recursos, reparos e remoção de instalações. Para fazer isso, os administradores precisam executar Setup.exe novamente a partir da fonte original.

Importante
Para editar o Config.xml, use um editor de texto, como o Bloco de Notas. Não use um editor de XML para fins gerais, como o Word 2013.

Neste artigo:

• Referência rápida do elemento Config.xml

• Como a Instalação usa o Config.xml

• Formato do arquivo Config.xml

• Referência do elemento Config.xml

• Amostra do arquivo Config.xml

Referência rápida do elemento Config.xml

A tabela a seguir lista os elementos de Config.xml. Esses elementos podem aparecer em qualquer ordem, exceto para Configuração do elemento, que precisa ser o primeiro, e elementos como Elemento Command, cuja ordem em Config.xml afeta a forma como são processados durante a instalação.

Referência rápida de Config.xml

Elemento	Descrição
Configuração	Elemento de nível superior
Elemento AddLanguage	Adiciona um idioma à instalação
Elemento ARP	Valores que controlam o texto e o comportamento da opção Programas e Recursos, no Painel de Controle, para adicionar ou remover recursos para o produto
Elemento Command	Executa um comando durante a instalação
Elemento COMPANYNAME	O nome da organização ou empresa do usuário cujo computador está recebendo o produto
Exibição	O nível de UI exibido pela Instalação para o usuário
Elemento DistributionPoint	O caminho totalmente qualificado do ponto de instalação na rede a partir do qual a instalação será executada
Elemento INSTALLLOCATION	O caminho totalmente qualificado da pasta no computador do usuário no qual o produto é instalado
Elemento LIS	Opções de como o LIS (Local Install Source) é armazenado em cache no computador do usuário
Elemento Logging	Opções para o tipo de registro em log executado pela Instalação
Elemento OptionState	Opções para especificar como os recursos de produtos individuais devem ser manipulados durante a instalação
Elemento PIDKEY	A chave de licença de volume de 25 caracteres
Elemento RemoveLanguage	Remove um idioma da instalação
Configuração	Valores para propriedades do Windows Installer
Elemento SetupUpdates	O caminho de pesquisa para a Instalação usar a fim de encontrar os arquivos de personalização da Instalação
Elemento USERINITIALS	As iniciais do usuário cujo computador está recebendo o produto
Elemento USERNAME	O nome do usuário cujo computador está recebendo o produto

Como a Instalação usa Config.xml

A Instalação procura por uma cópia de Config.xml na mesma pasta que Setup.exe. Caso uma cópia não seja encontrada nesse local, a Instalação usará o arquivo Config.xml localizado na pasta de produto principal do produto que você está instalando (se houver vários produtos no ponto de instalação na rede, a Instalação aguardará até que você especifique qual produto instalar antes de ela procurar pela cópia de Config.xml). A cópia de Config.xml localizada na pasta do produto identifica o produto por meio do atributo Product de Configuração do elemento.

Também é possível usar a opção de linha de comando da Instalação /config para especificar o local do arquivo Config.xml. Por exemplo:

\\ server \ share \setup.exe /config \\ server \ share \ProPlus.WW\config.xml

Observação
Se você também criou um arquivo de personalização da Instalação (.msp) usando a OCT, as personalizações definidas em Config.xml têm precedência sobre aquelas do arquivo de personalização.

Formato do arquivo Config.xml

Os elementos XML em Config.xml começam com < e terminam com />.

O formato de elemento básico é o seguinte:

< element [attribute**="value"] [attribute="value"**] … />

Por exemplo:

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />

As seguintes declarações se aplicam ao formato:

• Elementos e atributos diferenciam maiúsculas de minúsculas.

• Os valores de atributo precisam estar entre aspas (") e não diferenciam maiúsculas de minúsculas.

• Uma definição de elemento pode ocupar vários linhas. Espaços, retornos de carro, alimentações de linha e caracteres de tabulação são ignorados em uma definição de elemento.

  Veja a seguir um exemplo de uma definição de elemento que ocupa várias linhas.

  <Display
     Level="none"
     CompletionNotice="no"
     SuppressModal="yes"
     AcceptEula="yes"
  />
  

Configuração do elemento é um caso especial e necessário. Todos os outros elementos são contidos em Configuração do elemento e o elemento é fechado com </Configuration>, como mostra o exemplo a seguir.

<Configuration Product="ProPlus">
  <!--  <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" />  --> 
  <!--  <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" />  --> 
  <!--  <USERNAME Value="Customer" />   --> 
  <!--  <COMPANYNAME Value="MyCompany" />   --> 
  <!--  <INSTALLLOCATION Value="%programfiles%\Microsoft Office" />   --> 
  <!--  <LIS CACHEACTION="CacheOnly" />   --> 
  <!--  <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->
  <!--  <DistributionPoint Location="\\server\share\Office" />   --> 
  <!--  <OptionState Id="OptionID" State="absent" Children="force" />   --> 
  <!--  <Setting Id="SETUP_REBOOT" Value="IfNeeded" />   --> 
  <!--  <Command Path="%windir%\system32\msiexec.exe" Args="/i \\server\share\my.msi" QuietArg="/q" ChainPosition="after" Execute="install" />   --> 
  </Configuration>

Os comentários podem ser adicionados em qualquer lugar e são delimitados por "<!--" e "-->".

Por exemplo:

<!-- Configure install options for Microsoft Office Professional Plus 2010 -->
<Configuration Product="ProPlus" >
   <Display
      <!-- Turn off all Setup UI and prevent prompting users-->
      Level="none"
      CompletionNotice="no"
      SuppressModal="yes"
      <!-- Accept the EULA for the user -->
      AcceptEula="Yes"
   />
</Configuration>

Cada pasta de produto do Office contém um arquivo Config.xml padrão, composto por uma Configuração do elemento com o atributo Product definido com o valor apropriado para o produto. Configuração do elemento inclui diversos exemplos de elementos cercados por comentários. Para ativar esses elementos, remova as marcações de comentário inicial e final e digite os valores de atributo apropriados.

Como mostra o exemplo a seguir, é possível ativar o elemento Elemento Display alterando esta linha:

<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->

para o seguinte:

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />

As opções de Display no exemplo anterior direcionam a Instalação para a execução de uma instalação silenciosa, a fim de impedir que os usuários recebam solicitações para inserir informações e para impedir que a instalação aguarde qualquer interação do usuário.

Referência do elemento Config.xml

As seguintes convenções são usadas nas descrições desta referência.

Convenções de formatação

bold	Elemento ou nome do atributo
normal	Texto a ser inserido exatamente como exibido
italic	Local reservado para um valor a ser adicionado
x|y	Escolha entre vários valores
[x]	Valor opcional

Configuração do elemento

Elemento de nível superior. Esse elemento é necessário e todos os outros elementos precisam aparecer nesse elemento.

Sintaxe

<Configuration [Product="productID"] >

...

</Configuration>

Atributos

A tabela a seguir descreve os atributos e valores do elemento Configuration.

Atributos do elemento Configuration

Atributo	Valor	Descrição
Product	productID	O valor do atributo ID no elemento Setup no arquivo Setup.xml para o produto que está sendo instalado.

Comentários

O atributo Product identifica o produto afetado por esse arquivo Config.xml. O productID é definido no arquivo Setup.xml localizado na pasta principal do produto, no atributo ID do elemento Setup.

O atributo Product é opcional, a menos que você defina o atributo Exibição Level como “básico” ou “nenhum”. Nesse caso, o atributo Product é necessário. Caso o produto especificado pelo atributo Product não exista no ponto de instalação na rede, a Instalação encerrará a instalação.

Exemplo

O productID para Office Professional Plus 2013 está localizado em ProPlus.WW\Setup.xml na seguinte linha:

<Setup Id="ProPlus" Type="Product"  ... >

Use esse productID em Config.xml para especificar o Office Professional Plus 2013 inserindo a seguinte linha:

<Configuration Product="ProPlus">
   ...
</Configuration>

Elemento AddLanguage

Adiciona o idioma especificado à instalação.

Sintaxe

<AddLanguage

Id=" ll-cc " | "match"

[ShellTransform="Yes"]

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento AddLanguage.

Atributos de AddLanguage

Atributo	Valor	Descrição
Id	ll - cc	O identificador do idioma.
	match	Corresponde o Id do idioma da localidade do usuário do Windows.
ShellTransform	Yes	Especifica o idioma do shell da interface de usuário. Se mais de um elemento AddLanguage for especificado, um idioma (e somente um) deverá especificar o elemento ShellTransform.

Comentários

O idioma precisa estar disponível no ponto de instalação na rede.

É possível ter múltiplos elementos para AddLanguage e Elemento RemoveLanguage. Se os elementos Elemento RemoveLanguage e AddLanguage especificarem o mesmo idioma, o elemento AddLanguage terá precedência e o idioma será instalado.

Observação
Se mais de um elemento AddLanguage for especificado, um idioma (e somente um) deverá especificar o elemento ShellTransform ou a Instalação será encerrada.

Há três conceitos de idioma dos quais você precisa saber ao instalar o Office 2013:

• Interface de usuário (UI) da Instalação: o idioma da instalação.

• Shell UI: o idioma de atalhos, menus de contexto acionados com o botão direito do mouse e dicas de ferramenta.

• Office UI: o idioma da interface de usuário e dos menus do Office.

Quando há múltiplos idiomas do Office, esses três valores são determinados da seguinte maneira:

Por padrão, a UI da Instalação depende do conjunto de recursos disponíveis para instalação e a habilidade de corresponder à localidade do usuário. Por padrão, a UI da Instalação corresponde à localidade do usuário. A Shell UI depende do conjunto de idiomas que está sendo instalado e, por padrão, segue a UI da Instalação. O idioma da UI padrão do Office depende da localidade do usuário e das configurações atuais do usuário. O padrão é usar a localidade do usuário do Windows definida no computador de cada usuário. Isso significa que no caso padrão, a UI da Instalação, Shell UI e UI do Office serão as mesmas.

Uma localidade no sistema operacional Windows é um conjunto de informações de preferência do usuário relacionadas ao idioma, ambiente e convenções culturais do usuário. Essas informações são representadas como uma lista de valores usados para determinar o idioma de entrada correto, layout do teclado, ordem de classificação e os formatos usados para números, datas, moedas e tempo. A localidade do usuário é uma configuração por usuário que determina os formatos usados, por padrão, a fim de exibir datas, horários, moeda e números, e a ordem de classificação do texto. Uma localidade de usuário é especificada para cada conta criada em um computador.

Se um administrador especifica múltiplos idiomas para instalação no arquivo Config.xml, o idioma do Shell UI precisa ser selecionado a partir do conjunto de idiomas que está sendo instalado. Para fazer isso, os administradores especificam o atributo ShellTransform do elemento AddLanguage no arquivo Config.xml. AddLanguage especifica o idioma usado pela Instalação para o Shell UI. No entanto, isso não afeta necessariamente a escolha da UI da Instalação ou a UI do Office quando é instalado no computador do usuário.

Por exemplo, se você tiver uma imagem do Office com inglês, francês, alemão e espanhol, para especificar que a Instalação instale suporte completo para todos esses idiomas e fazer com que o Shell UI siga as opções regionais padrão do usuário, adicione os seguintes elementos ao arquivo Config.xml.

<AddLanguage Id="match" ShellTransform="yes"/> <AddLanguage Id="en-us" /> <AddLanguage Id="fr-fr" /> <AddLanguage Id="de-de" /> <AddLanguage Id="es-es" />

No exemplo anterior, a Instalação instala todos os idiomas especificados e o Shell UI corresponde ao idioma da localidade do usuário. Se houvesse mais idiomas disponíveis na imagem de origem, o valor de match no exemplo anterior instalaria um idioma adicional, caso o idioma de match não resolvesse para um dos outros quatro idiomas mencionados explicitamente. Por exemplo, se japonês também tiver sido incluído na fonte, esse exemplo instalaria o idioma japonês, além dos outros quatro idiomas, quando for instalado em um computador que tenha a localidade de usuário definida como japonês.

Exemplo

<AddLanguage Id="en-us" ShellTransform="Yes" />

Elemento ARP

Especifica os valores que controlam o texto e o comportamento de Programas e Recursos no Painel de Controle do produto.

Sintaxe

<ARP attribute =" value " [attribute**="value"**] ... />

Atributos

A tabela a seguir descreve os atributos e valores do elemento ARP.

Atributos de ARP

Atributo	Valor	Descrição
ARPCOMMENTS	text	Texto adicional. Pode ter até 255 caracteres, embora nem todos os caracteres sejam exibidos.
ARPCONTACT	text	Lista de contatos de suporte técnico.
ARPNOMODIFY	Yes	Impede que os usuários mudem a instalação do produto disponibilizando o botão Alterar.
	No (padrão)	Permite que os usuários modifiquem a instalação do produto.
ARPNOREMOVE	Yes	Impede que os usuários removam o produto disponibilizando o botão Remover.
	No (padrão)	Permite que os usuários removam o produto.
ARPURLINFOABOUT	URL	URL para a página inicial do produto.
ARPURLUPDATEINFO	URL	URL para informações sobre atualizações do produto.
ARPHELPLINK	URL	URL de um site no qual os usuários podem receber suporte técnico.
ARPHELPTELEPHONE	text	Números de telefone para suporte técnico.

Elemento Command

Especifica uma linha de comando para executar. Para obter informações, consulte Comentários posteriormente neste artigo.

Sintaxe

<Command

Path=" path "

[QuietArg="arguments"]

[Args="args"]

[ChainPosition="Before" | "After"(padrão)]

[Wait="mseconds"]

[Execute="Install"(padrão) | "Uninstall"]

[Platform="x86"(padrão) | "x64"]

/>

Atributos

A tabela a seguir descreve os atributos do elemento Command.

Atributos de Comando

Atributo	Valor	Descrição
Path	path	Caminho totalmente qualificado do arquivo executável. Se o valor do caminho contiver um espaço, será necessário usar aspas duplas, como mostra o exemplo a seguir: "\\server\share\Office 14\copylogs.bat"
QuietArg	string	Cadeia de caracteres de argumentos a serem anexados à linha de comando se você configurar uma instalação silenciosa. Para obter mais informações sobre quando usar o atributo QuietArg, consulte a seção Comentários após esta tabela.
Args	string	Cadeia de caracteres de argumentos a serem passados para o executável. Para obter informações sobre quando usar o atributo Args para instalações em cadeia, consulte a seção Comentários, após esta tabela. Se o valor do elemento Args incluir aspas, você poderá cercar todo o valor em aspas simples ('), como mostra o exemplo a seguir: Args='"/param value"'
ChainPosition	Before	Esse comando é executado antes da instalação principal do produto.
	After (padrão)	Esse comando é executado após a instalação principal do produto.
Wait	mseconds	Quando você instalar um produto com o atributo Exibição Level definido como "completo" ou “básico”, esse será o número de milissegundos de espera após a execução do programa antes de continuar a instalação. O padrão é 0 (zero), indicando que não há espera.
Execute	Install (padrão)	A Instalação executa esse comando quando o produto principal é instalado.
	Uninstall	A Instalação executa esse comando quando o produto principal é desinstalado.
Platform	x86 (padrão)	Especifica que esse programa exige a plataforma Intel x86. Esse comando é executado somente se o computador no qual a instalação é executada atender ao requisito dessa plataforma.
	x64	Especifica que esse programa exige um processador de 64 bits que suporta as extensões x64 para a arquitetura x86. Esse comando é executado somente se o computador no qual a instalação é executada atender ao requisito dessa plataforma.

Comentários

O elemento Command no arquivo Config.xml e a opção Adicionar instalações e executar programas na OCT (linhas de comando digitadas nas caixas de diálogo Adicionar Entrada do Programa e Modificar Entrada do Programa) devem ser usados somente para instalações iniciais e desinstalações do produto. Os comandos do elemento Command são processados somente durante as instalações iniciais e desinstalações. Se os comandos do elemento Command forem usados para personalizações após a instalação inicial, eles serão ignorados.

A linha de comando pode ser especificada para executar um comando aleatório ou executar um executável leve que você deseja quando esse produto é instalado.

O elemento Command em Config.xml e a opção Adicionar instalações a executar programas na OCT e o elemento não fornecem os recursos de implantação de software que uma ferramenta de implantação e gerenciamento de software empresarial fornece, como a habilidade de rastrear o progresso da implantação e solucionar problemas. Portanto, recomendamos que você use o elemento Command em Config.xml e Adicionar instalações e executar programas na OCT para executar somente executáveis leves ou comandos aleatórios que não mudarão o computador ou que não exigem entrada do usuário. Por exemplo, é possível executar um utilitário para copiar logs ou um comando para iniciar uma página de Boas-vindas ao final da instalação.

Importante

Encadeamento não é tão confiável quanto instalar cada produto separadamente. Por exemplo, se você encadear duas instalações e um dos produtos falhar ou encontrar um erro inesperado, a instalação principal e a instalação encadeada talvez não sejam concluídas com êxito. Portanto, recomendamos que você não use a abordagem de encadeamento. O método recomendado para instalação de múltiplos produtos em ambientes empresariais é usar um programa de gerenciamento de implantação, como o Microsoft System Center Configuration Manager 2012 ou o Microsoft Systems Management Server (SMS) 2003 ou uma ferramenta de terceiros, em vez do encadeamento.

O uso de Args e QuietArg ocorre da seguinte maneira:

• O atributo Args é sempre anexado ao comando. Isso pode incluir chaves como "/install" ou **"Company=**MyCorporation."

• O atributo QuietArg também é anexado se a instalação for executada silenciosamente (com Display definido como Display="none"). Em casos como esses, é possível especificar o atributo QuietArg usando a chave "/quiet", por exemplo, é possível usar: QuietArg="/quiet".

As declarações a seguir se aplicam ao atributo Wait:

• Configurar o atributo Wait como 0 milissegundos indica que não haverá espera após a execução do programa antes de continuar a instalação. O comando executará e continuará imediatamente.

  Os códigos de retorno serão respeitados somente se o valor de Wait não for zero. Se você especificar 0, a Instalação não aguardará para continuar a instalação após a execução do programa especificado. Portanto, não há código de retorno para reportar nesse caso.

• A configuração do atributo Wait para qualquer valor positivo diferente de zero fará com que ocorra uma espera que durará o número exato de milissegundos especificado por você. Se o processo terminar antes do tempo especificado, a instalação continuará. Se o processo não tiver terminado quando o período especificado terminar, a instalação falhará.

• A configuração do atributo Wait para -1 indica que ocorrerá uma espera indefinida. Isso pode ser um problema, pois se o processo do comando parar de responder (travar), a instalação deixará de responder e aguardará indefinidamente pela execução do comando.

Se houver dois ou mais elementos do Command no arquivo Config.xml, eles executarão na ordem na qual foram especificados em Config.xml.

Exemplos

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />

Elemento COMPANYNAME

O nome da organização ou empresa do usuário cujo computador está recebendo o produto.

Sintaxe

<COMPANYNAME Value=" companyname " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento COMPANYNAME.

Atributos COMPANYNAME

Atributo	Valor	Descrição
Value	companyname	O nome da empresa ou da organização.

Exemplo

<COMPANYNAME Value="Microsoft Corporation" />

Elemento Display

O nível de UI exibido pela Instalação para o usuário.

Sintaxe

<Display

Level="None" | "Basic" | "Full"(padrão)

CompletionNotice="Yes" | "No"(padrão)

SuppressModal="Yes" | "No"(padrão)

NoCancel="Yes" | "No"(padrão)

AcceptEula="Yes" | "No"(padrão)

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento Display.

Atributos de Exibição

Atributo	Valor	Descrição
Level	None	Nenhuma UI de Instalação é exibida. Se você definir Display Level="none", a Instalação será executada silenciosamente (autônoma). Consulte a seção Comentários para obter mais informações.
	Basic	A Instalação exibe uma tela de Boas-vindas, a página da chave do produto (PIDKEY) (se for necessária), a página dos termos de licença de software (se você precisar), uma barra de progresso e o aviso de conclusão (se for permitido).
	Full (padrão)	A Instalação exibe toda UI para o usuário.
CompletionNotice	Yes	Aplica-se apenas se Level for definido como "básico" ou “nenhum”: a Instalação exibe o aviso de conclusão.
	No (padrão)	Aplica-se apenas se Level for definido como "básico": a Instalação não exibe o aviso de conclusão.
SuppressModal	Yes	Aplica-se apenas se Level for definido como "básico": a Instalação não exibe mensagens de erro e outras caixas de diálogo que possam interromper a instalação.
	No (padrão)	Aplica-se apenas se Level for definido como ”básico”: a Instalação exibe erros e outras caixas de diálogo conforme o necessário.
NoCancel	Yes	Se Level for definido como "completo" ou "básico", desabilite o botão cancelar (X no canto superior esquerdo da caixa de diálogo de progresso).
	No (padrão)	Se Level for definido como "completo" ou "básico", permite que o usuário cancele a instalação a partir da barra de progresso.
AcceptEULA	Yes	Os Termos de Licença de Software da Microsoft são aceitos em nome do usuário. A Instalação não exibe a página dos termos de licença de software.
	No (padrão)	Se Level não for definido como ”nenhum”, a Instalação exibirá a página de termos de licença de software.

Comentários

Se esse elemento não for definido, as configurações padrão serão usadas. Se um valor inválido for especificado, a Instalação será encerrada.

Se o atributo Level for definido como "básico" ou “nenhum” e você fornecer uma chave de produto usando a Elemento PIDKEY, a Instalação assumirá que você também aceita o contrato de licença em nome do usuário.

Observação

Em implantações empresariais, recomendamos a definição do valor de Display Level como “nenhum” para direcionar a Instalação a executar uma instalação silenciosa. Isso impede que os usuários recebam solicitações de inserção de informações e impede que a instalação aguarde interações do usuário, mesmo quando os arquivos em uso. A configuração do valor do Display Level como “nenhum” assume que os atributos SuppressModal e CompletionNotice são silenciados e os Termos de Licença de Software da Microsoft são aceitos. Os administradores também precisam se certificar de que nenhum aplicativo do Office seja executado durante uma instalação do Office 2013. Se você definir o valor Display Level como “básico” e SuppressModal como “sim”, os usuários podem ser questionados se quaisquer arquivos do Office estiverem sendo usados. A configuração de Display Level como “nenhum” impede o questionamento dos usuários nesses casos. O atributo SuppressModal não impede a exibição de mensagens de files in use. Somente se Display Level for definido como “nenhum” as mensagens de files in use não serão exibidas. O elemento Display é usado pela Instalação somente se ela encontrar o arquivo Config.xml na mesma pasta que o setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, a Instalação usará as opções de exibição padrão.

Exemplo

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="Yes" />

Elemento DistributionPoint

Especifica o caminho totalmente qualificado do ponto de instalação na rede a partir do qual a instalação será executada.

Sintaxe

<DistributionPoint Location=" path " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento DistributionPoint.

Atributos de DistributionPoint

Atributo	Valor	Descrição
Location	path	O caminho totalmente qualificado do ponto de instalação na rede a partir do qual a instalação será executada.

Comentários

Caso isso não seja especificado, a Instalação presumirá que o arquivo Setup.exe está localizado na raiz do ponto de instalação na rede.

Observação
O elemento DistributionPoint é usado pela Instalação somente se ela encontrar o arquivo Config.xml na mesma pasta que o setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, ela ignorará esse elemento, pois o ponto de instalação da rede já foi encontrado.

Exemplo

<DistributionPoint Location="\\server1\office" />

Elemento INSTALLLOCATION

Especifica o caminho totalmente qualificado da pasta no computador do usuário no qual o produto é instalado

Sintaxe

<INSTALLLOCATION Value=" path " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento INSTALLLOCATION.

Atributos de INSTALLLOCATION

Atributo	Valor	Descrição
Value	path	O caminho totalmente qualificado da pasta no computador do usuário no qual o produto é instalado.

Comentários

É possível usar as variáveis do ambiente do sistema no caminho. Se esse elemento não for especificado, o Office será instalado em %ProgramFiles%\Microsoft Office.

Exemplo

<INSTALLLOCATION Value="%ProgramFiles%\MyApps" />

Elemento LIS

Controla como o LIS (Local Installation Source) é armazenado em cache no computador do usuário e especifica o local de um ou mais pontos de instalação de rede que contêm os arquivos de instalação para o produto.

Sintaxe

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST=" semicolon-delimited-path-list "]

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento LIS.

Atributos de LIS

Atributo	Valor	Descrição
CACHEACTION	CacheOnly	A Instalação copia o LIS para o computador do usuário, mas não instala o produto. Observação Não use os elementos de Command em um arquivo Config.xml que especifica o valor de CacheOnly, pois os comandos especificados não serão executados.
	RemoveCacheOnly	Se o cache for copiado no computador do usuário e o Office não estiver instalado, a Instalação removerá o LIS do computador do usuário, mas não instalará ou desinstalará o produto.
SOURCELIST	semicolon-delimited-path-list	Uma lista, separada por ponto e vírgula, de um ou mais pontos de instalação de rede que contém os arquivos de instalação para o produto. A opção equivalente na OCT é Additional network sources.

Comentários

Por padrão, o LIS é criado na pasta \MsoCache\All Users na raiz da unidade na qual o Office está instalado. Os arquivos de personalização da Instalação e as atualizações de software na pasta Atualizações no ponto de instalação da rede também são copiados.

Se você especificar Elemento INSTALLLOCATION, a designação da unidade no caminho é usado para determinar em qual unidade o LIS é criado. Por exemplo, se o caminho Elemento INSTALLLOCATION para E:\office\files, o LIS será criado na unidade E. As fontes listadas pelo atributo SOURCELIST são mantidas com o produto instalado e são usadas pela Instalação se o LIS não for encontrado no computador ou se estiver corrompido.

Exemplo

<LIS CACHEACTION="CacheOnly" />   
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />

Elemento Logging

Especifica o tipo de registro em log executado pela Instalação.

Sintaxe

<Logging

Type="Off" | "Standard"(padrão) | "Verbose"

Path=" path "

Template=" filename .txt"

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento Logging.

Atributos de Logging

Atributo	Valor	Descrição
Type	Off	A Instalação não executa registro em log.
	Standard (padrão)	A Instalação grava as informações de instalação no arquivo de log.
	Verbose	A Instalação grava todas as informações de instalação no arquivo de log.
Path	path	O caminho totalmente qualificado da pasta usada para o arquivo de log. É possível usar variáveis do ambiente. O padrão é %temp%.
Template	filename .txt	O nome do arquivo de log. Se você inserir a cadeia de caracteres * em qualquer lugar no nome do arquivo, um arquivo de log exclusivo é criado para cada instalação executada por setup.exe (consulte a explicação posteriormente neste artigo). Se o caractere * não estiver incluído e o nome do arquivo especificado já existir, as informações de log serão anexadas ao arquivo existente. A extensão de nome de arquivo .txt precisa ser incluída. O modelo padrão é SetupExe(*).log.

Comentários

É possível especificar um * em qualquer lugar no valor de Template. A Instalação insere uma cadeia de caracteres nesse local com o seguinte formato.

YYYYMMDDHHMMSS xxx

na qual:

1. AAAA = Ano

2. MM = Mês

3. DD = Dia

4. HH = Hora

5. MM = Minuto

6. SS = Segundos

7. xxx = uma cadeia de caracteres exclusiva gerada pela Instalação

Observação
O elemento Logging é usado pela Instalação somente se ela encontrar o arquivo Config.xml na mesma pasta que o setup.exe, ou se você especificar o arquivo Config.xml usando a opção de linha de comando /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, a Instalação usará as opções de registro em log padrão.

Exemplo

<Logging Type="standard" Path="%temp%" 
   Template="MyLog(*).txt" 
/>

No exemplo a seguir, a Instalação cria um arquivo de log sempre que instala o produto. A Instalação usa nomes de arquivo exclusivos como os seguintes:

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Elemento OptionState

Especifica como recursos de produto específicos são manipulados durante a instalação.

Importante
Na maioria das situações, recomendamos o uso da OCT para alterar o estado de instalação dos recursos. A opção equivalente na OCT é Definir estados de instalação do recurso.

Sintaxe

<OptionState

Id=" ID_da_opção "

Estado="Ausente" | "Publicidade" | "Local"

[Children="force"]

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento OptionState.

Atributos de OptionState

Atributo	Valor	Descrição
Id	optionID	Um item que o usuário pode optar por instalar.
State	Absent	O recurso não é instalado.
	Advertise	O recurso é instalado na primeira vez que é usado.
	Local	O recurso é instalado no computador do usuário.
Children	force	Todos os recursos filho do recurso são definidos com o estado especificado.

Comentários

Um recurso é um item que o usuário pode escolher instalar. O valor de Id para um recurso é definido no elemento Option do arquivo Setup.xml na pasta principal do produto.

Observação
Os seguintes subcomponentes de Publisher 2013 não são visíveis na árvore de estados de instalação de recurso da Instalação no Office 2013. Impressão comercial e o subcomponente Conversão Avançada de RGB em CMYK Esquemas de fonte Visualizações do PaperDirect Modelos do Publisher e os subcomponentes Publicações Comerciais e Outras Publicações

Exemplo

<OptionState Id="ExcelAddinFiles" 
   State="Absent" 
   Children="force" 
/>

Elemento PIDKEY

A chave de licença de volume de 25 caracteres.

Observação

A opção equivalente na OCT é a configuração da Chave de produto em Licenciamento e interface do usuário no Referência da Ferramenta de Personalização do Office (OCT) do Office 2013. Para obter mais informações sobre licenciamento por volume no Office Professional 2013, consulte Planejar a ativação por volume do Office 2013. Uma entrada de chave de produto não é exigida para implantações empresariais que usam a ativação KMS (Serviço de Gerenciamento de Chaves), pois todas as edições de Licença por Volume do Office 2013 têm uma chave de cliente KMS pré-instalada. KMS é um dos métodos fornecidos pela Office Activation Technologies para ativação de produtos licenciados sob os programas de Licenciamento por Volume da Microsoft. O KMS usa uma chave de host KMS para ativar um computador host KMS e estabelecer um serviço de ativação local em seu ambiente. O Office 2013 se conecta ao host KMS local para ativação. Por padrão, a opção Usar chave do cliente KMS está selecionada na OCT (na seção Licenciamento e interface do usuário). Uma chave MAK (Chave de Ativação Múltipla) é outro método fornecido pela Office Activation Technologies para ativar produtos licenciados sob os programas de Licenciamento por Volume da Microsoft. Ao usar uma MAK, os clientes ativam o Office 2013 online com servidores de ativação hospedados pela Microsoft ou por telefone. Os administradores podem usar o arquivo Config.xml para digitar uma chave MAK. Consulte a seção Comentários para obter mais informações sobre como adicionar uma chave MAK. Semelhante à ativação KMS, que ativa todos os clientes de Licença por Volume do Office conectados a um host KMS, a ativação baseada no Active Directory ativa todos os clientes de Licença por Volume do Office em um domínio do Active Directory. Para obter mais informações sobre a ativação baseada no Active Directory, confira Visão Geral da Ativação Baseada no Active Directory. Para obter mais informações sobre a ativação por volume, confira Planejar a ativação por volume do Office 2013.

Importante
Essas informações se aplicam às edições de licença por volume do Office 2013. Elas não se aplicam ao Office 365 ProPlus, que é licenciado por assinatura.

Sintaxe

<PIDKEY Value=" 25-character-key " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento PIDKEY.

Atributos de PIDKEY

Atributo	Valor	Descrição
Value	25-character-key	A chave de licença de volume de 25 caracteres.

Comentários

Quando o valor PIDKEY é definido, os usuários não precisam inserir uma chave de produto quando instalam o Office.

Para digitar uma chave MAK no arquivo Config.xml, adicione a seguinte linha ao arquivo.

<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />

Onde AAAAABBBBBCCCCCDDDDDEEEEE é a chave de produto de 25 caracteres. Para obter mais informações sobre o licenciamento para Office 2013, consulte Ativação por volume do Office 2013.

Exemplo

<PIDKEY Value="1234512345123451234512345" />

Observação

Se o atributo Level de Elemento Display for definido como "básico" ou "nenhum" e você fornecer uma chave de produto usando o elemento PIDKEY, a Instalação supõe que você também aceita o contrato de licença em nome do usuário. Nesse caso, independentemente de como você define o atributo AcceptEULA do Elemento Display, o usuário não recebe uma solicitação pelo contrato de licença durante a instalação ou na primeira vez que um aplicativo do Office é executado.

Elemento RemoveLanguage

Remove o idioma especificado da instalação.

Sintaxe

<RemoveLanguage Id=" ll - cc " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento RemoveLanguage.

Atributos de RemoveLanguage

Atributo	Valor	Descrição
Id	ll-cc	O identificador do idioma.

Comentários

Se o idioma não estiver instalado no computador do usuário, o elemento RemoveLanguage será ignorado.

É possível ter múltiplos elementos para Elemento AddLanguage e RemoveLanguage. Se os elementos RemoveLanguage e Elemento AddLanguage especificarem o mesmo idioma, o elemento Elemento AddLanguage terá precedência e o idioma será instalado.

Exemplo

<RemoveLanguage Id="en-us" />

Elemento Setting

Permite que você especifique valores para as propriedades do Windows Installer.

Sintaxe

<Setting Id=" name " Value=" value " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento Setting.

Definição dos Atributos

Atributo	Valor	Descrição
Id	name	O nome da propriedade do Windows Installer.
Value	value	O valor a ser atribuído à propriedade.

Comentários

Nem todas as propriedades do Windows Installer podem ser especificadas no elemento Setting. Se uma propriedade bloqueada for especificada, a Instalação encerrará o processo de instalação. Se uma propriedade suportada for especificada, a Instalação passará a propriedade diretamente para o Windows Installer.

O elemento Setting suporta as seguintes propriedades de KMS (Sistema de Gerenciamento de Chaves):

• KMSSERVICENAME — Especifica o nome do host KMS.

• KMSSERVICEPORT — Especifica a porta do host KMS.

Por exemplo, para usar as propriedades de KMS, use a seguinte sintaxe:

<Setting Id="KMSSERVICENAME" Value="contoso.com" />

<Setting Id="KMSSERVICEPORT" Value="1234" />

na qual:

contoso.com é o nome do host KMS

1234 é o valor do número de porta

Observação

A ferramenta recomendada para especificar os valores de KMSSERVICENAME e KMSSERVICEPORT é o script da Office Software Protection Platform (ospp.vbs). Para definir o nome do host KMS e os valores de porta usando ospp.vbs, execute os seguintes comandos: ospp.vbs /sethst:value ospp.vbs /setprt:value No exemplo anterior, o sethst value é o nome do host KMS e o setprt value é a porta do host KMS. Como alternativa, é possível definir os atributos de KMS no arquivo Config.xml, como em um cenário que tem uma instalação de 32 bits do Office 2013 em um computador que executa uma edição de 64 bits do Windows. Para obter informações sobre a ativação por volume, consulte Planejar a ativação por volume do Office 2013.

O elemento Setting suporta a propriedade AUTO_ACTIVATE para ativação da chave de produto. Essa propriedade especifica que a ativação do produto ocorre automaticamente durante a implantação do Office 2013 e usa a seguinte sintaxe.

<Setting Id="AUTO_ACTIVATE" Value="1" />

Observação

Não configurar o AUTO_ACTIVATE é o mesmo que configurar AUTO_ACTIVATE com um value de 0. O resultado é que a ativação do produto não ocorre durante a implantação do Office 2013. Observe que você também pode definir o valor da propriedade AUTO_ACTIVATE usando a Ferramenta de Personalização do Office. Para fazer isso, execute as etapas seguintes: Na OCT, selecione Modificar propriedades da Instalação no painel de navegação e clique em Adicionar no painel de detalhes. Na caixa de diálogo Adicionar Valor de Propriedade, na caixa Nome, digite AUTO_ACTIVATE. Observe que os nomes de propriedade precisam estar em letra maiúscula. Na caixa Valor, digite 1 e clique em OK.

O elemento Setting suporta a propriedade REMOVEPREVIOUS. Essa propriedade remove o aplicativo especificado da instalação e usa a seguinte sintaxe.

<Setting Id="REMOVEPREVIOUS" Value="Option Id" />

na qual Option Id é o valor do identificador para o aplicativo Office 2013. Para especificar múltiplos aplicativos, use uma lista separada por vírgulas para indicar os valores apropriados de Option Id.

Observação
Se você instalar o Outlook, uma versão instalada anteriormente do Outlook sempre será removida, independentemente da preferência do usuário.

Se você especificar REMOVEPREVIOUS com um valor de Option Id, somente os aplicativos especificados serão removidos.

Se você não especificar o REMOVEPREVIOUS, quaisquer aplicativos do Office instalados anteriormente para os quais uma substituição está sendo instalada serão removidos. Esse é o comportamento padrão.

Se você especificar REMOVEPREVIOUS com um valor em branco (REMOVEPREVIOUS=""), nenhum aplicativo será removido.

O elemento Setting também suporta a propriedade SETUP_REBOOT. O SETUP_REBOOT começa uma reinicialização após a instalação. Ele usa a seguinte sintaxe. É necessário usar letras maiúsculas para a propriedade SETUP_REBOOT.

<Setting Id="SETUP_REBOOT" Value="value" />

na qual value pode ser um dos seguintes:

• AutoAlways — Sempre inicia uma reinicialização. Não solicita ao usuário.

• Always — Sempre solicita uma reinicialização ao final da instalação.

• IfNeeded — Solicita uma reinicialização ao final da instalação, se a instalação exigir uma reinicialização. (Padrão)

• AutoIfNeeded — Inicia uma reinicialização se a instalação exigir uma reinicialização. Não solicita ao usuário.

• Never — Nunca inicia ou solicita uma reinicialização.

Exemplos

<Setting Id="SETUP_REBOOT" Value="Never" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />

Elemento SetupUpdates

Especifica o caminho de pesquisa para a Instalação usar a fim de encontrar os arquivos de personalização da Instalação

Sintaxe

<SetupUpdates

[CheckForSUpdates="Yes"(padrão) | "No"]

[SUpdateLocation="path-list"]

/>

Atributos

A tabela a seguir descreve os atributos e valores do elemento SetupUpdates.

Atributos de SetupUpdates

Atributo	Valor	Descrição
CheckForSUpdates	Yes (padrão)	A Instalação usa a lista de caminhos em SUpdateLocation para encontrar os arquivos de personalização da Instalação.
	No	A Instalação não pesquisa por arquivos de personalização da Instalação usando a lista de caminhos em SUpdateLocation.
SUpdateLocation	path-list	Uma lista de caminhos totalmente qualificados para pastas, separada por pontos e vírgulas. Observação As variáveis do ambiente não podem ser usadas no caminho SUpdateLocation. Se uma variável do ambiente for usada no caminho, a Instalação ignorará os arquivos de atualização localizados no local do caminho especificado.

Comentários

A Instalação procura em todas as pastas especificadas por arquivos de personalização da Instalação criados para o produto que está sendo instalado e os aplica em ordem alfabética por nome de arquivo. Se um arquivo de personalização da Instalação tiver sido especificado na linha de comando da Instalação, esse arquivo será aplicado primeiro, seguido por quaisquer arquivos encontrados na pasta especificada por esse elemento.

Exemplo

<SetupUpdates
   CheckForSUpdates="Yes"
   SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>

Elemento USERINITIALS

As iniciais do usuário cujo computador está recebendo o produto.

Sintaxe

<USERINITIALS Value=" value " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento USERINITIALS.

Atributos de USERINITIALS

Atributo	Valor	Descrição
Value	value	As iniciais do usuário

Exemplo

<USERINITIALS Value="JD" />

Elemento USERNAME

O nome do usuário cujo computador está recebendo o produto.

Sintaxe

<USERNAME Value=" value " />

Atributos

A tabela a seguir descreve os atributos e valores do elemento USERNAME.

Atributos de USERNAME

Atributo	Valor	Descrição
Value	value	O nome do usuário.

Comentários

Os dados do elemento Office 2013  Username são preenchidos da seguinte maneira.

Se o usuário que executa o Office for o mesmo usuário que instalou o Office, o Username e as Initials fornecidas durante a instalação serão usadas. O usuário não recebe uma solicitação quando o Office inicia pela primeira vez. Esse caso é mais popular para usuários domésticos que instalam o Office por conta própria.

Se o usuário que estiver executando o Officenão for o mesmo usuário que instalou o Office, o Office solicitará a confirmação do Username e das Initials quando o Office iniciar pela primeira vez. Esse caso é mais popular em um ambiente corporativo, no qual um administrador instala o Office para o usuário.

O valor do elemento Username exibido ao usuário na primeira inicialização pode ser pré-preenchido com um valor padrão de uma versão instalada anteriormente do Office ou do usuário conectado atualmente. Observe que o valor padrão não é usado a menos que seja confirmado pelo usuário. Se uma versão anterior do Office estiver instalada no computador, a chave do registro criada pela versão anterior do Office será usada. Por exemplo, se a instalação anterior do Office for o Microsoft Office 2003, a chave do registro será fornecida em HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo.

Exemplo

<USERNAME Value="John Doe" />

Amostra do arquivo Config.xml

O exemplo a seguir mostra um arquivo Config.xml para uma instalação típica . O exemplo usa a versão Office Professional Plus 2013 do produto.

<Configuration Product="ProPlus">

<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->

<!-- <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" /> -->

<!-- <USERNAME Value="Customer" /> -->

<!-- <COMPANYNAME Value="MyCompany" /> -->

<!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->

<!-- <LIS CACHEACTION="CacheOnly" /> -->

<!-- <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->

<!-- <DistributionPoint Location="\\server\share\Office" /> -->

<!-- <OptionState Id="OptionID" State="absent" Children="force" /> -->

<!-- <Setting Id="SETUP_REBOOT" Value="IfNeeded" /> -->

<!-- <Command Path="%windir%\system32\msiexec.exe" Args="/i \\server\share\my.msi" QuietArg="/q" ChainPosition="after" Execute="install" /> -->

</Configuration>

Consulte também

Referência da Ferramenta de Personalização do Office (OCT) do Office 2013
Versões de 64 bits do Office 2013