Compartir a través de

Herramientas de Release Management para implementar una aplicación

  • Artículo

Cada acción de versión emplea una herramienta de Release Management. Por ejemplo, Ejecutor de línea de comandos es una herramienta que ejecuta un archivo ejecutable específico para una acción. Si necesita realizar una tarea que las herramientas proporcionadas no admiten, puede crear su propia herramienta personalizada y agregarla a una acción de versión personalizada. También se pueden usar herramientas para implementar un componente de la aplicación.

A continuación se muestra una lista de las herramientas que se proporcionan con Release Management y sus parámetros:

Database Deployment Agent – Ejecutar script

Esta herramienta ejecuta una consulta SQL en una base de datos concreta. Se basa en el ejecutable de sqlcmd estándar distribuido con SQL Server. Consulte la documentación de sqlcmd para obtener más información sobre este ejecutable. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-S

ServerName

Sí

Nombre del servidor de la base de datos SQL.

-i

ScriptName

Sí

Nombre del script que se va a ejecutar.

-b

N/D

No

Este parámetro es un modificador. Si está presente, indica que si se produce un error se anulará el lote.

Reporting Services Deployment Agent

Esta herramienta implementa informes de Reporting Services y objetos relacionados. Se basa en un ejecutable personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-s

serverUrl

Sí

Dirección URL completa del servidor de Reporting Services.

-l

itemLocation

Sí si hay varios elementos

Ubicación de los elementos. Si se especifica, se debe proporcionar la carpeta (-f).

-f

folder

Sí si hay varios elementos

Carpeta de los elementos. Si se especifica, se debe proporcionar la ubicación de los elementos (-l).

-t

Sí

Tipo de elemento que se va a procesar. Los valores permitidos son:

  • Informe

  • Imagen

-sp

No

Lista de patrones de búsqueda que se va a usar para filtrar los elementos. Los distintos patrones de búsqueda deben ir separados por una coma o un signo de punto y coma (por ejemplo, *.bmp;*.jpg). Si no se especifica, el patrón de búsqueda es el siguiente según el tipo de elemento seleccionado (-t):

  • Informe: *.rdl

  • Imagen: *.bmp,*.gif,*.jpg,*.jpeg,*.png

-i

Sí si hay un solo elemento

Archivo de elemento. Si se especifica, se debe proporcionar el nombre de elemento (-n). Este parámetro se usa cuando se debe implementar un único elemento. En tal caso, no se deben especificar los parámetros de ubicación del elemento (-l) y de carpeta (-f).

-n

Sí si hay un solo elemento

Nombre del elemento. Si se especifica, se debe proporcionar el archivo de elemento (-i). Este parámetro se usa cuando se debe implementar un único elemento. En tal caso, no se deben especificar los parámetros de ubicación del elemento (-l) y de carpeta (-f).

-log

No

Se genera en el directorio físico un archivo de registro con el nombre especificado.

-o

N/D

No

Este parámetro es un modificador. Si está presente, indica que se sobrescribirá el destino si ya existe.

-ds ds1,...,dsN

Nombre completo delimitado por comas de todos los orígenes de datos que se van a asociar al elemento. Distinguen mayúsculas de minúsculas. Esta opción solo se aplica a los informes. El origen de datos puede tener el formato [nombre:] referencia. Nombre es el nombre del origen de datos, según se especifica en el informe donde se van a reemplazar las referencias. Referencia es la referencia completa al origen de datos en el servidor de destino que se va a usar para el informe.

MSI Deployment Agent

Esta herramienta implementa un MSI. Desinstala la instalación anterior del producto antes de instalar la nueva. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./msiexec.ps1.

-MsiFileName

Installer

Sí

Ruta de acceso completa (si es necesaria) y nombre del archivo .msi que se va a instalar.

-MsiCustomArgs

MsiCustomArgs

No

