Ferramentas do Release Management para implantar um aplicativo

Cada ação de liberação usa uma ferramenta de gerenciamento de liberação. Por exemplo, Command Line Runner é uma ferramenta que executa determinado executável para uma ação. Se você precisar executar uma tarefa para a qual as ferramentas fornecidas não ofereçam suporte, poderá criar sua própria ferramenta personalizada e adicioná-la a uma ação de liberação personalizada. As ferramentas também podem ser usadas para implantar um componente de seu aplicativo.

Aqui está uma lista das ferramentas e respectivos parâmetros que são fornecidos com o Release Management:

Database Deployment Agent – Execute Script

Essa ferramenta executa uma consulta SQL em determinado banco de dados. Ela é baseada no padrão sqlcmd executável distribuído com o SQL Server. Consulte a documentação do sqlcmd para obter mais informações sobre esse executável. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-S	ServerName	Sim	O nome do servidor do banco de dados SQL.
-i	ScriptName	Sim	O nome do script a ser executado.
-b	N/D	Não	Esse parâmetro é uma opção. Se presente, significa que se um erro ocorrer, o lote será anulado.

Reporting Services Deployment Agent

Essa ferramenta implanta relatórios do Reporting Services e objetos relacionados. Ela é baseada em um executável de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-s	serverUrl	Sim	A URL completa do servidor do Reporting Services.
-l	itemLocation	Sim, se houver vários itens	O local dos itens. Se especificado, a pasta deve ser fornecida (-f).
-f	folder	Sim, se houver vários itens	A pastas dos itens. Se especificada, o local dos itens deve ser fornecido (-l).
-t		Sim	O tipo de item a ser processado. Os valores permitidos são: Relatório Imagem
-sp		Não	Lista de padrões de pesquisa a ser usados para filtrar os itens. Cada padrão de pesquisa deve ser separado por vírgula ou ponto-e-vírgula (por exemplo, *.bmp;*.jpg). Se não especificado, o padrão de pesquisa será este, com base no tipo de item selecionado (-t): Relatório: *.rdl Imagem: *.bmp,*.gif,*.jpg,*.jpeg,*.png
-i		Sim, se houver itens individuais	Arquivo do item. Se especificado, o nome do item deve ser fornecido (-n). Esse parâmetro é usado quando um único item deve ser implantado. Nesse caso, os parâmetros de local dos itens (-l) e de pasta (-f) não devem estar presentes.
-n		Sim, se houver itens individuais	Nome do item. Se especificado, o arquivo do item deve ser fornecido (-i). Esse parâmetro é usado quando um único item deve ser implantado. Nesse caso, os parâmetros de local dos itens (-l) e de pasta (-f) não devem estar presentes.
-log		Não	Será gerado um arquivo de log com esse nome no diretório físico.
-o	N/D	Não	Esse parâmetro é uma opção. Se presente, significa que o destino será substituído se ele já existir.
-ds ds1,...,dsN			Nome totalmente qualificado delimitado por vírgula de todas as fontes de dados que devem ser associadas ao item. Eles diferenciam maiúsculas de minúsculas. Essa opção aplica-se somente a relatórios. A fonte de dados pode ser no formato [nome:] referência. Nome é o nome da fonte de dados, conforme especificado no relatório em que as referências devem ser substituídas. Referência é a referência totalmente qualificada para a fonte de dados no servidor de destino para usar no relatório.

MSI Deployment Agent

Essa ferramenta implanta um MSI. Ela desinstala a instalação anterior do produto antes de instalar uma nova. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./msiexec.ps1.
-MsiFileName	Installer	Sim	O caminho completo (se necessário) e o nome do arquivo .msi para instalar.
-MsiCustomArgs	MsiCustomArgs	Não	Os argumentos personalizados a serem usados para instalar o arquivo .msi. Esses argumentos serão passados diretamente para o msiexec executável. Se nenhum argumento personalizado for necessário, o parâmetro terá de ser removido dos argumentos.
-PrevProductName		Não	Permite que o usuário especifique o nome do produto anterior a ser desinstalado antes de instalar o arquivo .msi. Por padrão, o sistema usará o nome do produto no arquivo .msi para instalar.

XCopy Deployment Agent

