Arquivo Config.xml no Office System 2007

Atualizado: setembro de 2010

Aplica-se a: Office Resource Kit

 

Tópico modificado em: 2015-03-09

Se você for profissional de TI e usar o TechNet ou o Office Resource Kit, dê uma olhada em nossa Pesquisa Online (em inglês) (https://go.microsoft.com/fwlink/?linkid=132189\&clcid=0x416) (em inglês). Mostre-nos como podemos atender melhor às suas necessidades de documentação. Leia mais sobre o nosso trabalho para aprimorar a documentação no Blog do Office Resource Kit (em inglês) (https://go.microsoft.com/fwlink/?linkid=125627\&clcid=0x416) (em inglês).

Neste artigo:

• Referência rápida de elementos do Config.xml

• Como funciona

• Formato de arquivo Config.xml

• Referência de elementos do Config.xml

• Exemplo de arquivo Config.xml

A principal ferramenta que você usa para personalizar a instalação de produtos do Microsoft Office 2007 é a Ferramenta de Personalização do Office (OCT). Para obter mais informações sobre como criar arquivos de personalização de Instalação, consulte Ferramenta de Personalização do Office no 2007 Office system.

O arquivo config.XML é usado para configurar as tarefas de instalação e é usado somente durante a execução da instalação; não é instalado ou incluído no cache dos computadores dos usuários. Os administradores podem editar o arquivo Config.xml para personalizar a instalação. Por padrão, o arquivo Config.xml que é armazenado nas pastas de produto principal (nome_da_pasta_de_produto_principal .WW pasta, por exemplo, Enterprise.WW ou Pro.WW) direciona a instalação para instalar esse produto. Por exemplo, o arquivo Config.xml da pasta Pro.WW instala o Microsoft Office Professional 2007.

Você usa o arquivo Config.xml para realizar as seguintes tarefas de instalação:

• Especificar o caminho para o ponto de instalação de rede.

• Selecionar os produtos que devem ser instalados

• Personalização das opções de Instalação, como o registro em log e o local do arquivo de personalização de Instalação e atualizações de software

• Configuração das opções de instalação, como nome da empresa e do usuário

• Cópia da origem local de instalação (LIS) para o computador do usuário sem instalar o Office

• Adicionar ou remover idiomas na instalação

O arquivo Config.xml também pode ser usado para operações de manutenção, como a adição ou remoção de recursos e reparações e desinstalações. Para isso, os administradores devem executar novamente Setup.exe a partir da fonte original. Para obter mais informações, consulte o tópico "sobre como usar o arquivo Config.xml para manutenção" em Práticas recomendadas para a manutenção do Office System 2007.

O arquivo Config.xml é necessário para personalizar uma instalação que você implanta com a Instalação do Software de Diretiva de Grupo. Para obter mais informações, consulte Usar a Diretiva de Grupo de Instalação de Software para implantar o sistema 2007 Office.

Importante:
Use um editor de texto, como o Bloco de Notas, para editar o Config.xml. Não use um editor XML genérico, como o Microsoft Office Word 2007.

Para obter informações sobre a edição do arquivo Config.xml e para ver um exemplo de um arquivo Config.xml personalizado, consulte Implantar configurações personalizadas do 2007 Office system (passo a passo).

Referência rápida do elemento Config.xml

A tabela a seguir contém uma lista dos elementos do Config.xml. Esses elementos podem aparecer em qualquer ordem, exceto por Elemento de configuração, que deverá ser o primeiro, e elementos como Elemento de comando, cuja ordem no Config.xml afetará a forma como os comandos serão processados durante a instalação.

Elemento	Descrição
Elemento de configuração	Elemento de nível superior.
Elemento AddLanguage	Adicionar um idioma para a instalação
Elemento de ARP	Valores que controlam o texto e o comportamento de Adicionar ou Remover Programas no Painel de Controle para o produto.
Elemento CCP_DRIVE	O caminho totalmente qualificado para a pasta que será pesquisada por RMCCPSEARCH
Elemento de comando	Executa um comando durante a instalação.
Elemento COMPANYNAME	O nome da organização ou empresa do usuário em cujo computador o produto está sendo instalado
Elemento de exibição	O nível de interface do usuário que a Instalação exibe para o usuário.
Elemento DistributionPoint	O caminho totalmente qualificado para o ponto de instalação da rede do qual a instalação é executada
Elemento INSTALLLOCATION	O caminho totalmente qualificado para a pasta no computador do usuário na qual o produto está instalado.
Elemento LIS	Opções para especificar como a fonte de instalação local é armazenada em cache no computador do usuário.
Elemento de log	Opções para o tipo de log executado pela Instalação.
Elemento MinOSRequirement	O sistema operacional mínimo aceito para este produto
Elemento OptionState	Opções para especificar recursos do produto como individuais devem ser manipulados durante a instalação
Elemento PIDKEY	A chave de licença de volume de 25 caracteres
Elemento RemoveLanguage	Remover um idioma da instalação
Elemento de configuração	Valores para as propriedades do Windows Installer.
Elemento SetupUpdates	O caminho de pesquisa para Instalação a ser usado para localizar arquivos de personalização de instalação
Elemento USERINITIALS	As iniciais do usuário em cujo computador o produto está sendo instalado
Elemento USERNAME	O nome do usuário em cujo computador o produto está sendo instalado

Como funciona

A instalação procura uma cópia do arquivo Config.xml na mesma pasta que Setup.exe estiver. Se uma cópia não for encontrada ali, o programa de instalação usará o arquivo Config.xml que reside na pasta do produto principal para o produto que você está instalando (se houver vários produtos da instalação de rede, a Instalação espera até você especificar qual produto será instalado antes de procurar a cópia do arquivo Config.xml). A cópia do arquivo Config.xml que reside na pasta do produto identifica o produto através do atributo Product do elemento Elemento de configuração.

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:

\\ servidor \ compartilhamento \setup.exe /config \\ servidor \ compartilhamento \Enterprise.WW\Config.xml

Observação:
Se você também criou um arquivo de personalização de instalação usando a OCT, as personalizações que você definir no arquivo Config.xml prevalecerão sobre as do arquivo de personalização.

Formato de arquivo Config.xml

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

O formato básico de elementos é:

< elemento [atributo**="valor"] [atributo="valor"**] … />

Por exemplo:

<Display Level="none" AcceptEula="Yes" />

Os elementos e os atributos diferenciam maiúsculas e minúsculas. Os valores de atributos devem ser codificados entre aspas (") e não diferenciam maiúsculas e minúsculas.

Uma definição de elemento pode abranger várias linhas. Espaços, retornos de carro, alimentações de linha e caracteres de tabulação são ignorados na definição de um elemento.

Por exemplo:

<Display
   Level="none"
   AcceptEula="yes"
/>

Dica:
Para definições de elemento longas, coloque atributos em linhas separadas e use o recuo para facilitar a leitura do arquivo.

O elemento Elemento de configuração é um caso especial e é necessário. Todos os outros elementos estão contidos no elemento Elemento de configuração e ele é fechado com </Configuration>.

Por exemplo:

<Configuration Product="Enterprise">
   <PIDKEY Value="1234512345123451234512345" />
   <Display Level="none" AcceptEula="Yes"/>
</Configuration>

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

Por exemplo:

<!-- Install Office Enterprise 2007 -->
<Configuration Product="Enterprise" >
   <!-- Set the product key -->
   <PIDKEY Value="1234512345123451234512345" />
   <Display
      <!-- Turn off all Setup UI -->
      Level="none"
      <!-- Accept the EULA for the user -->
      AcceptEula="Yes"
   />
</Configuration>

Cada pasta de produto do Office contém um arquivo config.XML padrão, que consiste em um elemento Elemento de configuração com o atributo Product definido como o valor apropriado para o produto. Um número de elementos de exemplo incluído em comentários está incluído no elemento Elemento de configuração. Remova o início e e o fechamento de marcas de comentário e insira os valores de atributo apropriado para ativar esses elementos.

Por exemplo, você pode ativar o elemento Elemento PIDKEY alterando:

<!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->

Para:

<PIDKEY Value="1234567890123456789012345" />

Referência de elemento Config.xml

As convenções a seguir são usadas nas descrições desta referência:

negrito	Elemento ou nome do atributo
normal	Texto a ser inserido exatamente como mostrado
itálico	Espaço reservado para um valor a ser adicionado
x|y	Escolha entre vários valores
[x]	Valor opcional

Elemento de configuração

Elemento de nível superior. Esse elemento é necessário e todos os outros devem aparecer dentro dele.

Sintaxe

<Configuration [Product="productID"] >

   ...

</Configuration>

Atributos

Atributo	Valor	Descrição
Produto	productID	O valor do atributo ID no elemento de configuração 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 para o produto, no atributo ID do elemento Setup.

O atributo Product é opcional, a menos que você defina o atributo Elemento de exibiçãoLevel como "Basic" ou "None". Nesse caso, o atributo Product será obrigatório. Se o produto especificado pelo atributo Product não existir no ponto de instalação de rede, o programa de instalação terminará a instalação.

Exemplo

O productID para o Office Enterprise 2007 está localizado em Enterprise.WW\Setup.xml, na seguinte linha:

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

Você usa esse productID no arquivo Config.xml para especificar o Office Enterprise 2007 digitando o seguinte:

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

Elemento AddLanguage

Adiciona o idioma especificado para a instalação.

Sintaxe

< AddLanguage

ID = " ii-cc " | "correspondência"

   [ShellTransform="Yes"]

/>

Atributos

Atributo	Valor	Descrição
Id	ii - cc	O identificador de idioma. Para obter uma lista completa de marcas de idioma, consulte Identificadores de idioma no Office System 2007.
	match	Corresponde ao idioma da localidade de usuário do Windows do usuário.
ShellTransform	Yes	Especifica o idioma para a interface de usuário do shell. Se mais de um elemento AddLanguage for especificado, um (e somente um) idioma deverá especificar o elemento ShellTransform.

Comentários

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

Você pode ter vários elementos 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 (e somente um) idioma deverá especificar que o elemento ShellTransform ou a Instalação terminará a instalação.

Há três conceitos de idioma diferente, que você deve conhecer ao instalar o 2007 Office system:

• Interface do usuário da Instalação: o idioma da instalação.

• Interface do usuário do shell: o idioma de atalhos, menus de contexto de dois cliques e dicas de ferramentas.

• Interface do usuário do Office: o idioma da interface do usuário e menus do Office.

Quando houver vários idiomas do Office, esses três valores serão determinados da seguinte maneira:

Por padrão, a interface do usuário de configuração depende do conjunto de recursos disponíveis para instalação e a capacidade de coincidir com a localidade do usuário. A interface do usuário de Instalação corresponderá à localidade do usuário por padrão. A interface do usuário do shell depende do conjunto de idiomas que está sendo instalado e por padrão, ele segue a interface do usuário de Instalação. O idioma de interface do usuário do Office padrão depende na localidade do usuário e de configurações de usuário atuais. 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 interface do usuário de instalação, a interface do usuário do shell e a interface do usuário do Office serão iguais.

Uma localidade nos sistemas operacionais Windows é um conjunto de informações relacionadas ao idioma, ambiente e convenções culturais do usuário. Essa informação é representada como uma lista de valores usados para determinar o idioma de entrada correto, layout de teclado, ordem de classificação e os formatos usados para números, datas, moedas e tempo. A localidade do usuário é uma configuração feita por usuário que determina os formatos usados por padrão para exibir datas, horas, 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 o administrador especificar vários idiomas para a instalação no arquivo Config.xml, o idioma UI do shell deverá ser escolhido no conjunto de idiomas de instalação. Para fazer isso, os administradores especificam o atributo ShellTransform do elemento AddLanguage no arquivo Config.xml. Isso especifica o idioma de instalação que deve ser usado para a interface do usuário do shell. No entanto, isso não afetará necessariamente a opção da interface do usuário da Instalação ou da interface do usuário do Office na instalação do 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 o programa de instalação instale suporte de idioma completo para esses idiomas e fazer com a interface do usuário do shell execute opções regionais do usuário padrão, 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, o programa instala todos os idiomas especificados e a interface do usuário do shell corresponde ao idioma da localidade do usuário. Se houvesse mais idiomas disponíveis na imagem de origem, o valor de correspondência no exemplo anterior poderia instalar um idioma adicional no caso em que o idioma de correspondência não fosse resolvido para um dos outros quatro idiomas explicitamente chamados. Por exemplo, se japonês também fosse incluído na origem, este exemplo instalaria japonês juntamente com os outros quatro idiomas em um computador com a localidade do usuário definida como japonês.

Exemplo

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

Elemento de ARP

Especifica valores que controlam o texto e o comportamento de Adicionar ou Remover Programas no Painel de Controle para o produto.

Sintaxe

<ARP atributo =" valor " [atributo**="valor"**] ... />

Atributos

Atributo	Valor	Descrição
ARPCOMMENTS	texto	Texto adicional; pode ter até 255 caracteres, embora nem todos eles sejam exibidos.
ARPCONTACT	texto	Lista de contatos de suporte técnico.
ARPNOMODIFY	Yes	Impede que os usuários modifiquem a instalação do produto tornando o botão Alterar indisponível.
	No (padrão)	Permite que o usuário modifique a instalação do produto.
ARPNOREMOVE	Yes	Impede que os usuários removam o produto tornando o botão Remover indisponível.
	No (padrão)	Permite que os usuários removam o produto.
ARPURLINFOABOUT	URL	URL da home page do produto.
ARPURLUPDATEINFO	URL	URL para informações sobre atualizações do produto.
ARPHELPLINK	URL	URL de um site do qual os usuários podem receber suporte técnico.
ARPHELPTELEPHONE	texto	Números de telefone de suporte técnico.

Elemento CCP_DRIVE

O caminho totalmente qualificado para a pasta que RMCCPSEARCH destina-se à pesquisa. A ação RMCCPSEARCH usa assinaturas de arquivo para verificar se os produtos qualificados estão instalados em um sistema antes da execução de uma instalação de atualização.

Sintaxe

<CCP_DRIVE Value=" valor " />

Atributos

Atributo	Valor	Descrição
Value	valor	O caminho totalmente qualificado para a pasta que deve ser pesquisado por RMCCPSEARCH

Exemplo

<CCP_DRIVE Value="\\server\office2003" />

Elemento de comando

Especifica uma linha de comando a ser executada. Consulte a seção Comentários para obter mais informações.

Dica:
A opção equivalente na OCT é Adicionar instalações e executar programas.

Sintaxe

<Command

   Path="caminho"

[QuietArg="argumentos"]

[Args="argumentos"]

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

[Wait="milissegundos"]

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

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

/>

Atributos

A tabela a seguir descreve os atributos do elemento Comando.

Atributo	Valor	Descrição
Path	caminho	Caminho totalmente qualificado do arquivo executável. Se o valor de caminho contiver um espaço, use aspas duplas, como mostrado neste exemplo: "\\server\share\Office 12\copylogs.bat"
QuietArg	cadeia de caracteres	Cadeia de caracteres de argumentos a ser anexada à 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, depois desta tabela.
Args	cadeia de caracteres	Cadeia de caracteres de argumentos a ser passada para o executável. Para obter informações sobre quando usar o atributo Args para instalações encadeadas, consulte a seção Comentários, depois desta tabela. Se o valor do elemento Args incluir aspas, coloque o valor inteiro entre aspas simples ('), como mostrado neste exemplo: Args='"/param value"'
ChainPosition	Antes	Esse comando é executado antes da instalação do produto principal.
	After (default)	Esse comando é executado após a instalação do produto principal.
Wait	milissegundos	Quando você instala um produto com o atributo Elemento de exibiçãoLevel definido como "full" ou "basic", esse será o número de milissegundos de espera após a execução do programa e antes de você prosseguir com a instalação. O padrão é 0 (zero), que indica nenhuma espera.
Execute	Install (padrão)	A Instalação executa este comando quando o produto principal é instalado.
	Uninstall	A Instalação executa este comando quando o produto principal é desinstalado.
Platform	x86 (padrão)	Especifica que esse programa exige a plataforma x86 da Intel. Esse comando só será executado se o computador na qual a instalação está sendo executada atender ao requisito de plataforma.
	x64	Especifica que esse programa exige um processador de 64 bits que dê suporte a extensões x64 para a arquitetura x86. Esse comando só será executado se o computador na qual a instalação está sendo executada atender ao requisito de plataforma.

Comentários

O elemento Command do arquivo Config.xml e a opção Adicionar instalações e executar programas da OCT (linhas de comando inseridas nas caixas de diálogo Adicionar Entrada de Programae Modificar Entrada de Programa) foram criados para serem usados somente por instalações e desinstalações iniciais do produto. Os comandos do elemento Command são processados somente durante instalações e desinstalações iniciais. 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 arbitrário ou um executável leve a ser executado quando esse produto for instalado.

O elemento Command do Config.xml e a opção Adicionar instalações e executar programas da OCT não fornecem os recursos de implantação de software que uma ferramenta de implantação e gerenciamento de software fornece. Por isso, é recomendável limitar o uso do elemento Command do Config.xml e da opção Adicionar instalações e executar programas da OCT, definindo a execução só de executáveis leves ou de comandos arbitrários que não façam alterações no computador ou que não exijam entrada do usuário. Por exemplo, você pode executar um utilitário para copiar ou um comando para iniciar a página de boas-vindas no final da instalação.

Importante:

O encadeamento não é tão confiável quando a instalação de cada produto é feita 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 poderão não ser concluídas com êxito. Portanto, não é recomendável o uso da abordagem de encadeamento. O método recomendado para instalar vários produtos juntos em ambientes empresariais é usar, em vez do encadeamento, um programa de gerenciamento de implantações, como o Microsoft System Center Configuration Manager 2007 ou o SMS (Microsoft Systems Management Server) 2003, ou ainda uma ferramenta de terceiros.

A utilização de Args e de QuietArg ocorre da seguinte maneira:

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

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

As instruções a seguir são aplicáveis ao atributo Wait:

• A definição do atributo Wait como 0 milissegundo indica que não haverá nenhuma espera depois que você executar o programa e antes de continuar a instalação; o comando será executado e movido imediatamente.

  Os códigos de retorno só serão respeitados se o valor de Wait não for zero. Se você especificar 0, a Instalação não esperará para continuar a instalação após a execução do programa especificado, portanto, não haverá nenhum código de retorno a ser relatado nesse caso.

• A definição do atributo Wait com um valor positivo diferente de zero esperará exatamente o número de milissegundos especificado. Se o processo for concluído antes do tempo especificado, a Instalação continuará. Se o processo não terminar no tempo especificado, a Instalação falhará.

• A definição do atributo Wait como -1 indica uma espera interminável. Isso pode ser problemático, pois se o processo de comando parar de responder (paradas), a Instalação não responderá mais e ficará indefinidamente à espera da execução do comando.

Se houver dois ou mais elementos Command no arquivo Config.xml, eles serão executados na ordem em que foram especificados no arquivo 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 em cujo computador o produto está sendo instalado.

Dica:
A opção equivalente na OCT é a configuração Nome da organização em Local da instalação e nome da organização.

Sintaxe

< valor COMPANYNAME = " companyname " / >

Atributos

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

Exemplo

<COMPANYNAME Value="Microsoft Corporation" />

Elemento de exibição

O nível de interface do usuário que a Instalação exibe para o usuário.

Dica:
A opção equivalente na OCT é o Nível da exibição e as configurações de acordo de licença em “Licenciamento e interface do usuário” em Ferramenta de Personalização do Office no 2007 Office system.

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

Atributo	Valor	Descrição
Level	Nenhum	Nenhuma interface do usuário da Instalação será exibida. A configuração Display Level="none" faz com que a Instalação seja executada silenciosamente (instalação autônoma). Consulte a seção Comentários para obter mais informações.
	Basic	A Instalação exibe a tela de boas-vindas, a página de Chave do Produto (PIDKEY) (se necessário), a página do Contrato de Licença de Usuário Final (EULA) (se necessário), uma barra de progresso e o aviso de conclusão (se permitido).
	Full (padrão)	A Instalação exibe todas as interfaces do usuário.
CompletionNotice	Yes	Só se aplica se Level for definido como "Basic" ou "None": a Instalação exibirá o aviso de conclusão.
	No (padrão)	Só se aplica se Level for definido como "Basic": a Instalação não exibirá o aviso de conclusão.
SuppressModal	Yes	Só se aplica se Level for definido como "Basic": a Instalação não exibirá mensagens de erro e outras caixas de diálogo que possam interrompê-la.
	No (padrão)	Só se aplica se Level for definido como "Basic": a Instalação exibirá erros e outras caixas de diálogo, se necessário.
NoCancel	Yes	Se Level for definido como "Full" ou "Basic", desabilita o botão de cancelamento (X no canto superior direito da caixa de diálogo de andamento).
	No (padrão)	Se Level for definido como "Full" ou "Basic", permite que o usuário cancele a instalação a partir da barra de andamento.
AcceptEULA	Yes	O Contrato de Licença de Usuário Final foi aceito em nome de usuário. A instalação não exibe a página do EULA.
	No (padrão)	Se nível não estiver definido como "none", o programa de instalação exibirá a página de EULA.

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 "Basic" ou "None" e se você fornecer uma chave do produto usando o elemento Elemento PIDKEY, a Instalação vai supor que você também aceita os termos de licença em nome do usuário.

Observação:

Em implantações corporativas, é recomendável que você defina o valor de Display level como None para fazer com que a Instalação seja executada silenciosamente, impedir a solicitação de informações aos usuários e evitar que a instalação precise aguardar qualquer interação do usuário, inclusive quando os arquivos estiverem em uso. Definir Display level como None pressupõe que os atributos SuppressModal e CompletionNotice sejam silenciados e que o EULA seja aceito. Os administradores também devem assegurar que não haja aplicativos do Office em execução durante a instalação do 2007 Office system. Se você definir o valor Display level como basic e SuppressModal como yes, os usuários poderão ser avisados caso qualquer arquivo do Office esteja em uso. Definir Display level como none impede o aviso aos usuários em tais casos. O atributo SuppressModal não impede que mensagens arquivos em uso sejam exibidas; somente Display level definido como nenhum impede sua exibição. O elemento Display é usado pelo programa de instalação somente se a instalação encontrar o arquivo Config.xml na mesma pasta do setup.exe, ou se você especificar o arquivo Config.xml, usando a opção de linha de documento /config da Instalação. Se a Instalação usar o arquivo Config.xml na pasta do produto, usará as opções de exibição padrão.

Exemplo

<Display Level="none" AcceptEula="Yes" />

Elemento DistributionPoint

O caminho totalmente qualificado para o ponto de instalação da rede do qual a instalação é executada

Sintaxe

< DistributionPoint Location = " caminho " / >

Atributos

Atributo	Valor	Descrição
Local	caminho	O caminho totalmente qualificado para o ponto de instalação da rede do qual a instalação é executada

Comentários

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

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

Exemplo

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

Elemento INSTALLLOCATION

Especifica o caminho totalmente qualificado para a pasta no computador do usuário na qual o produto está instalado.

Dica:
A opção equivalente na OCT é a configuração Caminho de instalação padrão em Local da instalação e nome da organização.

Sintaxe

<INSTALLLOCATION Value=" caminho " />

Atributos

Atributo	Valor	Descrição
Value	caminho	O caminho totalmente qualificado para a pasta no computador do usuário na qual o produto está instalado.

Comentários

Você pode usar variáveis de ambiente do sistema no caminho. Se este elemento não for especificado, o Office será instalado em %ProgramFiles%\Microsoft Office.

Exemplo

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

Elemento LIS

Controla o modo como a fonte de instalação local (LIS) é armazenada em cache no computador do usuário e especifica o local de um ou mais pontos de rede de instalação que contêm os arquivos de instalação do produto.

Sintaxe

< LIS

[CACHEACTION = "CacheOnly" | "RemoveCacheOnly"]

SOURCELIST = " delimitada por ponto-e-vírgula-caminho-lista "]

/>

Atributos

Atributo	Valor	Descrição
CACHEACTION	CacheOnly	A instalação copiará o LIS computador do usuário, mas não instala o produto.
	RemoveCacheOnly	Se o cache for copiado para o computador do usuário e Office não estiver instalado, o programa de instalação removerá o LIS do computador do usuário, mas não instalará, nem desinstalará o produto.
SOURCELIST	delimitada por ponto-e-vírgula-caminho-lista	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 é Fontes de rede adicionais.

Comentários

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

Se você especificar Elemento INSTALLLOCATION, a designação de unidade no caminho será usada para determinar em qual unidade o LIS é criado. Por exemplo, se o caminho Elemento INSTALLLOCATION for E:\office\files, o recurso LIS produto é criado na unidade e. As fontes listadas pelo atributo SOURCELIST são mantidas com o produto instalado e são usadas pelo programa de instalação se a origem de instalação local (LIS) no computador do usuário está faltando ou corrompido.

Exemplo

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

Elemento de log

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

Sintaxe

<Logging

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

   Path="caminho"

   Template="nome_de_arquivo.txt"

/>

Atributos

Atributo	Valor	Descrição
Type	Off	A Instalação não cria nenhum log.
	Standard (padrão)	A Instalação grava informações no arquivo de log.
	Verbose	A Instalação grava todas as informações de instalação no arquivo de log.
Path	caminho	O caminho totalmente qualificado para a pasta usada para o arquivo de log. Você pode usar variáveis de ambiente. O padrão é %temp%.
Template	nome_de_arquivo .txt	O nome do arquivo de log. Se você inserir a cadeia de caracteres * em qualquer lugar do nome de arquivo, um arquivo de log exclusivo será criado para cada instalação realizada por Setup.exe (veja a explicação abaixo). Se * não for incluído e o nome de arquivo especificado já existir, as informações de log serão anexadas ao arquivo existente. A extensão de arquivo .txt deverá ser incluída. O modelo padrão é SetupExe(*).log.

Comentários

Você pode especificar um * em qualquer lugar no valor de Template. A Instalação insere uma cadeia de caracteres nesse local com o seguinte formato:

AAAAMMDDHHMMSS xxx

em que:

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 só será usado pelo programa de instalação se a instalação encontrar o arquivo Config.xml na mesma pasta do 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, usará as opções de log padrão.

Exemplo

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

Com esse exemplo, a Instalação cria um arquivo de log cada vez que instala o produto. A Instalação usa nomes de arquivo exclusivos, como os seguintes:

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

Elemento MinOSRequirement

Especifica o sistema operacional mínimo para este produto.

Sintaxe

< MinOSRequirement

VersionNT = " versão "

   WindowsBuild="número"

   ServicePackLevel="número"

/>

Atributos

Atributo	Valor	Descrição
VersionNT	Controle de versão	Versão do Windows NT
WindowsBuild	número	Número da compilação do Windows
ServicePackLevel	número	Número do service pack do Windows

Os seguintes valores podem ser usados.

Sistema	VersionNT	WindowsBuild	ServicePackLevel
Windows XP	501	2600	2 ou mais
Windows Server 2003	502	3790	0 ou mais

Comentários

A instalação não continuará se o computador do usuário já tiver um sistema operacional com uma versão anterior à especificada aqui (ou o padrão do Office se este elemento não for especificado). Não é possível especificar uma versão do Microsoft Windows aqui que seja anterior à versão exigida pelo 2007 Office system.

Para obter informações sobre requisitos do sistema, consulte Guia de introdução do 2007 Office system.

Elemento OptionState

Especifica o produto específico como recursos são tratados durante a instalação.

Importante:
Na maioria das situações, é recomendável que você use a 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"

   State="Absent" | "Advertise" | "Default" | "Local"

   [Children="force"]

/>

Atributos

Atributo	Valor	Descrição
Id	ID_da_opção	Um item que o usuário pode optar por instalar.
State	Absent	O recurso não é instalado.
	Advertise	O recurso é instalado na primeiro vez que é usado.
	Padrão	O recurso retorna ao estado de instalação padrão.
	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 optar por instalar. O valor Id para um recurso é definido no elemento Option do arquivo Setup.xml na pasta do produto principal.

Para obter uma lista de Valores de Id de OptionState, consulte Valores de Id de OptionState do arquivo Config.xml. Para obter informações sobre a modificação do elemento OptionState em Config.xml, consulte a seção Modificando o elemento OptionState do arquivo Config.xml de Usar a Diretiva de Grupo de Instalação de Software para implantar o sistema 2007 Office.

Exemplo

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

Elemento PIDKEY

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

Dica:
A opção equivalente na OCT é a configuração Chave do produto em “Licenciamento e interface do usuário” in Ferramenta de Personalização do Office no 2007 Office system.

Sintaxe

<PIDKEY Value=" chave de 25 caracteres " />

Atributos

Atributo	Valor	Descrição
Value	chave de 25 caracteres	A chave de licença de volume de 25 caracteres

Comentários

Quando o valor de PIDKEY for definido, os usuários não precisarão inserir uma chave do produto ao executarem a Instalação.

Exemplo

<PIDKEY Value="1234512345123451234512345" />

Observação:

Se o atributo Level do elemento Elemento de exibiçãofor definido como "Basic" ou "None" e se você fornecer uma chave do produto usando o elemento PIDKEY, a Instalação vai supor que você também aceita os termos de licença em nome do usuário. Nesse caso, a despeito da forma como o atributo AcceptEULA do elemento Elemento de exibição for definido, não será solicitado que o usuário aceite os termos de licença durante a instalação.

Elemento RemoveLanguage

Remove o idioma especificado a instalação.

Sintaxe

<RemoveLanguage Id=" ii - cc " />

Atributos

Atributo	Valor	Descrição
Id	ii-cc	O identificador de idioma. Para obter uma lista completa de marcas de idioma, consulte Identificadores de idioma no Office System 2007.

Comentários

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

Você pode ter vários elementos Elemento AddLanguage e RemoveLanguage. Se ambos 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 de configuração

Permite especificar valores para as propriedades do Windows Installer.

Dica:
A opção equivalente na OCT é “Modificar propriedades de instalação” em Ferramenta de Personalização do Office no 2007 Office system.

Sintaxe

<Setting Id=" nome " Value=" valor " />

Atributos

Atributo	Valor	Descrição
Id	nome	O nome da propriedade do Windows Installer.
Value	valor	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 será encerrada. Se uma propriedade com suporte for especificada, a Instalação a passará diretamente para o Windows Installer. Para obter uma lista completa de propriedades do Windows Installer, incluindo uma explicação sobre propriedades com suporte e bloqueadas, consulte Propriedades da instalação no Office System 2007.

O elemento Setting oferece suporte à configuração REMOVEPREVIOUS. Essa configuração remove o aplicativo especificado da instalação e usa a seguinte sintaxe:

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

onde ID de opção é o valor de identificador para o aplicativo de sistema do Office de 2007. Para especificar vários aplicativos, use uma lista separada por vírgulas para indicar os valores de ID de opção apropriados. Para obter uma lista completa de valores de ID de opção, consulte Valores de Id de OptionState do arquivo Config.xml.

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

Se você especificar REMOVEPREVIOUS com um valor de ID de opção, somente os aplicativos especificados serão removidos.

Se você não especificar REMOVEPREVIOUS, todos os aplicativos do Office instalados anteriormente e para os quais uma substituição esteja 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 oferece suporte à propriedade SETUP_REBOOT. SETUP_REBOOT inicia uma reinicialização após a instalação e usa a seguinte sintaxe:

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

onde valor pode ser um destes procedimentos:

• AutoAlways-- sempre inicia uma reinicialização. Não avisa o usuário.

• Always-- sempre solicita uma reinicialização no final da instalação.

• IfNeeded-- solicita uma reinicialização no final da instalação se a instalação assim o exigir (Padrão).

• AutoIfNeeded-- inicia uma reinicialização se a instalação assim o exigir. Não avisa o 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 um caminho de pesquisa para a instalação a usar para encontrar arquivos de personalização de instalação.

Sintaxe

< SetupUpdates

CheckForSUpdates = "Sim"(padrão) | "não"

SUpdateLocation = " caminho-lista "

/>

Atributos

Atributo	Valor	Descrição
CheckForSUpdates	Yes (padrão)	A instalação usa a lista de caminhos no SUpdateLocation para localizar arquivos de personalização de instalação.
	No	A instalação não procura por arquivos de personalização de instalação usando a lista de caminhos em SUpdateLocation.
SUpdateLocation	lista de caminhos	Uma lista de caminhos totalmente qualificados para pastas, separados por ponto-e-vírgula.

Comentários

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

Exemplo

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

Elemento USERINITIALS

As iniciais do usuário em cujo computador o produto está sendo instalado.

Sintaxe

<USERINITIALS Value=" valor " />

Atributos

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

Exemplo

<USERINITIALS Value="JD" />

Elemento USERNAME

O nome do usuário em cujo computador o produto está sendo instalado.

Sintaxe

<USERNAME Value=" valor " />

Atributos

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

Comentários

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

Se o usuário que está executando o Office for o mesmo que instalou o Office, as informações de Username e Initials fornecidas durante a instalação serão usadas. O usuário não será avisado quando o Office for iniciado pela primeira vez. Esse caso acontece mais para usuários domésticos que instalam o Office por conta própria.

Se o usuário que está executando o Office não for o mesmo usuário que instalou o Office, o Office solicitará que ele confirme seu Nome de usuário e Iniciais quando o Office iniciar pela primeira vez. Esse caso acontece mais em um ambiente corporativo, onde um administrador instala o Office em nome do usuário.

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

Exemplo

<USERNAME Value="John Doe" />

Exemplo de arquivo Config.xml

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

Observação:
A versão envio desse arquivo usada Command Path="msiexec.exe". O exemplo a seguir usa o caminho completo para o arquivo msiexec.exe: Command Path="%WINDIR%\system32\msiexec.exe" onde % WINDIR % é a pasta que contém os arquivos do Windows. Você deve incluir o caminho completo para executar o comando, caso contrário que ele falhar.

<Configuration Product="Enterprise">

    <!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
    
    <!-- <Logging Type="verbose" Path="%temp%" Template="Microsoft Office Enterprise Setup(*).txt" /> -->
    
    <!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->

    <!-- <USERNAME Value="Customer" /> -->
    
    <!-- <COMPANYNAME Value="MyCompany" /> -->
    
    <!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->
    
    <!-- <LIS CACHEACTION="CacheOnly" /> -->
        
    <!-- <DistributionPoint Location="\\server\share\Office12" /> -->
    
    <!-- <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>

Baixar este manual

Este artigo faz parte do seguinte manual que pode ser baixado para facilitar a leitura e a impressão:

• Referência técnica para a versão 2007 Office (em inglês)

  Consulte a lista completa de manuais disponíveis no Conteúdo baixável para o Resource Kit do Office 2007.

Consulte também

Conceitos

Visão geral da arquitetura de Instalação do 2007 Office system
Ferramenta de Personalização do Office no 2007 Office system
Propriedades da instalação no Office System 2007
Implantar configurações personalizadas do 2007 Office system (passo a passo)
Práticas recomendadas para a manutenção do Office System 2007