Argumentos personalizados que se van a usar para instalar el archivo .msi. Estos argumentos se pasarán directamente al ejecutable msiexec. Si no se necesita ningún argumento personalizado, hay que quitar el parámetro de los argumentos.

-PrevProductName

No

Permite al usuario especificar el nombre del producto anterior que se va a desinstalar antes de instalar el archivo .msi. De forma predeterminada, el sistema usa el nombre del producto del archivo .msi que se va a instalar.

XCopy Deployment Agent

Esta herramienta copia una ubicación del paquete en un destino determinado. Se basa en un script por lotes personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-source

N/D

Sí

Valor fijo que indica que se debe copiar toda la ubicación de origen.

-destination

Ruta de acceso de instalación

Sí

Destino de la copia.

Ejecutor de línea de comandos

Esta herramienta ejecuta un archivo ejecutable específico. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-file

N/D

Sí

Valor fijo ./RunCommandLine.ps1.

-FilePath

FilePath

Sí

Ruta de acceso completa (si es necesaria) y nombre del archivo ejecutable que se va a ejecutar.

-Arguments

Argumentos

No

Argumentos necesarios cuando se ejecuta el archivo ejecutable.

-UserDomain

UserDomain

No

Dominio del usuario que se va a usar si el archivo ejecutable tiene que ejecutarse bajo una identidad específica. Si no se proporciona, se usa el usuario local (. \localuser).

-UserName

UserName

No

Nombre del usuario que se va a usar si el archivo ejecutable tiene que ejecutarse bajo una identidad específica.

-UserPassword

UserPassword

No

Contraseña del usuario que se va a usar si el archivo ejecutable tiene que ejecutarse bajo una identidad específica.

Administrador del Registro de Windows

Esta herramienta manipula información del Registro de Windows. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./ManageWindowsRegistry.ps1.

-Action

Acción

Sí

Acción que se va a realizar. Los valores permitidos son:

  • CreateKey: crea una nueva clave del Registro.

  • ModifyKey: modifica una clave del Registro o sus datos.

  • DeleteKey: elimina una clave del Registro con todos sus valores y subclaves.

  • CreateValue: crea un nuevo valor del Registro ubicado bajo una clave.

  • ModifyValue: modifica un valor del Registro ubicado bajo una clave.

  • DeleteValue: elimina un valor del Registro ubicado bajo una clave.

-OperatingSystemType

No

Indica si se accede a la clave y el valor en el Registro de 32 o de 64 bits. Si no se proporciona, el valor predeterminado es 32 bits.

-RegistryKey

RegistryKey

Sí

Ruta de acceso y nombre de la clave del Registro (por ejemplo, HKLM\Software\MiClave).

-RegistryValue

No*

Valor del Registro al que se aplicarán los cambios (por ejemplo, MiValor). Es necesario si se usa CreateValue, ModifyValue y DeleteValue.

-ValueType

No

Tipo del valor que se verá afectado. Los valores aceptados son:

  • REG_SZ: cadena (valor predeterminado si no se especifica)

  • REG_QWORD_LITTLE_ENDIAN: número de 64 bits en formato little-endian

  • REG_QWORD: número de 64 bits

  • REG_NONE: ningún valor

  • REG_MULTI_SZ: cadena multilínea (líneas separadas mediante \0)

  • REG_LINK: vínculo simbólico

  • REG_EXPAND_SZ: cadenas con referencias no expandidas a variables de entorno

  • REG_DWORD_BIG_ENDIAN: número de 32 bits en formato big-endian

  • REG_DWORD_LITTLE_ENDIAN: número de 32 bits en formato little-endian

  • REG_DWORD: número de 32 bits

  • REG_BINARY: datos binarios en cualquier formato.

-RegistryData

No

Datos que se van a aplicar al valor (si se usa CreateValue o ModifyValue) o al valor predeterminado de la calve (si se usa CreateKey o ModifyKey).

-RegistryKeyDestination

No*