Essa ferramenta copia o local de um pacote para um destino específico. Ela é baseada em um script em lote de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-source	N/D	Sim	Valor fixo indicando que o local de origem deve ser copiado
-destination	Installation Path	Sim	O destino da cópia.

Command Line Runner

Essa ferramenta executa determinado executável. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-file	N/D	Sim	Valor fixo. / RunCommandLine.ps1.
-FilePath	FilePath	Sim	O caminho completo (se necessário) e o nome do arquivo do executável que deve ser executado.
-Arguments	Arguments	Não	Os argumentos necessários quando o executável é executado.
-UserDomain	UserDomain	Não	O domínio do usuário que deve ser usado quando o executável precisa ser executado sob uma identidade específica. Se não fornecido, o usuário local será usado (. \localuser).
-UserName	UserName	Não	O nome do usuário que deve ser usado quando o executável precisa ser executado sob uma identidade específica.
-UserPassword	UserPassword	Não	A senha do usuário que deve ser usada quando o executável precisa ser executado sob uma identidade específica.

Windows Registry Manager

Essa ferramenta manipula as informações de Registro no Windows. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./ManageWindowsRegistry.ps1.
-Action	Ação	Sim	A ação a ser executada. Os valores permitidos são: CreateKey: criar uma nova chave de Registro ModifyKey: modificar uma chave de Registro ou seus dados DeleteKey: excluir uma chave de Registro com todos os seus valores e subchaves CreateValue: criar um novo valor de Registro localizado em uma chave ModifyValue: modificar um valor de Registro localizado em uma chave DeleteValue: excluir um valor de Registro localizado em uma chave
-OperatingSystemType		Não	Indica se a chave/o valor é acessada(o) no Registro de 32 bits ou 64 bits. Se não fornecido, o padrão é 32 bits.
-RegistryKey	RegistryKey	Sim	Caminho e nome do Registro de chave (por exemplo, HKLM\Software\MyKey).
-RegistryValue		Não*	Valor do Registro ao qual as alterações serão aplicadas (por exemplo, MyValue). Necessário para CreateValue, ModifyValue e DeleteValue.
-ValueType		Não	Tipo do valor que está sendo afetado. Os valores aceitos são: REG_SZ: cadeia de caracteres (valor padrão, se não especificado) REG_QWORD_LITTLE_ENDIAN: um número de 64 bits no formato little-endian REG_QWORD: um número de 64 bits REG_NONE: nenhum valor REG_MULTI_SZ: cadeia de caracteres de várias linhas (separadas por \0) REG_LINK: link simbólico REG_EXPAND_SZ: cadeia de caracteres com referências não expandidas a variáveis de ambiente REG_DWORD_BIG_ENDIAN: um número de 32 bits no formato big-endian REG_DWORD_LITTLE_ENDIAN: um número de 32 bits no formato little-endian REG_DWORD: um número de 32 bits REG_BINARY: dados binários em qualquer formulário
-RegistryData		Não	Os dados para aplicar o valor (se estiver usando CreateValue ou ModifyValue) ou o valor padrão da chave (se estiver usando CreateKey ou ModifyKey).
-RegistryKeyDestination		Não*	O nome da chave de Registro a ser usada com a ação ModifyKey para renomear uma chave de Registro. Por exemplo: RegistryKey = HKLM\Software\MyKey RegistryKeyDestination = HKLM\Software\MyModifiedKey necessário para ModifyKey.

Windows Common IO

