Referencia al archivo Config.xml para Office 2013

 

Se aplica a: Office 2013

Última modificación del tema: 2016-12-16

**Resumen:**proporciona información sobre cómo usar el archivo Config.xml para personalizar instalaciones de Office 2013 basadas en Windows Installer.

Público: profesionales de TI

Los administradores usan el archivo Config.xml para realizar la instalación y tareas de mantenimiento de Office 2013.

La herramienta principal que los administradores usan para personalizar la instalación de productos basados en Windows Installer en Office 2013 es la Herramienta de personalización de Office (OCT). Las herramientas y los métodos de personalización en Office 2013 son las mismas que para Office 2010y Office 2007. Para más información sobre cómo usar la OCT para crear un archivo de personalización del programa de instalación y conocer las actualizaciones de la OCT en Office 2013, consulte Referencia de la herramienta de personalización de Office (OCT) para Office 2013.

Use el archivo Config.xml para configurar tareas de instalación y usarlas cuando ejecute el programa de instalación. Config.xml no está instalado o almacenado en caché en los equipos de los usuarios. Los administradores pueden editar el archivo Config.xml file para personalizar la instalación. De manera predeterminada, el archivo Config.xml almacenado en la carpeta del producto principal, core_product_folder_name, indica al programa de instalación que instale dicho producto. Por ejemplo, el archivo Config.xml en la carpeta ProPlus.WW folder instala Office Professional Plus 2013.

Se usa el archivo Configuration.xml para realizar las tareas de instalación siguientes:

  • Especificar la ruta del punto de instalación de la red.

  • Seleccionar qué producto instalar.

  • Personalizar opciones del programa de instalación, como el registro y la ubicación del archivo de personalización del programa de instalación y las actualizaciones de software.

  • Establecer las opciones de instalación, como el usuario y el nombre de la compañía.

  • Copiar el Origen de instalación local (LIS) en el equipo del usuario sin instalar Office.

  • Agregar o quitar idiomas de la instalación.

También puede usar el archivo Config.xml para operaciones de mantenimiento como agregar o quitar características, reparaciones, y quitar instalaciones. Para ello, los administradores deben volver a ejecutar Setup.exe desde el origen original.

ImportanteImportante:
Para editar Config.xml, use un editor de texto, como el Bloc de notas. No use un editor XML con fines generales, como Word 2013.

En este artículo:

  • Referencia rápida de elementos de Config.xml

  • Cómo usa Config.xml el programa de instalación

  • Formato del archivo Config.xml

  • Referencia de elementos de Config.xml

  • Archivo Config.xml de muestra

Referencia rápida de elementos de Config.xml

En la tabla siguiente se enumeran los elementos de Configuration.xml. Estos elementos pueden aparecer en cualquier orden, salvo Elemento Configuration, que debe aparecer primero, y elementos como Elemento Command, cuyo orden en Config.xml afecta al modo en que se procesan durante la instalación.

Referencia rápida de Config.xml

Elemento Descripción

Elemento Configuration

Elemento de primer nivel

Elemento AddLanguage

Agrega un idioma a la instalación

Elemento ARP

Valores del control de texto y el comportamiento de la opción Programas y características, en el Panel de control, para agregar o quitar características del producto

Elemento Command

Ejecuta un comando durante la instalación

Elemento COMPANYNAME

El nombre de la organización o de la empresa del usuario en cuyo equipo se está instalando el producto

Elemento Display

El nivel de interfaz de usuario que la configuración muestra al usuario

Elemento DistributionPoint

La ruta completa del punto de instalación de la red donde se ejecutará la instalación

Elemento INSTALLLOCATION

La ruta completa de la carpeta en el equipo del usuario en que se instala el producto

Elemento LIS

Opciones sobre cómo se almacena en caché el Origen de instalación local (LIS) en el equipo del usuario

Elemento de registro

Opciones para el tipo de registro que realiza el programa de instalación

Elemento OptionState

Opciones para especificar cómo se controlarán las características individuales del producto durante la instalación

Elemento PIDKEY

La clave de la licencia por volumen de 25 caracteres

Elemento RemoveLanguage

Quita un idioma de la instalación

Elemento Setting

Valores de las propiedades de Windows Installer

Elemento SetupUpdates

La ruta de acceso que usa el programa de instalación para buscar los archivos de personalización del programa de instalación

Elemento USERINITIALS

Las iniciales del usuario en cuyo equipo se instala el producto

Elemento USERNAME

El nombre del usuario en cuyo equipo se instala el producto

Cómo usa Config.xml el programa de instalación

El programa de instalación busca una copia de Config.xml en la misma carpeta que Setup.exe. Si no se encuentra la copia, el programa de instalación usa el archivo Config.xml file que se ubica en la carpeta del producto principal para el producto que está instalando. (Si hay varios productos en el punto de instalación de la red, el programa de instalación espera hasta que especifique el producto que instalará antes de buscar la copia de Config.xml.) La copia de Config.xml que se ubica en la carpeta del producto identifica el producto a través del atributo Product del Elemento Configuration.

También puede usar la opción de línea de comandos del programa de instalación /config para especificar la ubicación del archivo Config.xml. Por ejemplo:

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

Nota

Si también creó un archivo de personalización del programa de instalación (.msp) con la OCT, las personalizaciones que defina en el archivo Config.xml tienen prioridad sobre las del archivo de personalización.

Formato del archivo Config.xml

Los elementos XML de Config.xml comienzan por < y acaban por />.

El formato de elemento básico es el siguiente:

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

Por ejemplo:

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