Nombre de la clave del Registro que se usará cuando se emplee la acción ModifyKey para cambiar el nombre de una clave del Registro. Por ejemplo:

  • RegistryKey = HKLM\Software\MiClave

  • RegistryKeyDestination = HKLM\Software\MiClaveModificada. Es necesario si se usa ModifyKey.

E/S común de Windows

Esta herramienta realiza acciones comunes de E/S en Windows. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./ManageWindowsIO.ps1.

-Action

Acción

Sí

Indica la acción que se va a realizar:

  • Create: crear una nueva carpeta.

  • Delete: eliminar archivos o carpeta.

  • Rename: cambiar el nombre de un archivo o una carpeta.

  • Move: mover un archivo o una carpeta.

  • Attrib: modificar los atributos (incluida la propiedad) de archivos o carpetas.

-FileFolderName

FileFolderName

Sí

Ruta de acceso y nombre de los archivos o de la carpeta.

-DestinationName

No*

Nombre de destino (para la acción de cambio de nombre) o ruta de acceso y nombre de la carpeta (para la acción de movimiento). Es necesario para las acciones Rename y Move.

-ReadOnly

No

Permite al usuario establecer o restablecer el atributo de solo lectura de archivos o carpetas.

  • +: establecer la marca

  • -: restablecer la marca

  • Cualquier otro valor: dejar la marca como está.

-Archive

No

Permite al usuario establecer o restablecer el atributo archive de archivos o carpetas.

  • +: establecer la marca

  • -: restablecer la marca

  • Cualquier otro valor: dejar la marca como está.

-System

No

Permite al usuario establecer o restablecer el atributo system de archivos o carpetas.

  • +: establecer la marca

  • -: restablecer la marca

  • Cualquier otro valor: dejar la marca como está.

-Hidden

No

Permite al usuario establecer o restablecer el atributo hidden de archivos o carpetas.

  • +: establecer la marca

  • -: restablecer la marca

  • Cualquier otro valor: dejar la marca como está.

-OwnerDomain

No

Representa el dominio del nuevo propietario del archivo o la carpeta.

-OwnerName

No

Representa el nombre del nuevo propietario del archivo o la carpeta.

Administrador de servicios de Windows

Esta herramienta administra servicios de Windows. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./ManageWindowsServices.ps1.

-Action

Acción

Sí

Indica la acción que se va a realizar:

  • Create: crear un nuevo servicio.

  • Config: configurar un servicio existente.

  • Delete: eliminar un servicio existente.

  • Start: iniciar un servicio.

  • Stop: detener un servicio.

  • Restart: detener e iniciar el servicio.

-ServiceName

ServiceName

Sí

Nombre del servicio.

-ServerName

No

Nombre del servidor en el que se va a realizar esta acción. Si no se especifica, se usará el servidor actual.

-BinPath

No*

Ruta de acceso y nombre binarios del servicio. Es necesario para la acción Create, opcional para la acción Config y se omite en todas las demás acciones.

-DisplayName

No

Nombre para mostrar que se usará para este servicio. Es opcional para las acciones Create y Config, y se omite en todas las demás acciones.

-Description

No

Descripción que se asignará al servicio. Es opcional para las acciones Create y Config, y se omite en todas las demás acciones.

-UserName

No

Nombre de usuario que se empleará para las credenciales de inicio del servicio (debe tener el formato DOMINIO\USUARIO). Si se especifica este parámetro, debe especificarse también el parámetro –Password. Si no se especifica, se usará la cuenta LocalSystem de manera predeterminada. Es opcional para las acciones Create y Config, y se omite en todas las demás acciones.

Para restablecer las credenciales a la cuenta LocalSystem, especifique LocalSystem como usuario y "" como contraseña.

-Password

No

Contraseña del nombre de usuario especificado para iniciar el servicio. Es opcional para las acciones Create y Config, y se omite en todas las demás acciones.