Essa ferramenta executa E/S comum no Windows. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./ManageWindowsIO.ps1.
-Action	Ação	Sim	Indica a ação a ser executada: Create: criar uma nova pasta Delete: excluir arquivos ou pastas Rename: renomear um arquivo ou uma pasta Move: mover um arquivo ou uma pasta Attrib: modificar os atributos (incluindo a propriedade) de arquivos ou pastas
-FileFolderName	FileFolderName	Sim	O caminho e nome do arquivo ou da pasta.
-DestinationName		Não*	O nome de destino (para ação rename) ou o caminho da pasta e o nome (para ação move). Necessário para ações Rename e Move.
-ReadOnly		Não	Permitir que o usuário defina ou redefina os arquivos ou o atributo read-only da pasta. +: definir o sinalizador - : redefinir o sinalizador Qualquer outro valor: deixar o sinalizador como está
-Archive		Não	Permitir que o usuário defina ou redefina os arquivos ou o atributo archive da pasta. +: definir o sinalizador - : redefinir o sinalizador Qualquer outro valor: deixar o sinalizador como está
-System		Não	Permitir que o usuário defina ou redefina os arquivos ou o atributo system da pasta. +: definir o sinalizador - : redefinir o sinalizador Qualquer outro valor: deixar o sinalizador como está
-Hidden		Não	Permitir que o usuário defina ou redefina os arquivos ou o atributo hidden da pasta. +: definir o sinalizador - : redefinir o sinalizador Qualquer outro valor: deixar o sinalizador como está
-OwnerDomain		Não	Representam o domínio do novo proprietário do arquivo ou da pasta.
-OwnerName		Não	Representam o nome do novo proprietário do arquivo ou da pasta.

Windows Service Manager

Essa ferramenta gerencia os serviços do Windows. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./ManageWindowsServices.ps1.
-Action	Ação	Sim	Indica a ação a ser executada: Create: criar um novo serviço Config: configurar um serviço existente Delete: excluir um serviço existente Start: iniciar um serviço Stop: parar um serviço Restart: parar e iniciar o serviço
-ServiceName	ServiceName	Sim	Nome do serviço.
-ServerName		Não	O nome do servidor em que essa ação será executada. Se não for especificado, será usado o servidor atual.
-BinPath		Não*	Caminho binário e nome do serviço. Necessário para a ação Create, opcional para ação Config e ignorado por todas as outras.
-DisplayName		Não	Nome para exibição que será usado para esse serviço. Opcional para as ações Create e Config e ignorado por todas as outras.
-Description		Não	Descrição que será fornecida para o serviço. Opcional para as ações Create e Config e ignorado por todas as outras.
-UserName		Não	Nome de usuário que será usado para as credenciais iniciarem o serviço (deve estar na formulário DOMÍNIO\USUÁRIO). Se fornecido, o parâmetro –Password também deve ser fornecido. Se não fornecido, a conta LocalSystem será usada por padrão. Opcional para as ações Create e Config e ignorado por todas as outras. Para redefinir as credenciais para LocalSystem, digite LocalSystem como o usuário e "" como a senha.
-Password		Não	Senha do nome de usuário especificado para iniciar o serviço. Opcional para as ações Create e Config e ignorado por todas as outras.
-StartMode		Não	Modo de inicialização do serviço. Por padrão, o serviço será criado com Automatic. As opções são: Manual: o serviço é iniciado apenas manualmente Automatic: o serviço será iniciado automaticamente na próxima vez que o computador for reiniciado Disabled: o serviço é desabilitado Opcional para as ações Create e Config e ignorado por todas as outras.

DACPAC Database Deployment Agent

Essa ferramenta implanta um pacote DACPAC. Ela é baseada em um utilitário de linha de comando do SQL Server. Há muitos parâmetros possíveis para esse executável, mas essa é a lista de parâmetros que são usados para essa ferramenta. Consulte o utilitário de linha de comando do pacote SQL para obter mais informações. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
/Action:		Sim	Valor fixo: Publish – especifica que o pacote será publicado.
/SourceFile:	FileName	Sim	O caminho completo (se necessário) e o nome do arquivo do DACPAC.
/TargetServerName:	ServerName	Sim	O nome do SQL Server no qual publicar o pacote.
/TargetDatabaseName:	DatabaseName	Sim	O nome do banco de dados do SQL Server no qual publicar o pacote.

IIS Deployment Agent

Essa ferramenta manipula as configurações e os objetos do IIS. Ela é baseada em um executável de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta variam de acordo com o tipo das ações a serem executadas.

Para ações do pool de aplicativos:

Parâmetro	Variável	Obrigatório	Descrição
-Action		Sim	Indica a ação a ser executada: CreateApplicationPool ConfigureApplicationPool DropApplicationPool StartApplicationPool StopApplicationPool RecycleApplicationPoo
-ap		Sim	Nome do pool de aplicativos.
-apAllow32Bit		Não	Sinalizador que indica se o pool de aplicativos deve permitir aplicativos de 32 bits. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Os valores permitidos são: 1 ou True: aplicativos de 32 bits são permitidos 0 ou False: aplicativos de 32 bits não são permitidos
-apIdentUserDomain		Não	Domínio do usuário a ser usado como a identidade do pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Se não estiver definido e "IdentityUserName" estiver definido, o usuário será considerado um usuário local (. \localuser).
-apIdentUserName		Não	Nome de usuário a ser usado como a identidade do pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Se não estiver definido, "IdentityUserDomain" e "IdentityUserPassword" serão ignorados e o valor padrão do IIS será usado (ApplicationPoolIdentity).
-apIdentUserPassword		Não	A senha do usuário a ser usada como a identidade do pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5.
-apNetVers		Não	A versão do .NET Framework a ser usada no pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Os valores permitidos são: v1.0, v1.1, v2.0, v4.0
-apPipelineMode		Não	O modo de pipeline gerenciado a ser usado no pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Os valores permitidos são: Classic Integrated
-apProcessIdleTimeout		Não	O número de minutos em que um processo pode ficar ocioso no pool de aplicativos. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5.
-apRecycleKbMemory		Não	O número máximo de KB de memória que será usado antes de o pool de aplicativo ser reciclado. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5.
-apRecycleMinutes		Não	Um número fixo de minutos após o qual o pool de aplicativos é reciclado. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5.
-apRecycleSpecificTime		Não	Um horário fixo na qual o pool de aplicativos é reciclado. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. O formato necessário é HH:MM (por exemplo, 23:58 ou 01:23).
-apStartMode		Não	O modo de inicialização a ser usado para o pool de aplicativos. Esse parâmetro é permitido somente para o IIS 8.0 e 8.5. Os valores permitidos são: OnDemand AlwaysRunning
-AutoStart		Não	Sinalizador que indica se o pool de aplicativos deve ser iniciado automaticamente. Esse parâmetro é permitido somente para o IIS 7.0, 7.5, 8.0 e 8.5. Os valores permitidos são: 1 ou True: o pool de aplicativos será iniciado automaticamente quando o Windows for iniciado. 0 ou False: o pool de aplicativos não será iniciado automaticamente quando o Windows for iniciado.
-log		Não

Para ações Web Site:

Parâmetro	Variável	Obrigatório	Descrição
-Action		Sim	Indica a ação a ser executada: CreateWebSite ConfigureWebSite DropWebSite StartWebSite StopWebSite RestartWebSite
-sn		Sim	Nome do site.
-port		Não*	O número da porta do site. Obrigatório para criar ação e opcional em configurar.
-pd		Não*	O caminho completo de roteamento para o local onde o aplicativo foi publicado. Obrigatório para criar ação e opcional em configurar. Observação Certifique-se de que não há nenhuma barra invertida no caminho.
-ap		Não	Nome do pool de aplicativos. Se não definido durante a criação de um pool de aplicativos, o pool de aplicativos padrão será usado. Opcional nas ações Create e Configure.
-EnablePreload		Não	Permitido no IIS 7.0, 7.5, 8.0 e 8.5. Sinalizador que indica se o site deve ser pré-carregado. Opcional nas ações Create e Configure. Os valores permitidos são: 1 ou True: pré-carregamento habilitado 0 ou false: pré-carregamento desabilitado
-AutoStart		Não	Permitido no IIS 7.0, 7.5, 8.0 e 8.5. Sinalizador que indica se o site deve ser iniciado automaticamente. Opcional nas ações Create e Configure. Os valores permitidos são: 1 ou True: iniciar automaticamente 0 ou false: não iniciar automaticamente
-log		Não	Será gerado um arquivo de log com esse nome no diretório físico.

Para ações Web Application:

Parâmetro	Variável	Obrigatório	Descrição
-Action		Sim	Indica a ação a ser executada: CreateWebApplication ConfigureWebApplication DropWebApplication
-ws		Sim	Nome do aplicativo a ser criado.
-pd		Não*	O caminho completo de roteamento para o local onde o aplicativo foi publicado. Obrigatório para criar ação e opcional em configurar.
-sn		Não	Nome do site. Se não especificado, o sistema usará o site padrão para criar um novo aplicativo. Opcional nas ações Create e Configure.
-ap		Não	Nome do pool de aplicativos. Se não definido durante a criação de um pool de aplicativos, o pool de aplicativos padrão será usado. Opcional nas ações Create e Configure.
-EnablePreload		Não	Permitido no IIS 7.0, 7.5, 8.0 e 8.5. Sinalizador que indica se o site deve ser pré-carregado. Opcional nas ações Create e Configure. Os valores permitidos são: 1 ou True: pré-carregamento habilitado 0 ou false: pré-carregamento desabilitado
-log		Não	Será gerado um arquivo de log com esse nome no diretório físico.

Para ações virtual directory:

Parâmetro	Variável	Obrigatório	Descrição
-Action		Sim	Indica a ação a ser executada: CreateVirtualDirectory ConfigureVirtualDirectory DropVirtualDirectory
-vd		Sim	Nome do diretório virtual.
-pd		Não*	O caminho completo do diretório virtual. Obrigatório para criar ação e opcional em configurar.
-sn		Não	Nome do site. Se não especificado, o sistema usará o site padrão para criar um novo aplicativo. Opcional nas ações Create e Configure.
-ws		Não	Nome do aplicativo Web. Se não especificado, o sistema usará o aplicativo Web raiz para criar um novo diretório virtual. Opcional nas ações Create e Configure.
-log		Não	Será gerado um arquivo de log com esse nome no diretório físico.

Microsoft Azure VM Manager

Essa ferramenta gerencia uma VM no Microsoft Azure. Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./ControlAzureVM.ps1.
-Command		Sim	Indica a ação a ser executada: Start: iniciar a VM Stop: parar a VM
-ServiceName	ServiceName	Sim	O nome do serviço Microsoft Azure em que existe a VM.
-Name	Nome	Sim	O nome da VM do Microsoft Azure.

XBAP Deployer

Essa ferramenta implanta um aplicativo XBAP. Ela é baseada em um executável de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-pn	ProjectName	Sim	O nome do projeto XBAP a ser implantado.
-d	Installation Path	Sim	O caminho de instalação para o aplicativo XBAP.
-ml		Não	O caminho completo do executável do utilitário mage. Se não definido, a ferramenta usará aquele fornecida como recurso na ferramenta.
-pl		Não	O caminho completo onde se encontra o projeto XBAP a ser implantado. Se não especificado, a ferramenta usará o local do pacote em que ele é executado.
-url		Não	Se especificado, o sistema substituirá a URL do arquivo setup.exe pelo valor especificado.
-cf		Não	Se especificado, será usado como o nome de certificação durante a atualização do manifesto.
-pwd		Não	Se especificado, será usado como a senha de certificação durante a atualização do manifesto.
-log		Não	Será gerado um arquivo de log com esse nome no diretório físico.

Utilitário de Linha de Comando Microsoft Test Manager (MTM)