Las siguientes afirmaciones se aplican al formato:

  • Los elementos y los atributos distinguen entre mayúsculas y minúsculas.

  • Los valores de atributos se deben poner entre comillas (") y no distinguen entre mayúsculas y minúsculas.

  • Una definición de elemento puede ocupar varias líneas. Los espacios, los retornos de carro, los avances de línea y los caracteres de tabulación se ignoran en una definición de elemento.

    El ejemplo siguiente es una definición de elemento que ocupa varias líneas.

    <Display
       Level="none"
       CompletionNotice="no"
       SuppressModal="yes"
       AcceptEula="yes"
    />
    
SugerenciaSugerencia:
Para definiciones de elemento largas, ponga atributos en líneas separadas y use la indización para que sea más fácil leer el archivo.

El Elemento Configuration es un caso especial y es obligatorio. Los demás elementos se incluyen en el Elemento Configuration y el elemento está delimitado con </Configuration>, como se muestra en el siguiente ejemplo.

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

Se pueden agregar comentarios en cualquier parte y delimitarse con "<!--" y "-->".

Por ejemplo:

<!-- 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 carpeta de producto de Office contiene un archivo Config.xml predeterminado, que consiste en un Elemento Configuration que tiene el atributo Product establecido en el valor adecuado para el producto. El Elemento Configuration incluye varios ejemplos de elementos que están delimitados en comentarios. Para activar estos elementos, quite las marcas de comentario de apertura y de cierre y escriba los valores de atributo adecuados.

Como se muestra en el siguiente ejemplo, puede activar el Elemento Display cambiando esta línea:

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

a lo siguiente:

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

Las opciones de Display del ejemplo anterior indican al programa de instalación que se ejecute en una instalación silenciosa para impedir que a los usuarios se les solicite que especifiquen información y para impedir que la instalación espere la interacción del usuario.

Referencia de elementos de Config.xml

Las siguientes convenciones se usan en las descripciones de esta referencia.

Convenciones de formato

bold

Nombre de elemento o atributo

normal

Texto por especificar exactamente como se muestra

italic

Marcador de posición para un valor que se agregará

x|y

Elegir entre varios valores

[x]

Valor opcional

Elemento Configuration

Elemento de primer nivel. Este elemento es obligatorio y los demás elementos deben aparecer en él.

Sintaxis

<Configuration [Product="productID"] >

...

</Configuration>

Atributos

En la siguiente tabla se describen los atributos y los valores del elemento Configuration.

Atributos del elemento Configuration

Atributo Valor Descripción

Product

productID

El valor del atributo Id. del elemento del programa de instalación en el archivo Setup.xml para el producto que se está instalando.

Comentarios

El atributo Product identifica el producto afectado por este archivo Config.xml. El productID se define en el archivo Setup.xml que está ubicado en la carpeta principal del producto, en el atributo ID del elemento Setup.

El atributo Product es opcional, a menos que establezca el atributo Level en “basic” o “none”. En este caso, el atributo Product es obligatorio. Si el producto especificado por el atributo Product no existe en el punto de instalación de red, el programa de instalación finaliza la instalación.

Ejemplo

El productID para Office Professional Plus 2013 se ubica en ProPlus.WW\Setup.xml en la siguiente línea:

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

Se usa este productID en Config.xml para especificar Office Professional Plus 2013 escribiendo la siguiente línea:

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

Elemento AddLanguage

Agrega el idioma especificado a la instalación.

Sintaxis

<AddLanguage

Id=" ll-cc " | "match"

[ShellTransform="Yes"]

/>

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento AddLanguage.

Atributos de AddLanguage

Atributo Valor Descripción

Id

ll - cc

El identificador de idioma.

match

Coincide con el Id de idioma de la configuración regional del usuario de Windows.

ShellTransform

Yes

Especifica el idioma de la interfaz de usuario del Shell. Si hay más de un elemento AddLanguage especificado, un idioma (y solo uno) debe especificar el elemento ShellTransform.

Comentarios

El idioma debe estar disponible en el punto de instalación de la red.

Puede tener varios elementos para AddLanguage y Elemento RemoveLanguage. Si el elemento Elemento RemoveLanguage y el elemento AddLanguage especifican el mismo idioma, el elemento AddLanguage tiene prioridad y se instala el idioma.

Nota

Si hay más de un elemento AddLanguage especificado, un idioma (y solo uno) debe especificar el elemento ShellTransform o el programa de instalación finaliza.

Hay tres conceptos sobre el idioma que debe saber antes de instalar Office 2013:

  • Interfaz de usuario del programa de instalación (IU): el idioma de la instalación.

  • IU del Shell: el idioma de los accesos directos, menús contextuales e información sobre herramientas.

  • Office IU: el idioma de la interfaz de usuario y de los menús de Office.

Cuando hay varios idiomas de Office, estos tres valores se determinan de la siguiente manera:

De manera predeterminada, la IU del programa de instalación depende del conjunto de recursos disponibles para la instalación y la capacidad de coincidir con la configuración regional del usuario. De manera predeterminada, la IU del programa de instalación coincide con la configuración regional del usuario. La IU del shell depende del conjunto de idiomas que se está instalando y, de manera predeterminada, sigue la IU del programa de instalación. El idioma predeterminado de la IU de Office depende de la configuración regional y de la configuración actual del usuario. El valor predeterminado es usar la configuración regional del usuario establecida en el equipo de cada usuario. Esto significa que en el caso predeterminado, la IU del programa de instalación, la IU del Shell y la IU de Office tendrán la misma.

Una configuración regional en el sistema operativo de Windows es un conjunto de información de preferencias del usuario relacionado con el idioma, el entorno y las convenciones culturales del usuario. Esta información se representa como una lista de valores que se usan para determinar el idioma de entrada correcto, el diseño del teclado, el criterio de ordenación y los formatos que se usan para los números, las fechas, las monedas y la hora. La configuración regional del usuario es una configuración por usuario que determina los formatos que se usan, de manera predeterminada, para mostrar fechas, monedas, números y el criterio de ordenación del texto. La configuración regional del usuario se especifica para cada cuenta que se crea en un equipo.

Si un administrador especifica varios idiomas para la instalación en el archivo Config.xml, el idioma de la IU del Shell se debe seleccionar del conjunto de idiomas que se están instalando. Para ello, los administradores especifican el atributo ShellTransform del elemento AddLanguage en el archivo Config.xml. AddLanguage especifica el idioma que el programa de instalación usa para la IU del Shell. Sin embargo, esto no afecta necesariamente a la elección de la IU del programa de instalación o la IU de Office cuando se instala en el equipo del usuario.

Por ejemplo, si tiene una imagen de Office con inglés, francés, alemán y español, para especificar que el programa de instalación instale la compatibilidad completa de idioma para estos idiomas y haga que la IU del Shell siga las opciones regionales predeterminadas del usuario, se agregan los siguientes elementos en el archivo Config.xml.

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

En el ejemplo anterior, el programa de instalación instala los idiomas especificados y la IU del Shell coincide con el idioma de la configuración regional del usuario. Si hubiera más idiomas disponibles en la imagen de origen, el valor de match en el ejemplo podría instalar un idioma adicional si el idioma de match no se resuelve en uno de los otros cuatro idiomas solicitados explícitamente. Por ejemplo, si también se incluyera el japonés en el origen, este ejemplo instalaría japonés además de los otros cuatro idiomas en un equipo que tiene la configuración regional de usuario establecida en japonés.

Ejemplo

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

Elemento ARP

Especifica valores que controlan el texto y el comportamiento de Programas y características en el Panel de control para el producto.

Sintaxis

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

Atributos

En la siguiente tabla se describen los atributos y valores del elemento ARP.

Atributos de ARP

Atributo Valor Descripción

ARPCOMMENTS

text

Texto adicional. Puede ser de hasta 255 caracteres, aunque puede que no se muestren todos.

ARPCONTACT

text

Lista de contactos de soporte técnico.

ARPNOMODIFY

Yes

Impide que los usuarios cambien la instalación del producto poniendo el botón Modificar no disponible.

No (predeterminado)

Permite a los usuarios modificar la instalación del producto.

ARPNOREMOVE

Yes

Impide que los usuarios quiten el producto poniendo el botón Quitar no disponible.

No (predeterminado)

Permite a los usuarios quitar el producto.

ARPURLINFOABOUT

URL

URL de la página inicial del producto.

ARPURLUPDATEINFO

URL

URL de información sobre actualizaciones del producto.

ARPHELPLINK

URL

URL de un sitio web donde los usuarios pueden recibir soporte técnico.

ARPHELPTELEPHONE

text

Números de teléfono de soporte técnico.

Elemento Command

Especifica una línea de comandos que se va a ejecutar. Para más información, consulte Comentarios más adelante en este artículo.

SugerenciaSugerencia:
La opción equivalente en la OCT es Add installations and run programs.

Sintaxis

<Command

Path=" path "

[QuietArg="arguments"]

[Args="args"]

[ChainPosition="Before" | "After"(predeterminado)]

[Wait="mseconds"]

[Execute="Install"(predeterminado) | "Uninstall"]

[Platform="x86"(predeterminado) | "x64"]

/>

Atributos

En la siguiente tabla se describen los atributos del elemento Command.

Atributos de Command

Atributo Valor Descripción

Path

path

Ruta completa del archivo ejecutable. Si el valor de la ruta contiene un espacio, debe usar comillas dobles como se muestra en el siguiente ejemplo:

"\\server\share\Office 14\copylogs.bat"

QuietArg

string

Cadena de argumentos que se anexará a la línea de comandos si configura una instalación silenciosa. Para más información sobre cuándo usar el atributo QuietArg, consulte la sección Comentarios que sigue a esta tabla.

Args

string

Cadena de argumentos que se pasará al archivo ejecutable. Para más información sobre cuándo usar el atributo Args para instalaciones en cadena, consulte la sección Comentarios que sigue a esta tabla.

Si el valor del elemento Args incluye comillas, puede delimitar todo el valor en comillas simples ('), como se muestra en el siguiente ejemplo:

Args='"/param value"'

ChainPosition

Before

Este comando se ejecuta antes de la instalación del producto principal.

After (predeterminado)

Este comando se ejecuta después de la instalación del producto principal.

Wait

mseconds

Al instalar un producto con el atributo Level establecido en "full" o “basic,” este es el número de milisegundos que hay que esperar después de ejecutar el programa y antes de continuar con la instalación. El valor predeterminado es 0 (cero), que indica que no hay que esperar.

Execute

Install (predeterminado)

El programa ejecuta este comando cuando se instala el producto principal.

Uninstall

El programa ejecuta este comando cuando se desinstala el producto principal.

Platform

x86 (predeterminado)

Especifica que este programa requiere la plataforma Intel x86. Este comando se ejecuta solo si el equipo en que la instalación se ejecuta coincide con el requisito de la plataforma.

x64

Especifica que este programa requiere un procesador de 64 bits que admite extensiones de x64 para la arquitectura de x86. Este comando se ejecuta solo si el equipo en que la instalación se ejecuta coincide con el requisito de la plataforma.

Comentarios

El elemento Command del archivo Config.xml y la opción Agregar instalaciones y ejecutar programas de la OCT (líneas de comando que se indican en los cuadros de diálogo Agregar entrada de programa y Modificar entrada de programa) están diseñados para usarse únicamente para las instalaciones y las desinstalaciones de producto iniciales. Los comandos del elemento Command solo se procesan durante las instalaciones y desinstalaciones iniciales. Si se usan los comandos del elemento Command para las personalizaciones después de la instalación inicial, se ignoran.

Se puede especificar que la línea de comando ejecute un comando arbitrario o que ejecute un ejecutable ligero que quiera iniciar cuando se instale este producto.

El elemento Command del archivo Config.xml y la opción Agregar instalaciones y ejecutar programas de la OCT no proporcionan las funciones de implementación de software que proporcionan la implementación de software empresarial y la herramienta de administración, como, por ejemplo, la capacidad de hacer un seguimiento del progreso de implementación y solucionar problemas. Por lo tanto, le recomendamos que limite el uso del elemento Command en el archivo Config.xml y Agregar instalaciones y ejecutar programas en la OCT para iniciar solo los ejecutables ligeros o los comandos arbitrarios que no harán cambios en el equipo o que no necesitan entradas del usuario. Por ejemplo, puede iniciar una utilidad para que copie registros o un comando para que inicie una página principal al final de la instalación.

ImportanteImportante:
El encadenamiento no es tan fiable como la instalación de cada producto por separado. Por ejemplo, si encadena dos instalaciones juntas y uno de los productos produce un error o sufre un error imprevisto, la instalación principal y la instalación encadenada pueden no finalizar correctamente. Por lo tanto, recomendamos que no use el enfoque de encadenamiento. El método recomendado para instalar varios productos juntos en entornos empresariales es usar un programa de administración de implementaciones como Microsoft System Center 2012 Configuration Manager o Microsoft Systems Management Server (SMS) 2003, o una herramienta de terceros en lugar del encadenamiento.

El uso de Args y QuietArg es el siguiente:

  • El atributo Args siempre se anexa al comando. Esto puede incluir conmutadores como "/install" o **"Company=**MyCorporation."

  • El atributo QuietArg también se anexa si el programa de instalación se ejecuta silenciosamente (con Display establecido como Display="none"). En estos casos, puede especificar el atributo QuietArg usando el conmutador "/quiet"; por ejemplo, puede usar: QuietArg="/quiet".

Las siguientes afirmaciones se aplican al atributo Wait:

  • Establecer el atributo Wait en 0 milisegundos indica que no hay que esperar después de ejecutar el programa y antes de continuar con la instalación. El comando se ejecutará y avanzará inmediatamente.

    Los códigos de retorno solo se respetan si el valor de Wait es distinto de cero. Si especifica 0, el programa de instalación no esperará para continuar la instalación después de ejecutar el programa especificado. Por lo tanto, no hay código de retorno que notificar en ese caso.

  • Si se establece el atributo Wait en cualquier valor positivo distinto de cero, el programa esperará exactamente el número de milisegundos que especifique. Si el proceso finaliza antes del tiempo especificado, el programa de instalación continuará. Si el proceso no ha finalizado cuando el tiempo especificado acabe, el programa de instalación producirá un error.

  • Si se establece el atributo Wait en -1, el programa esperará de manera indefinida. Esto puede ser problemático porque si el proceso del comando deja de responder (se cuelga), el programa de instalación dejará de responder y esperará indefinidamente a que se ejecute el comando.

Si hay dos o más elementos de Command en el archivo Config.xml, se ejecutan en el orden en que se especifican en Config.xml.

Ejemplos

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

Elemento COMPANYNAME

El nombre de la organización o de la empresa del usuario en cuyo equipo se está instalando el producto.

SugerenciaSugerencia:
La opción equivalente en la OCT es la configuración Nombre de la organización en Ubicación de la instalación y nombre de la organización.

Sintaxis

<COMPANYNAME Value=" companyname " />

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento COMPANYNAME

Atributos de COMPANYNAME

Atributo Valor Descripción

Value

companyname

El nombre de la compañía u organización.

Ejemplo

<COMPANYNAME Value="Microsoft Corporation" />

Elemento Display

El nivel de IU que el programa de instalación muestra al usuario.

SugerenciaSugerencia:
La opción equivalente en la OCT es la configuración Display Level y contrato de licencia en “Licensing and user interface” en Referencia de la herramienta de personalización de Office (OCT) para Office 2013.

Sintaxis

<Display

Level="None" | "Basic" | "Full"(predeterminado)

CompletionNotice="Yes" | "No"(predeterminado)

SuppressModal="Yes" | "No"(predeterminado)

NoCancel="Yes" | "No"(predeterminado)

AcceptEula="Yes" | "No"(predeterminado)

/>

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento Display.

Atributos de Display

Atributo Valor Descripción

Level

None

No se muestra ninguna IU. Si establece Display Level="none", el programa de instalación ejecuta una instalación silenciosa (inesperada). Consulte la sección Comentarios para más información.

Basic

El programa de instalación muestra una pantalla de bienvenida, la página de la clave del producto (PIDKEY) (si es necesaria), la página de términos de licencia del software, una barra de progreso y el aviso de finalización (si se permite).

Full (predeterminado)

El programa de instalación muestra todas las IU al usuario.

CompletionNotice

Yes

Solo se aplica si Level está establecido en "basic" o “none”: el programa de instalación muestra el aviso de finalización.

No (predeterminado)

Solo se aplica si Level está establecido en "basic": el programa de instalación no muestra el aviso de finalización.

SuppressModal

Yes

Solo se aplica si Level está establecido en "basic": el programa de instalación no muestra mensajes de error ni otros cuadros de diálogo que podrían interrumpir la instalación.

No (predeterminado)

Solo se aplica si Level está establecido en "basic": el programa de instalación muestra mensajes de error y otros cuadros de diálogo según sea necesario.

NoCancel

Yes

Si Levelestá establecido en "full" o "basic", deshabilite el botón Cancelar (X en la esquina superior derecha del cuadro de diálogo de progreso).

No (predeterminado)

Si Level está establecido en "full" o "basic", permite al usuario cancelar la instalación desde la barra de progreso.

AcceptEULA

Yes

Los términos de licencia de software de Microsoft se aceptan en nombre del usuario. El programa de instalación no muestra la página de términos de licencia de software.

No (predeterminado)

Si Level no está establecido en ”none”, el programa de instalación muestra la página de términos de licencia de software.

Comentarios

Si este elemento no está definido, se usa la configuración predeterminada. Si especifica un valor no válido, el programa de instalación finaliza la instalación.

Si el atributo Level está establecido en "basic" o “none” y usted proporciona una clave de producto usando Elemento PIDKEY, el programa de instalación determina que también acepta el contrato de licencia en nombre del usuario.

Nota

En implementaciones empresariales, recomendamos que establezca el valor de Display Level en “none” para indicar al programa de instalación que ejecute una instalación silenciosa. Esto impide solicitudes a los usuarios para que especifiquen información y evita que la instalación espere las interacciones del usuario, incluso si los archivos están en uso. Si establece el valor de Display Level en “none”, se determina que los atributos SuppressModal y CompletionNotice se silencian y que los términos de licencia de software de Microsoft se aceptan. Los administradores también deben asegurarse de que no se ejecute ninguna aplicación de Office durante una instalación de Office 2013.
Si establece el valor de Display Level en “basic” y SuppressModal en “yes”, puede que se envíen solicitudes a los usuarios si se está usando algún archivo deOffice. Si establece Display Level en “none”, evita enviar solicitudes a los usuarios en estos casos. El atributo SuppressModal no evita que se muestren mensajes de files in use. Solo si Display Level está establecido en “none”, se impide que se muestren mensajes de files in use.
El programa de instalación solo usa el elemento Display si encuentra el archivo Config.xml file en la misma carpeta que setup.exe, o si especifica el archivo Config.xml usando la opción de línea de comandos /config del programa de instalación. Si el programa de instalación usa el archivo Config.xml en la carpeta del producto, se usan las opciones de visualización predeterminadas.

Ejemplo

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

Elemento DistributionPoint

Especifica la ruta completa del punto de instalación de la red donde se ejecutará la instalación

Sintaxis

<DistributionPoint Location=" path " />

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento DistributionPoint.

Atributos de DistributionPoint

Atributo Valor Descripción

Location

path

La ruta completa del punto de instalación de la red donde se ejecutará la instalación.

Comentarios

Si no se especifica, el programa de instalación determina que el archivo Setup.exe se ubica en la raíz del punto de instalación de la red.

Nota

El programa de instalación solo usa el elemento DistributionPoint si encuentra el archivo Config.xml file en la misma carpeta que setup.exe, o si especifica el archivo Config.xml usando la opción de línea de comandos /config del programa de instalación. Si el programa de instalación usa el archivo Config.xml en la carpeta del producto, se ignora este elemento porque el punto de instalación de la red ya se ha encontrado.

Ejemplo

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

Elemento INSTALLLOCATION

Especifica la ruta completa de la carpeta en el equipo del usuario en que se instala el producto

SugerenciaSugerencia:
La opción equivalente en la OCT es la configuración Ruta de instalación predeterminada en Ubicación de la instalación y nombre de la organización.

Sintaxis

<INSTALLLOCATION Value=" path " />

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento INSTALLLOCATION.

Atributos de INSTALLLOCATION

Atributo Valor Descripción

Value

path

La ruta completa de la carpeta en el equipo del usuario en que se instala el producto.

Comentarios

Puede usar variables del entorno del sistema en la ruta. Si este elemento no se especifica, Office se instala en %ProgramFiles%\Microsoft Office.

Ejemplo

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

Elemento LIS

Controla cómo el Origen de instalación local (LIS) se almacena en caché en el equipo del usuario y especifica la ubicación de uno o más puntos de instalación de la red que contienen los archivos de instalación del producto.

Sintaxis

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

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

/>

Atributos

En la siguiente tabla se describen los atributos y valores del elemento LIS.

Atributos de LIS

Atributo Valor Descripción

CACHEACTION

CacheOnly

El programa de instalación copia el LIS en el equipo del usuario pero no instala el producto.

Nota

No use los elementos de Command en un archivo Config.xml file que especifica el valor de CacheOnly porque los comandos especificados no se ejecutarán.

RemoveCacheOnly

Si la caché se copia en el equipo del usuario y no se instala Office, el programa de instalación quita el LIS del equipo del usuario pero no instala ni desinstala el producto.

SOURCELIST

semicolon-delimited-path-list"]

Una lista, separada por puntos y coma, de uno o más puntos de instalación de la red que contienen los archivos de instalación del producto.

La opción equivalente en la OCT es Orígenes de red adicionales.

Comentarios

De manera predeterminada, el LIS se crea en la carpeta \MsoCache\All Users en la raíz de la unidad en que se instala Office . Los archivos de personalización del programa de instalación y las actualizaciones de software de la carpeta Actualizaciones en el punto de instalación de la red también se copian.

Si especifica Elemento INSTALLLOCATION, la designación de la unidad en la ruta se usa para determinar en qué unidad se crea el LIS. Por ejemplo, si la ruta Elemento INSTALLLOCATION es E:\office\files, el LIS se crea en la unidad E. Los orígenes enumerados por el atributo SOURCELIST se mantienen con el producto instalado y los usa el programa de instalación si el LIS del equipo del usuario falta o está dañado.

Ejemplo

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

Elemento de registro

Especifica el tipo de registro que realiza el programa de instalación.

Sintaxis

<Logging

Type="Off" | "Standard"(predeterminado) | "Verbose"

Path=" path "

Template=" filename .txt"

/>

Atributos

En la tabla siguiente se describen los atributos y los valores del elemento Logging.

Atributos de Logging

Atributo Valor Descripción

Type

Off

El programa de instalación no realiza ningún registro.

Standard (predeterminado)

El programa de instalación escribe información de la instalación en el archivo de registro.

Verbose

El programa de instalación escribe toda la información de la instalación en el archivo de registro.

Path

path

La ruta completa de la carpeta que se usa para el archivo de registro. Puede usar variables de entorno. El valor predeterminado es %temp%.

Template

filename .txt

El nombre del archivo de registro. Si inserta la cadena * en cualquier parte del nombre del archivo, se crea un archivo de registro único para cada instalación realizada por setup.exe (consulte la explicación más adelante en este artículo). Si el carácter * no se incluye y el nombre de archivo que se ha especificado ya existe, la información de registro se anexa al archivo existente. La extensión del nombre de archivo .txt se debe incluir. La plantilla predeterminada es SetupExe(*).log.

Comentarios

Puede especificar un * en cualquier parte del valor de Template. El programa de instalación inserta una cadena en la ubicación que tiene el siguiente formato.

YYYYMMDDHHMMSS xxx

donde:

  1. YYYY = Año

  2. MM = Mes

  3. DD = Día

  4. HH = Hora

  5. MM = Minuto

  6. SS = Segundos

  7. xxx = una única cadena generada por el programa de instalación

Nota

El programa de instalación solo usa el elemento Logging si encuentra el archivo Config.xml en la misma carpeta que setup.exe, o si usted especifica el archivo Config.xml usando la opción de línea de comandos /config del programa de instalación. Si dicho programa usa el archivo Config.xml en la carpeta del producto, se usan las opciones de registro predeterminadas.

Ejemplo

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

En el siguiente ejemplo, el programa de instalación crea un archivo de registro cada vez que instala el producto. El programa de instalación usa nombres de archivo únicos como el siguiente:

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

Elemento OptionState

Especifica cómo se controlan las características del producto durante la instalación.

ImportanteImportante:
En la mayoría de las situaciones, se recomienda que use la OCT para cambiar el estado de instalación de las características. La opción equivalente de la OCT es Definición de los estados de instalación de las características.

Sintaxis

<OptionState

Id=" IdDeOpción "

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

[Children="force"]

/>

Atributos

En la siguiente tabla se describen los atributos y los valores del elemento OptionState.

Atributos de OptionState

Atributo Valor Descripción

Id

optionID

Elemento que el usuario puede instalar.

State

Absent

La característica no está instalada.

Advertise

La característica se instala la primera vez que se usa.

Local

La característica se instala en el equipo del usuario.

Children

force

Todas las características secundarias de la característica se establecen en el estado especificado.

Comentarios

Una característica es un elemento que el usuario puede elegir instalar. El valor de Id de una característica se define en el elemento Option del archivo Setup.xml en la carpeta del producto principal.

Nota

Los subcomponentes siguientes de Publisher 2013 no están visibles en el árbol de estados de instalación de la característica del programa de instalación en Office 2013:

  • Impresión comercial y el subcomponente Conversión de RGB a CMYK mejorada

  • Combinaciones de fuentes

  • Vistas previas de PaperDirect

  • Subcomponentes de Plantillas de Publisher, Publicaciones comerciales y Otras publicaciones

Ejemplo

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

Elemento PIDKEY

La clave de la licencia por volumen de 25 caracteres.

Nota

La opción equivalente en la OCT es la configuración Clave de producto en Licensing and user interface en Referencia de la herramienta de personalización de Office (OCT) para Office 2013. Para más información sobre las licencias por volumen en Office Professional 2013, consulte Planear la activación por volumen de Office 2013.
No se requiere una entrada de clave del producto para implementaciones empresariales que usan la activación del servicio de administración de claves (KMS) porque todas las ediciones de licencias por volumen de Office 2013 tienen una clave de cliente de KMS previamente instalada. KMS es uno de los métodos que las tecnologías de activación de Office proporcionan para activar los productos licenciados en los programas de licencia por volumen de Microsoft. KMS usa una clave de host de KMS para activar un equipo host de KMS y establecer un servicio de activación local en su entorno. Office 2013 conecta el host de KMS local para la activación. De manera predeterminada, la opción Usar clave de cliente de KMS se selecciona en la OCT (en la sección Licencia e interfaz de usuario).
Una clave de activación múltiple (MAK) es otro método que proporciona tecnologías de activación de Office para activar los productos con licencia en los programas de licencia por volumen de Microsoft. Mediante una MAK, los clientes activan Office 2013 en línea con servidores de activación hospedados de Microsoft o por teléfono. Los administradores pueden usar el archivo Config.xml para especificar una clave MAK. Consulte la sección Comentarios para más información sobre cómo agregar una clave MAK.
De modo similar a la activación de KMS, que activa todos los clientes de licencia por volumen de Office que están conectados a un host de KMS, la activación basada en Active Directory activa todos los clientes de licencia por volumen de Office de un dominio de Active Directory. Para más información sobre la activación basada en Active Directory, consulte la Información general sobre la activación basada en Active Directory. Para más información sobre la activación de volumen, consulte Planear la activación por volumen de Office 2013.

ImportanteImportante:
Esta información se aplica solo a las ediciones de licencia por volumen de Office 2013. No se aplica a Office 365 ProPlus, cuya licencia se concede a través de suscripción.

Sintaxis

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

Atributos

En la siguiente tabla se describen los atributos y los valores del elemento PIDKEY.

Atributos de PIDKEY

Atributo Valor Descripción

Value

25-character-key

La clave de la licencia por volumen de 25 caracteres.

Comentarios

Cuando se establece el valor de PIDKEY, no se solicita a los usuarios que especifiquen una clave de producto al instalar Office.

Para especificar una clave MAK en el archivo Config.xml, agregue la línea siguiente al archivo.

<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />

Donde AAAAABBBBBCCCCCDDDDDEEEEE es la clave de producto de 25 caracteres. Para más información sobre licencias de Office 2013, vea Activar por volumen Office 2013.

Ejemplo

<PIDKEY Value="1234512345123451234512345" />

Nota

Si el atributo Level de Elemento Display está establecido en "basic" o “none” y usted proporciona una clave de producto usando el elemento PIDKEY, el programa de instalación determina que también acepta el contrato de licencia en nombre del usuario. En este caso, independientemente de cómo establezca el atributo AcceptEULA de Elemento Display, no se le envía ninguna solicitud al usuario sobre el contrato de licencia durante la instalación o la primera vez que se ejecuta una aplicación de Office.

Elemento RemoveLanguage

Quita el idioma especificado de la instalación

Sintaxis

<RemoveLanguage Id=" ll - cc " />

Atributos

En la siguiente tabla se describen los atributos y valores del elemento RemoveLanguage.

Atributos de RemoveLanguage

Atributo Valor Descripción

Id

ll-cc

El identificador de idioma.

Comentarios

Si el idioma no está instalado en el equipo del usuario, el elemento RemoveLanguage se ignora.

Puede tener varios elementos para Elemento AddLanguage y RemoveLanguage. Si ambos elementos RemoveLanguage y Elemento AddLanguage especifican el mismo idioma, el elemento Elemento AddLanguage tiene prioridad y se instala el idioma.

Ejemplo

<RemoveLanguage Id="en-us" />

Elemento Setting

Le permite especificar valores para las propiedades de Windows Installer.

SugerenciaSugerencia:
La opción equivalente en la OCT es “Modificación de propiedades de la instalación” en Referencia de la herramienta de personalización de Office (OCT) para Office 2013.

Sintaxis

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

Atributos

En la siguiente tabla se describen los atributos y valores del elemento Setting.

Atributos de Setting

Atributo Valor Descripción

Id

name

El nombre de la propiedad de Windows Installer.

Value

value

El valor para asignar a la propiedad.

Comentarios

No todas las propiedades de Windows Installer se pueden especificar en el elemento Setting. Si se especifica una propiedad bloqueada, el programa de instalación finaliza el proceso de instalación. Si se especifica una propiedad admitida, el programa de instalación pasa la propiedad directamente a Windows Installer.

El elemento Setting admite las siguientes propiedades del Sistema de administración de claves (KMS):

  • KMSSERVICENAME — Especifica el nombre de host de KMS.

  • KMSSERVICEPORT — Especifica el puerto de host de KMS.

Por ejemplo, para usar las propiedades de KMS, use la siguiente sintaxis:

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

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

donde:

contoso.com es el nombre del host de KMS

1234 es el valor del número de puerto

Nota

La herramienta recomendada para especificar los valores de KMSSERVICENAME y KMSSERVICEPORT es el script de la Plataforma de protección de software de Office (ospp.vbs). Para establecer el nombre de host de KMS y los valores de puerto usando ospp.vbs, ejecute los siguientes comandos:
ospp.vbs /sethst:value
ospp.vbs /setprt:value
En el ejemplo anterior, el valor de sethst value es el nombre de host de KMS y el value de setprt es el puerto de host de KMS.
Si lo desea, puede establecer los atributos de KMS en el archivo Config.xml, como en un escenario que tiene una instalación de Office 2013 de 32 bits en un equipo que ejecuta una edición de 64 bits de Windows. Para obtener información sobre la activación de volumen, consulte Planear la activación por volumen de Office 2013.

El elemento Setting admite la propiedad AUTO_ACTIVATE para la activación de claves de producto. Esta propiedad especifica que la activación del producto se produzca automáticamente durante la implementación de Office 2013 y usa la siguiente sintaxis:

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

Nota

No establecer AUTO_ACTIVATE es igual que establecer AUTO_ACTIVATE en un value de 0. El resultado es que la activación del producto no tiene lugar durante la implementación de Office 2013.
Tenga en cuenta que también puede establecer el valor de la propiedad AUTO_ACTIVATE usando la Herramienta de personalización de Office. Para ello, siga estos pasos:

  1. En la OCT, seleccione Modificar propiedades de la instalación en el panel de navegación y, después, haga clic en Agregar en el panel de detalles.

  2. En el cuadro de diálogo Agregar valor de propiedad, en el cuadro Nombre, escriba AUTO_ACTIVATE. Tenga en cuenta que los nombres de propiedad deben estar en mayúsculas.

  3. En el cuadro Valor, escriba 1 y, después, haga clic en Aceptar.

El elemento Setting admite la propiedad REMOVEPREVIOUS. Esta propiedad quita la aplicación especificada de la instalación y usa la siguiente sintaxis:

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

donde Option Id es el valor del identificador para la aplicación de Office 2013. Para especificar varias aplicaciones, use una lista separada por comas para indicar los valores apropiados de Option Id.

Nota

Si instala Outlook, siempre se quita una versión instalada anteriormente de Outlook, independientemente de la preferencia de usuario.

Si especifica REMOVEPREVIOUS con un valor de Option Id, solo se quitan las aplicaciones especificadas.

Si no especifica REMOVEPREVIOUS, cualquier aplicación instalada previamente de Office para la que se está instalando un reemplazo se quita. Ese es el comportamiento predeterminado.

Si especifica REMOVEPREVIOUS con un valor en blanco (REMOVEPREVIOUS=""), no se quita ninguna aplicación.

El elemento Setting también admite la propiedad SETUP_REBOOT. SETUP_REBOOT comienza a reiniciar después de la instalación. Usa la siguiente sintaxis. Debe usar todas las letras en mayúsculas para la propiedad SETUP_REBOOT:

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

donde value puede ser uno de los siguientes:

  • AutoAlways — Comenzar siempre un reinicio. No avisar al usuario.

  • Always — Avisar siempre del reinicio al final de la instalación.

  • IfNeeded — Avisar del reinicio al final de la instalación si esta requiere un reinicio (predeterminado).

  • AutoIfNeeded — Comenzar un reinicio si la instalación lo requiere. No avisar al usuario.

  • Never — No comenzar ni avisar de un reinicio.

Ejemplos

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

Elemento SetupUpdates

Especifica una ruta de búsqueda para que el programa de instalación la use para buscar archivos de personalización del programa de instalación.

Sintaxis

<SetupUpdates

[CheckForSUpdates="Yes"(predeterminado) | "No"]

[SUpdateLocation="path-list"]

/>

Atributos

En la siguiente tabla se describen los atributos y valores del elemento SetupUpdates.

Atributos de SetupUpdates

Atributo Valor Descripción

CheckForSUpdates

Yes (predeterminado)

El programa de instalación usa la lista de rutas en SUpdateLocation para buscar archivos de personalización del programa de instalación.

No

El programa de instalación no busca archivos de personalización del programa de instalación usando la lista de rutas en SUpdateLocation.

SUpdateLocation

path-list

Lista de rutas completas a carpetas, separadas por punto y coma.

Nota

Las variables de entorno no se pueden usar en la ruta de SUpdateLocation. Si se usa una variable de entorno en la ruta, el programa de instalación ignora los archivos de actualización que están en la ubicación de la ruta especificada.

Comentarios

El programa de instalación busca en todas las carpetas especificadas archivos de personalización del programa de instalación que se crearon para el producto que se está instalando, y los aplica en orden alfabético por nombre de archivo. Si un archivo de personalización del programa de instalación se especificó en una línea de comandos de dicho programa, se aplica primero ese archivo, seguido de cualquier archivo que se encuentre en la carpeta que este elemento especifique.

Ejemplo

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

Elemento USERINITIALS

Las iniciales del usuario en cuyo equipo se instala el producto.

Sintaxis

<USERINITIALS Value=" value " />

Atributos

En la siguiente tabla se describen los atributos y valores del elemento USERINITIALS.

Atributos de USERINITIALS

Atributo Valor Descripción

Value

value

Las iniciales del usuario

Ejemplo

<USERINITIALS Value="JD" />

Elemento USERNAME

El nombre del usuario en cuyo equipo se instala el producto.

Sintaxis

<USERNAME Value=" value " />

Atributos

En la siguiente tabla se describen los atributos y valores del elemento USERNAME.

Atributos de USERNAME

Atributo Valor Descripción

Value

value

El nombre del usuario.

Comentarios

Los datos del elemento Office 2013  Username se rellenan así:

Si el usuario que ejecuta Office es el mismo usuario que instaló Office, se usa el Username y las Initials proporcionados durante la instalación. El usuario no recibe ningún aviso cuando Office se inicia por primera vez. Este caso es el más común para usuarios particulares que instalan Office ellos mismos.

Si el usuario que ejecuta Officeno es el mismo usuario que instaló Office, Office avisa al usuario que confirme su Username e Initials cuando Office se inicie por primera vez. Este caso es el más común en un entorno empresarial, donde un administrador instala Office para el usuario.

El valor del elemento Username mostrado al usuario la primera vez de reinicio podría rellenarse previamente con un valor predeterminado de una versión instalada anteriormente de Office o del usuario conectado actualmente. Tenga en cuenta que el valor predeterminado no se usa a menos que el usuario lo confirme. Si se instala una versión anterior de Office en el equipo, se usa la clave del Registro que creó la versión anterior de Office. Por ejemplo, si la instalación previa de Office es Microsoft Office, la clave del Registro se proporciona en HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo.

Ejemplo

<USERNAME Value="John Doe" />

Archivo Config.xml de muestra

En el siguiente ejemplo se muestra un archivo Config.xml file de una instalación típica. El ejemplo usa la versión Office Professional Plus 2013 del producto.

<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 también

Referencia de la herramienta de personalización de Office (OCT) para Office 2013
Ediciones de 64 bits de Office 2013