-StartMode

No

Modo de inicio del servicio. El servicio se creará de forma predeterminada con el modo Automático. Las opciones son las siguientes:

  • Manual: el servicio solo se inicia manualmente.

  • Automático: el servicio se iniciará automáticamente la próxima vez que se reinicie el equipo.

  • Deshabilitado: el servicio está deshabilitado.

Es opcional para las acciones Create y Config, y se omite en todas las demás acciones.

DACPAC Database Deployment Agent

Esta herramienta implementa un paquete DACPAC. Se basa en una utilidad de la línea de comandos de SQL Server. Este archivo ejecutable tiene muchos parámetros posibles, pero solo se muestra aquí la lista de parámetros que se usan para esta herramienta. Consulte la utilidad de línea de comandos SQLPackage para obtener más información. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

/Action:

Sí

Valor fijo: Publish, especifica que el paquete se va a publicar.

/SourceFile:

FileName

Sí

Ruta de acceso completa (si es necesaria) y nombre del archivo DACPAC.

/TargetServerName:

ServerName

Sí

Nombre del servidor SQL Server en el que se va a publicar el paquete.

/TargetDatabaseName:

DatabaseName

Sí

Nombre de la base de datos SQL Server en la que se va a publicar el paquete.

IIS Deployment Agent

Esta herramienta manipula objetos y configuraciones de IIS. Se basa en un ejecutable personalizado de administración de versiones. Las variables de configuración de esta herramienta varían en función del tipo de acciones que se vayan a realizar.

Para acciones sobre grupos de aplicaciones:

Parámetro

Variable

Obligatorio

Descripción

-Action

Sí

Indica la acción que se va a realizar:

  • CreateApplicationPool

  • ConfigureApplicationPool

  • DropApplicationPool

  • StartApplicationPool

  • StopApplicationPool

  • RecycleApplicationPool

-ap

Sí

Nombre del grupo de aplicaciones.

-apAllow32Bit

No

Marca que indica si el grupo de aplicaciones debe permitir aplicaciones de 32 bits. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Los valores permitidos son:

  • 1 o True: se permiten aplicaciones de 32 bits.

  • 0 o False: no se permiten aplicaciones de 32 bits.

-apIdentUserDomain

No

Dominio del usuario que se usará como identidad del grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Si no se define este parámetro y se define “IdentityUserName”, se considera que se trata de un usuario local (. \localuser).

-apIdentUserName

No

Nombre de usuario que se usará como identidad del grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Si no se define, se omiten “IdentityUserDomain” e “IdentityUserPassword” y se usa el valor predeterminado de IIS (es decir, ApplicationPoolIdentity).

-apIdentUserPassword

No

Contraseña del usuario que se usará como identidad del grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5.

-apNetVers

No

Versión de .NET Framework que se usará para el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Los valores permitidos son: v1.0, v1.1, v2.0, v4.0

-apPipelineMode

No

Modo de canalización administrada que se usará en el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Los valores permitidos son:

  • Classic

  • Integrado

-apProcessIdleTimeout

No

Número de minutos que un proceso puede estar inactivo en el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5.

-apRecycleKbMemory

No

Número máximo de kB de memoria que hay que usar antes de que se recicle el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5.

-apRecycleMinutes

No

Número fijo de minutos después de los cuales se reciclará el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5.

- apRecycleSpecificTime

No

Hora fija a la que se reciclará el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. El formato necesario es HH:MM (por ejemplo, 23:58 o 01:23).

-apStartMode

No

Modo de inicio que se usará para el grupo de aplicaciones. Este parámetro solo se permite para IIS 8.0 y 8.5. Los valores permitidos son:

  • OnDemand

  • AlwaysRunning

-AutoStart

No