Essa ferramenta cria e inicia os testes automatizados executados no MTM (Microsoft Test Manager). Ela é baseada em um script PowerShell de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./TcmExec.ps1.
-Title	TestRunTitle	Sim	O nome que será usado ao criar a execução do teste.
-PlanId	PlanId	Sim	O identificador do plano de teste no qual os testes devem ser executados (ID exclusiva conforme definida no Test Manager).
-SuiteId	SuiteId	Sim	O identificador do pacote que você deseja executar (ID exclusiva conforme definida no Test Manager).
-ConfigId	ConfigId	Sim	O identificador da configuração de teste no qual os testes devem ser executados (ID exclusiva conforme definida no Test Manager).
-Collection	TFSCollection	Sim	A URL da coleção do Team Foundation Server para a qual os testes automatizados serão executados.
-TeamProject	TeamProject	Sim	O nome do projeto de equipe no qual os testes automatizados foram configurados.
-TestEnvironment	TestEnvironment	Sim	O ambiente de teste no qual os testes serão executados (o ambiente de teste é associado a um controlador de teste correspondente).
-BuildDirectory	BuildDirectory	Não*	O local dos testes automatizados. No MTM 2010, esse parâmetro é necessário. No MTM 2012 e 2013, esse parâmetro ainda tem suporte, mas os usuários devem usar preferencialmente os parâmetros BuildDefinition e BuildNumber.
-BuildDefinition		Não*	Permite que o usuário especifique a definição de compilação na qual os testes automatizados são incluídos. Esse parâmetro só pode ser usado com o MTM 2012. Se definido, o parâmetro BuildNumber também deve ser especificado. Se não especificado, o campo "build" visível nos detalhes de uma execução de teste não será afetado pela execução.
-BuildNumber		Não*	Permite que o usuário especifique o número da compilação cujo local de destino conterá os testes automatizados. Esse parâmetro só pode ser usado no MTM 2012. Se definido, o parâmetro BuildDefinition também deve ser especificado. Se não especificado, o campo "build" visível nos detalhes de uma execução de teste não será afetado pela execução.
-SettingsName		Não	Permite que o usuário especifique as configurações a serem usadas na execução do teste. Se não especificado, as configurações de teste padrão serão usadas.
-TestRunWaitDelay		Não	Permite que o usuário especifique o atraso, em segundos, entre cada chamada para o controlador de testes. É necessário para permitir que a execução do teste termine antes de processar os resultados do teste. Se não especificado, o padrão será de 10 segundos.
-InconclusiveFailsTests	N/D	Não	Quando esse sinalizador é definido, a existência de testes inconclusivos prejudicará a implantação. Por padrão, um teste inconclusivo não prejudica a implantação.
-RemoveIncludeParameter	N/D	Não	Quando esse sinalizador é definido, o parâmetro /include não será acrescentado ao comando de criação de teste. Isso significa que os testes que têm um status diferente de Active não serão incluídos na execução do teste.

Se os testes automatizados forem incluídos no mesmo processo de compilação do aplicativo que está sendo implantado, será possível usar os metadados como o valor da variável e ele será substituído automaticamente no momento da liberação. Estes são os metadados disponíveis no momento que podem ser usados com variáveis de configuração.

Variável	Metadados do valor da variável
BuildDirectory	$(PackageLocation)
BuildNumber	$(BuildNumber)
BuildDefinition	$(BuildDefinition)
TFSCollection	$(TFSUrlWithCollection)
TeamProject	$(TeamProject)

INI File Manager

Essa ferramenta modifica o conteúdo de um arquivo .ini e pode criar um novo arquivo .ini, se especificado. Ela é baseada em um executável de gerenciamento de liberação personalizado. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-Action		Sim	Indica a ação a ser executada: ModifySection RemoveSection CreateKeyValue ModifyKeyValue RemoveKeyValue
-INIFile	INIFileName	Sim	O nome e o caminho do arquivo .ini (se necessários)
-SectionName	SectionName	Não	O nome da seção a ser afetada. Se não especificado, a seção raiz será considerada (todas as chaves que estão no início do arquivo antes da primeira seção serão consideradas na raiz).
-NewSectionName		Não	O nome da nova seção. Se não especificado, a seção raiz será considerada (todas as chaves que estão no início do arquivo antes da primeira seção serão consideradas na raiz). Necessário para a ação ModifySection.
-KeyName		Não	O nome da chave a ser afetada. Necessário para CreateKeyValue, ModifyKeyValue e RemoveKeyValue.
-KeyValue		Não	O valor a ser usado para a chave. Se usar a ação ModifyKeyValue e esse parâmetro não for especificado e o NewKeyName for especificado, o sistema usará o valor real. Se não especificado e o NewKeyName não for especificado, o valor será vazio.
-NewKeyName		Não	O novo nome para dar à chave. Usado somente na ação ModifyKeyValue.
-CreateFileIfNotExists		Não	Indica à ferramenta que um arquivo deve ser criado se ele não existir.

Processo do Windows

Essa ferramenta pode finalizar um processo do Windows. As variáveis de configuração dessa ferramenta são:

Parâmetro	Variável	Obrigatório	Descrição
-command	N/D	Sim	Valor fixo ./WindowsProcess.ps1.
-ProcessName		Sim	O nome do processo do Windows a ser eliminado.
-UserName		Não	A conta de usuário que está executando o processo. Se não especificado, o processo será encerrado para todos os usuários.
-IsKillProcessTree		Não	Sinalizador que indica se a árvore de processos deve ser eliminada. Valores permitidos são: 1: eliminar a árvore de processos 0 ou vazio: não eliminar a árvore de processos