Marca que indica si el grupo de aplicaciones se debe iniciar automáticamente. Este parámetro solo se permite para IIS 7.0, 7.5, 8.0 y 8.5. Los valores permitidos son:

  • 1 o True: el grupo de aplicaciones se iniciará automáticamente cuando se inicie Windows.

  • 0 o False: el grupo de aplicaciones no se iniciará automáticamente cuando se inicie Windows.

-log

No

Para acciones sobre sitios web:

Parámetro

Variable

Obligatorio

Descripción

-Action

Sí

Indica la acción que se va a realizar:

  • CreateWebSite

  • ConfigureWebSite

  • DropWebSite

  • StartWebSite

  • StopWebSite

  • RestartWebSite

-sn

Sí

Nombre del sitio web.

-port

No*

Número de puerto del sitio web. Es obligatorio para la acción Create y opcional para la acción Configure.

-pd

No*

Ruta de acceso completa a la ubicación donde se publicó la aplicación. Es obligatorio para la acción Create y opcional para la acción Configure.

NotaNota
Asegúrese de que la ruta de acceso no contiene ninguna barra diagonal final.

-ap

No

Nombre del grupo de aplicaciones. Si no se define durante la creación de un grupo de aplicaciones, se usa el grupo de aplicaciones predeterminado. Es opcional para las acciones Create y Configure.

-EnablePreload

No

Permitido en IIS 7.0, 7.5, 8.0 y 8.5. Marca que indica si el sitio web se debe precargar. Es opcional para las acciones Create y Configure. Los valores permitidos son:

  • 1 o True: la precarga está habilitada

  • 0 o False: la precarga está deshabilitada

-AutoStart

No

Permitido en IIS 7.0, 7.5, 8.0 y 8.5. Marca que indica si el sitio web se debe iniciar automáticamente. Es opcional para las acciones Create y Configure. Los valores permitidos son:

  • 1 o True: se inicia automáticamente

  • 0 o False: no se inicia automáticamente

-log

No

Se genera en el directorio físico un archivo de registro con el nombre especificado.

Para acciones sobre aplicaciones web:

Parámetro

Variable

Obligatorio

Descripción

-Action

Sí

Indica la acción que se va a realizar:

  • CreateWebApplication

  • ConfigureWebApplication

  • DropWebApplication

-ws

Sí

Nombre de la aplicación que se va a crear.

-pd

No*

Ruta de acceso completa a la ubicación donde se publicó la aplicación. Es obligatorio para la acción Create y opcional para la acción Configure.

-sn

No

Nombre del sitio web. Si no se especifica, el sistema usará el sitio web predeterminado cuando se cree una aplicación nueva. Es opcional para las acciones Create y Configure.

-ap

No

Nombre del grupo de aplicaciones. Si no se define durante la creación de un grupo de aplicaciones, se usa el grupo de aplicaciones predeterminado. Es opcional para las acciones Create y Configure.

-EnablePreload

No

Permitido en IIS 7.0, 7.5, 8.0 y 8.5. Marca que indica si el sitio web se debe precargar. Es opcional para las acciones Create y Configure. Los valores permitidos son:

  • 1 o True: la precarga está habilitada

  • 0 o False: la precarga está deshabilitada

-log

No

Se genera en el directorio físico un archivo de registro con este nombre.

Para acciones sobre directorios virtuales:

Parámetro

Variable

Obligatorio

Descripción

-Action

Sí

Indica la acción que se va a realizar:

  • CreateVirtualDirectory

  • ConfigureVirtualDirectory

  • DropVirtualDirectory

-vd

Sí

Nombre del directorio virtual.

-pd

No*

Ruta de acceso completa del directorio virtual. Es obligatorio para la acción Create y opcional para la acción Configure.

-sn

No

Nombre del sitio web. Si no se especifica, el sistema usará el sitio web predeterminado cuando se cree una aplicación nueva. Es opcional para las acciones Create y Configure.

-ws

No

Nombre de la aplicación web. Si no se especifica, el sistema usará la aplicación web raíz cuando se cree un directorio virtual nuevo. Es opcional para las acciones Create y Configure.

-log

No

Se genera en el directorio físico un archivo de registro con este nombre.

Administrador de VM de Microsoft Azure

Esta herramienta administra una máquina virtual en Microsoft Azure. Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./ControlAzureVM.ps1.

-Command

Sí

Indica la acción que se va a realizar:

  • Start: iniciar la máquina virtual.

  • Stop: detener la máquina virtual.

-ServiceName

ServiceName

Sí

Nombre del servicio de Microsoft Azure en el que existe la máquina virtual.

-Name

Name

Sí

Nombre de la máquina virtual de Microsoft Azure.

Implementador de XBAP

Esta herramienta implementa una aplicación XBAP. Se basa en un ejecutable personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

- pn

ProjectName

Sí

Nombre del proyecto de XBAP que se va a implementar.

-d

Ruta de acceso de instalación

Sí

Ruta de acceso de instalación de la aplicación XBAP.

-ml

No

Ruta de acceso completa al archivo ejecutable de la utilidad mage. Si no se define, la herramienta usará la que se proporciona como un recurso en la herramienta.

-pl

No

Ruta de acceso completa donde se encuentra el proyecto de XBAP que se va a implementar. Si no se especifica, la herramienta usará la ubicación del paquete donde se ejecuta.

-url

No

Si se especifica, el sistema reemplaza la dirección URL del archivo setup.exe con la especificada.

-cf

No

Si se especifica, se usará como nombre de certificación al actualizar el manifiesto.

-pwd

No

Si se especifica, se usará como contraseña de certificación al actualizar el manifiesto.

-log

No

Se genera en el directorio físico un archivo de registro con este nombre.

Utilidad de la línea de comandos Microsoft Test Manager (MTM)

Esta herramienta crea e inicia series de pruebas automatizadas en MTM (Microsoft Test Manager). Se basa en un script de PowerShell personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./TcmExec.ps1.

-Title

TestRunTitle

Sí

Nombre de que se usará al crear la serie de pruebas.

-PlanId

PlanId

Sí

Identificador del plan de pruebas bajo el cual se deben ejecutar las pruebas (Id. único como se define en Test Manager).

-SuiteId

SuiteId

Sí

Identificador del conjunto que desea ejecutar (Id. único como se define en Test Manager).

-ConfigId

ConfigId

Sí

Identificador de la configuración de prueba bajo la cual se deben ejecutar las pruebas (Id. único como se define en Test Manager).

-Collection

TFSCollection

Sí

Dirección URL de la colección de Team Foundation Server para la que se ejecutarán las pruebas automatizadas.

-TeamProject

TeamProject

Sí

Nombre del proyecto de equipo en el que se configuraron las pruebas automatizadas.

-TestEnvironment

TestEnvironment

Sí

Entorno de prueba en el que se van a ejecutar las pruebas (el entorno de prueba está asociado a un controlador de pruebas correspondiente).

-BuildDirectory

BuildDirectory

No*

Ubicación de las pruebas automatizadas. En MTM 2010, este parámetro es obligatorio. En MTM 2012 y 2013, este parámetro se sigue admitiendo, pero los usuarios deben emplear preferiblemente los parámetros BuildDefinition y BuildNumber.

-BuildDefinition

No*

Permite al usuario especificar la definición de compilación en la que se incluyen las pruebas automatizadas. Este parámetro solo se puede usar con MTM 2012. Si se define, también debe especificarse el parámetro BuildNumber. Si no se especifica, el campo "build" visible en los detalles de una serie de pruebas no se ve afectado por la serie de pruebas.

-BuildNumber

No*

Permite al usuario especificar el número de compilación cuya ubicación de destino contendrá las pruebas automatizadas. Este parámetro solo se puede usar en MTM 2012. Si se define, también debe especificarse el parámetro BuildDefinition. Si no se especifica, el campo "build" visible en los detalles de una serie de pruebas no se ve afectado por la serie de pruebas.

-SettingsName

No

Permite al usuario especificar la configuración que se va a usar para la serie de pruebas. Si no se especifica, se usa la configuración de pruebas predeterminada.

-TestRunWaitDelay

No

Permite al usuario especificar el retardo, en segundos, entre cada llamada al controlador de pruebas. Es necesario para que se complete la serie de pruebas antes de que se procesen los resultados de pruebas. Si no especifica, se usará 10 segundos de forma predeterminada.

-InconclusiveFailsTests

N/D

No

Cuando se establece esta marca, la existencia de pruebas no concluyentes producirá un error en la implementación. De forma predeterminada, una prueba no concluyente no producirá ningún error en la implementación.

-RemoveIncludeParameter

N/D

No

Cuando se establece esta marca, el parámetro /include no se anexará al comando de creación de pruebas. Esto significa que las pruebas que tengan un estado diferente a Active no se incluirán en la serie de pruebas.

Si las pruebas automatizadas están incluidas en el mismo proceso de compilación que la aplicación que se va a implementar, es posible usar metadatos como el valor de una variable y se reemplazarán automáticamente en el momento de la publicación. A continuación se muestran los metadatos que se pueden usar actualmente con variables de configuración.

Variable

Metadatos de valor de la variable

BuildDirectory

$(PackageLocation)

BuildNumber

$(BuildNumber)

BuildDefinition

$(BuildDefinition)

TFSCollection

$(TFSUrlWithCollection)

TeamProject

$(TeamProject)

Administrador de archivos INI

Esta herramienta modifica el contenido de un archivo .ini y puede crear un nuevo archivo .ini si se especifica. Se basa en un ejecutable personalizado de administración de versiones. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-Action

Sí

Indica la acción que se va a realizar:

  • ModifySection

  • RemoveSection

  • CreateKeyValue

  • ModifyKeyValue

  • RemoveKeyValue

-INIFile

INIFileName

Sí

Nombre y ruta de acceso (si es necesaria) del archivo .ini.

-SectionName

SectionName

No

Nombre de sección que se va a ver afectado. Si no se especifica, se considera que se trata de la sección raíz (se considera que todas las claves que están al principio del archivo antes de la primera sección están en la raíz).

-NewSectionName

No

Nuevo nombre de sección. Si no se especifica, se considera que se trata de la sección raíz (se considera que todas las claves que están al principio del archivo antes de la primera sección están en la raíz). Es necesario para la acción ModifySection.

-KeyName

No

Nombre de clave que se va a ver afectado. Es necesario para CreateKeyValue, ModifyKeyValue y RemoveKeyValue.

-KeyValue

No

Valor que se va a usar para la clave. Cuando se usa la acción ModifyKeyValue y no se especifica este parámetro y sí se especifica NewKeyName, el sistema usará el valor real. Si no se especifica este parámetro y tampoco se especifica NewKeyName, el valor será vacío.

-NewKeyName

No

Nuevo nombre que se va a asignar a la clave. Solo se usa con la acción ModifyKeyValue.

-CreateFileIfNotExists

No

Indica a la herramienta que se debe crear un archivo si no existe.

Proceso de Windows

Esta herramienta puede terminar un proceso de Windows. Las variables de configuración de esta herramienta son las siguientes:

Parámetro

Variable

Obligatorio

Descripción

-command

N/D

Sí

Valor fijo ./WindowsProcess.ps1.

-ProcessName

Sí

Nombre del proceso de Windows que se va a terminar.

-UserName

No

Cuenta de usuario en la que se ejecuta el proceso. Si no se especifica, se terminará el proceso para todos los usuarios.

-IsKillProcessTree

No

Marca que indica si se debe terminar el árbol de procesos. Los valores permitidos son:

  • 1: terminar árbol de procesos

  • 0 o vacío: no terminar árbol de procesos