Partager via


Outils de Release Management pour déployer une application

Chaque action de version utilise un outil de gestion des versions. Par exemple, Exécuteur de la ligne de commande est un outil qui exécute un exécutable spécifique pour une action. Si vous avez besoin d'effectuer une tâche que les outils fournis ne prennent pas en charge, vous pouvez créer votre propre outil personnalisé et l'ajouter à une action de version personnalisée. Les outils peuvent également être utilisés pour déployer un composant de votre application.

Voici une liste des outils et de leurs paramètres qui sont fournis avec Release Management :

Agent déploiement base données – Exécuter script

Cet outil exécute une requête SQL dans une base de données spécifique. Il est basé sur un exécutable sqlcmd standard distribué avec SQL Server. Pour plus d'informations sur cet exécutable, consultez la documentation sqlcmd. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-S

ServerName

Oui

Nom du serveur de la base de données SQL.

-i

ScriptName

Oui

Nom du script à exécuter.

-b

N/A

Non

Ce paramètre est un commutateur. S'il est présent, cela signifie que, si une erreur se produit, le lot sera abandonné.

Agent de déploiement Reporting Services

Cet outil déploie les rapports Reporting Services et les objets associés. Il est basé sur un exécutable personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-s

serverUrl

Oui

URL complète du serveur Reporting Services.

-l

itemLocation

Oui, si plusieurs éléments

Emplacement des éléments. S'il est spécifié, le dossier doit être fourni (-f).

-f

folder

Oui, si plusieurs éléments

Dossier des éléments. S'il est spécifié, l'emplacement des éléments doit être fourni (-l).

-t

Oui

Type des éléments à traiter. Les valeurs autorisées sont :

  • Rapport

  • Picture

-sp

Non

Répertoriez les modèles de recherche à utiliser pour filtrer les éléments. Chaque modèle de recherche doit être séparé par des virgules ou des points-virgules (par exemple, *.bmp;*.jpg). S'il n'est pas spécifié, le modèle de recherche sera le modèle suivant en fonction du type d'éléments sélectionnés (-t) :

  • Rapport : *.rdl

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

-i

Oui, si éléments uniques

Fichier d'éléments. S'il est spécifié, le nom des éléments doit être fourni (-n). Ce paramètre est utilisé lorsqu'un élément unique doit être déployé. Si c'est le cas, l'emplacement des éléments (-l) et les paramètres du dossier (-f) ne doivent pas être présents.

-n

Oui, si éléments uniques

Nom des éléments. S'il est spécifié, le fichier des éléments doit être fourni (-i). Ce paramètre est utilisé lorsqu'un élément unique doit être déployé. Si c'est le cas, l'emplacement des éléments (-l) et les paramètres du dossier (-f) ne doivent pas être présents.

-log

Non

Un fichier journal avec ce nom spécifié sera généré dans le répertoire physique.

-o

N/A

Non

Ce paramètre est un commutateur. S'il est présent, cela signifie que, la destination sera remplacée si elle existe déjà.

-ds ds1,...,dsN

Nom qualifié complet séparé par des virgules de toutes les sources de données à associer à l'élément. Celles-ci respectent la casse. Cette option s'applique uniquement aux rapports. La source de données peut être au format [nom:] référence. Le nom est celui de la source de données, tel que spécifié dans le rapport où les références sont à remplacer. La référence est la référence qualifiée complète à la source de données dans le serveur cible à utiliser pour le rapport.

Agent de déploiement MSI

Cet outil déploie un MSI. Il désinstalle l'installation précédente du produit avant d'installer la nouvelle. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./msiexec.ps1.

-MsiFileName

Installer

Oui

Chemin d'accès complet (si nécessaire) et nom du fichier .msi à installer.

-MsiCustomArgs

MsiCustomArgs

Non

Arguments personnalisés à utiliser pour installer le fichier .msi. Ces arguments seront passés directement à l'exécutable msiexec. Si aucun argument personnalisé n'est requis, le paramètre devra être supprimé des arguments.

-PrevProductName

Non

Permet à l'utilisateur de spécifier le nom du produit précédent à désinstaller avant l'installation du fichier .msi. Par défaut, le système utilisera le nom du produit dans le fichier .msi à installer.

Agent de déploiement XCopy

Cet outil copie un emplacement de package vers une destination spécifique. Il est basé sur un script personnalisé de commandes par lot de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-source

N/A

Oui

Valeur fixe indiquant que tous les emplacements sources doivent être copiés

-destination

Chemin d'installation

Oui

Destination de la copie.

Exécuteur de la ligne de commande

Cet outil exécute un exécutable spécifique. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-file

N/A

Oui

Valeur fixe ./RunCommandLine.ps1.

-FilePath

FilePath

Oui

Chemin d'accès complet (si nécessaire) et nom de fichier de l'exécutable à exécuter.

-Arguments

Arguments

Non

Arguments requis lorsque l'exécutable est exécuté.

-UserDomain

UserDomain

Non

Domaine de l'utilisateur à utiliser si l'exécutable doit être exécuté avec une identité spécifique. Si celui-ci n'est pas fourni, l'utilisateur local sera utilisé (. \localuser).

-UserName

UserName

Non

Nom de l'utilisateur à utiliser si l'exécutable doit être exécuté avec une identité spécifique.

-UserPassword

UserPassword

Non

Mot de passe de l'utilisateur à utiliser si l'exécutable doit être exécuté avec une identité spécifique.

Gestionnaire du Registre Windows

Cet outil manipule les informations du Registre Windows. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./ManageWindowsRegistry.ps1.

-Action

Action

Oui

Action à effectuer. Les valeurs autorisées sont :

  • CreateKey : créer une clé de Registre

  • ModifyKey : modifier une clé de Registre ou ses données

  • DeleteKey : supprimer une clé de Registre avec toutes ses valeurs et sous-clés

  • CreateValue : créer une valeur de Registre située sous une clé

  • ModifyValue : modifier une valeur de Registre située sous une clé

  • DeleteValue : supprimer une valeur de Registre située sous une clé

-OperatingSystemType

Non

Indique si la clé / valeur est accessible dans le Registre 32 bits ou 64 bits. S'il n'est pas fourni, la valeur par défaut est 32 bits.

-RegistryKey

RegistryKey

Oui

Chemin d'accès et nom de la clé de Registre (par exemple, HKLM\Software\MyKey).

-RegistryValue

Non*

Valeur de Registre à laquelle les modifications seront appliquées (par exemple, MyValue). Requise pour CreateValue, ModifyValue et DeleteValue.

-ValueType

Non

Type de la valeur affectée. Les valeurs acceptées sont :

  • REG_SZ : chaîne (valeur par défaut si elle n'est pas spécifiée)

  • REG_QWORD_LITTLE_ENDIAN : entier 64 bits au format avec primauté des octets de poids faible (Little endian)

  • REG_QWORD : entier 64 bits

  • REG_NONE : aucune valeur

  • REG_MULTI_SZ : chaîne multiligne (séparée par \0)

  • REG_LINK : lien symbolique

  • REG_EXPAND_SZ : chaîne avec des références aux variables d'environnement non développées

  • REG_DWORD_BIG_ENDIAN : entier 32 bits au format avec primauté des octets de poids fort (Big endian)

  • REG_DWORD_LITTLE_ENDIAN : entier 32 bits au format avec primauté des octets de poids faible (Little endian)

  • REG_DWORD : entier 32 bits

  • REG_BINARY : données binaires sous n'importe quelle forme

-RegistryData

Non

Données à appliquer à la valeur (si utilisation de CreateValue ou ModifyValue) ou à la valeur par défaut de la clé (si utilisation de CreateKey ou ModifyKey).

-RegistryKeyDestination

Non*

Nom de la clé de Registre à utiliser lors de l'utilisation de l'action ModifyKey pour renommer une clé de Registre. Par exemple :

  • RegistryKey = HKLM\Software\MyKey

  • RegistryKeyDestination = HKLM\Software\MyModifiedKey requise pour ModifyKey.

E/S Windows courantes

Cet outil effectue des e/s courantes sous Windows. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./ManageWindowsIO.ps1.

-Action

Action

Oui

Indique l'action à effectuer :

  • Créer : créer un dossier

  • Supprimer : supprimer des fichiers ou un dossier

  • Renommer : renommer un fichier ou un dossier

  • Déplacer : déplacer un fichier ou un dossier

  • Attrib : modifier les attributs (y compris la propriété) des fichiers ou du dossier

-FileFolderName

FileFolderName

Oui

Chemin d'accès et nom du fichier ou du dossier.

-DestinationName

Non*

Nom de destination (pour l'action de changement de nom) ou chemin d'accès et nom (pour l'action de déplacement). Obligatoire pour les actions de changement de nom et de déplacement.

-ReadOnly

Non

Permet à l'utilisateur de définir ou de réinitialiser l'attribut de lecture seule des fichiers ou du dossier.

  • + : définir l'indicateur

  • - : réinitialiser l'indicateur

  • Toute autre valeur : laisser l'indicateur tel quel

-Archive

Non

Permet à l'utilisateur de définir ou de réinitialiser l'attribut d'archivage des fichiers ou du dossier.

  • + : définir l'indicateur

  • - : réinitialiser l'indicateur

  • Toute autre valeur : laisser l'indicateur tel quel

-System

Non

Permet à l'utilisateur de définir ou de réinitialiser l'attribut système des fichiers ou du dossier.

  • + : définir l'indicateur

  • - : réinitialiser l'indicateur

  • Toute autre valeur : laisser l'indicateur tel quel

-Hidden

Non

Permet à l'utilisateur de définir ou de réinitialiser l'attribut caché des fichiers ou du dossier.

  • + : définir l'indicateur

  • - : réinitialiser l'indicateur

  • Toute autre valeur : laisser l'indicateur tel quel

-OwnerDomain

Non

Représente le domaine du nouveau propriétaire du fichier ou du dossier.

-OwnerName

Non

Représente le nom du nouveau propriétaire du fichier ou du dossier.

Gestionnaire des services Windows

Cet outil gère les services Windows. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./ManageWindowsServices.ps1.

-Action

Action

Oui

Indique l'action à effectuer :

  • Créer : créer un service

  • Config : configurer un service existant

  • Supprimer : supprimer un service existant

  • Démarrer : démarrer un service

  • Arrêter : arrêter un service

  • Redémarrer : arrêter et redémarrer le service

-ServiceName

ServiceName

Oui

Nom du service.

-ServerName

Non

Nom du serveur sur lequel cette action sera effectuée. S'il n'est pas spécifié, le serveur actuel sera utilisé.

-BinPath

Non*

Chemin d'accès et nom binaires du service. Requis pour l'action de création, facultatifs pour l'action de configuration et ignorés pour toutes les autres.

-DisplayName

Non

Nom complet qui sera utilisé pour ce service. Facultatif pour les actions de création et de configuration et ignoré pour toutes les autres.

-Description

Non

Description qui sera donnée au service. Facultatif pour les actions de création et de configuration et ignoré pour toutes les autres.

-UserName

Non

Nom d'utilisateur qui sera utilisé pour les informations d'identification servant à démarrer le service (doivent être sous la forme DOMAINE\UTILISATEUR). Si celui-ci est fourni, le paramètre Mot de passe doit être également fourni. Si celui-ci n'est pas fourni, le compte LocalSystem sera utilisé par défaut. Facultatif pour les actions de création et de configuration et ignoré pour toutes les autres.

Pour réinitialiser les informations d'identification sur LocalSystem, entrez LocalSystem pour l'utilisateur et "" pour le mot de passe.

-Password

Non

Mot de passe du nom d'utilisateur spécifié pour démarrer le service. Facultatif pour les actions de création et de configuration et ignoré pour toutes les autres.

-StartMode

Non

Mode de démarrage du service. Par défaut, le service sera créé avec le mode automatique. Les choix sont les suivants :

  • Manuel : le service est démarré uniquement manuellement

  • Automatique : le service sera démarré automatiquement au prochain démarrage de l'ordinateur

  • Désactivé : le service est désactivé

Facultatif pour les actions de création et de configuration et ignoré pour toutes les autres.

Agent de déploiement d'une base de données DACPAC

Cet outil déploie un package DACPAC. Il est basé sur un utilitaire de ligne de commande SQL Server. Il existe beaucoup de paramètres possibles pour cet exécutable, mais ceci est la liste des paramètres utilisés pour cet outil. Reportez-vous à la page sur l'Utilitaire en ligne de commande de package SQL pour plus d'informations. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

/Action:

Oui

Valeur fixe : publier – indique que le package sera publié.

/SourceFile:

FileName

Oui

Chemin d'accès complet (si nécessaire) et nom de fichier du DACPAC.

/TargetServerName:

ServerName

Oui

Le nom du serveur SQL Server sur lequel publier le package.

/TargetDatabaseName:

DatabaseName

Oui

Nom de la base de données SQL Server sur laquelle publier le package.

Agent de déploiement IIS

Cet outil manipule les paramètres et objets IIS. Il est basé sur un exécutable personnalisé de gestion des versions. Les variables de configuration de cet outil varient selon le type d'actions à effectuer.

Pour les actions des pools d'applications :

Paramètre

Variable

Obligatoire

Description

-Action

Oui

Indique l'action à effectuer :

  • CreateApplicationPool

  • ConfigureApplicationPool

  • DropApplicationPool

  • StartApplicationPool

  • StopApplicationPool

  • RecycleApplicationPool

-ap

Oui

Nom du pool d'applications.

-apAllow32Bit

Non

Indicateur qui spécifie si le pool d'applications doit autoriser les applications 32 bits. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. Les valeurs autorisées sont :

  • 1 ou True : les applications 32 bits sont autorisées

  • 0 ou False : les applications 32 bits ne sont pas autorisées

-apIdentUserDomain

Non

Domaine de l'utilisateur à utiliser comme identité du pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. S'il n'est pas défini et que le paramètre IdentityUserName est défini, l'utilisateur est considéré comme un utilisateur local (. \localuser).

-apIdentUserName

Non

Nom d'utilisateur à utiliser comme identité du pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. S'il n'est pas défini, les paramètres IdentityUserDomain et IdentityUserPassword seront ignorés et la valeur par défaut d'IIS sera utilisée (ApplicationPoolIdentity).

-apIdentUserPassword

Non

Mot de passe de l'utilisateur à utiliser comme identité du pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5.

-apNetVers

Non

Version .NET Framework à utiliser pour le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. Les valeurs autorisées sont : v1.0, v1.1, v2.0 et v4.0

-apPipelineMode

Non

Mode pipeline géré à utiliser dans le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. Les valeurs autorisées sont :

  • Classic

  • Integrated

-apProcessIdleTimeout

Non

Nombre de minutes pendant lequel un processus peut être inactif dans le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5.

-apRecycleKbMemory

Non

Nombre maximal de Ko de mémoire qui sera utilisé avant le recyclage du pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5.

-apRecycleMinutes

Non

Nombre de minutes fixé avant le recyclage du pool d'applications. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5.

- apRecycleSpecificTime

Non

Moment fixé auquel le pool d'applications est recyclé. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. Le format requis est HH:MM (par exemple 23:58 ou 01:23).

-apStartMode

Non

Mode de démarrage à utiliser pour le pool d'applications. Ce paramètre est autorisé uniquement pour IIS 8.0 et 8.5. Les valeurs autorisées sont :

  • OnDemand

  • AlwaysRunning

-AutoStart

Non

Indicateur qui spécifie si le pool d'applications doit être démarré automatiquement. Ce paramètre est autorisé uniquement pour IIS 7.0, 7.5, 8.0 et 8.5. Les valeurs autorisées sont :

  • 1 ou True : le pool d'applications sera démarré automatiquement au démarrage de Windows.

  • 0 ou False : le pool d'applications ne sera pas démarré automatiquement au démarrage de Windows.

-log

Non

Pour les actions de sites Web :

Paramètre

Variable

Obligatoire

Description

-Action

Oui

Indique l'action à effectuer :

  • CreateWebSite

  • ConfigureWebSite

  • DropWebSite

  • StartWebSite

  • StopWebSite

  • RestartWebSite

-sn

Oui

Nom du site web.

-port

Non*

Numéro de port du site web. Obligatoire pour une action de création et facultatif pour une action de configuration.

-pd

Non*

Routage de chemin d'accès complet vers l'emplacement où l'application a été publiée. Obligatoire pour une action de création et facultatif pour une action de configuration.

RemarqueRemarque
Assurez-vous qu'il n'y a aucune barre oblique finale dans le chemin d'accès.

-ap

Non

Nom du pool d'applications. S'il n'est pas défini lors de la création d'un pool d'applications, le pool d'applications par défaut sera utilisé. Facultatif pour les actions de création et de configuration.

-EnablePreload

Non

Autorisé pour IIS 7.0, 7.5, 8.0 et 8.5. Indicateur qui spécifie si le site web doit être préchargé. Facultatif pour les actions de création et de configuration. Les valeurs autorisées sont :

  • 1 ou True : le préchargement est activé

  • 0 ou False : le préchargement est désactivé

-AutoStart

Non

Autorisé pour IIS 7.0, 7.5, 8.0 et 8.5. Indicateur qui spécifie si le site web doit être démarré automatiquement. Facultatif pour les actions de création et de configuration. Les valeurs autorisées sont :

  • 1 ou True : démarrer automatiquement

  • 0 ou False : ne pas démarrer automatiquement

-log

Non

Un fichier journal avec ce nom spécifié sera généré dans le répertoire physique.

Pour les actions des applications web :

Paramètre

Variable

Obligatoire

Description

-Action

Oui

Indique l'action à effectuer :

  • CreateWebApplication

  • ConfigureWebApplication

  • DropWebApplication

-ws

Oui

Nom de l'application à créer.

-pd

Non*

Routage de chemin d'accès complet vers l'emplacement où l'application a été publiée. Obligatoire pour une action de création et facultatif pour une action de configuration.

-sn

Non

Nom du site web. S'il n'est pas spécifié, le système utilisera le site web par défaut lors de la création d'une application. Facultatif pour les actions de création et de configuration.

-ap

Non

Nom du pool d'applications. S'il n'est pas défini lors de la création d'un pool d'applications, le pool d'applications par défaut sera utilisé. Facultatif pour les actions de création et de configuration.

-EnablePreload

Non

Autorisé pour IIS 7.0, 7.5, 8.0 et 8.5. Indicateur qui spécifie si le site web doit être préchargé. Facultatif pour les actions de création et de configuration. Les valeurs autorisées sont :

  • 1 ou True : le préchargement est activé

  • 0 ou False : le préchargement est désactivé

-log

Non

Un fichier journal avec ce nom sera généré dans le répertoire physique.

Pour les actions de répertoires virtuels :

Paramètre

Variable

Obligatoire

Description

-Action

Oui

Indique l'action à effectuer :

  • CreateVirtualDirectory

  • ConfigureVirtualDirectory

  • DropVirtualDirectory

-vd

Oui

Nom du répertoire virtuel.

-pd

Non*

Le chemin d'accès complet du répertoire virtuel. Obligatoire pour une action de création et facultatif pour une action de configuration.

-sn

Non

Nom du site web. S'il n'est pas spécifié, le système utilisera le site web par défaut lors de la création d'une application. Facultatif pour les actions de création et de configuration.

-ws

Non

Nom de l'application web. S'il n'est pas spécifié, le système utilisera l'application web racine lors de la création d'un répertoire virtuel. Facultatif pour les actions de création et de configuration.

-log

Non

Un fichier journal avec ce nom sera généré dans le répertoire physique.

Gestionnaire de machines virtuelles Microsoft Azure

Cet outil gère une machine virtuelle dans Microsoft Azure. Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./ControlAzureVM.ps1.

-Command

Oui

Indique l'action à effectuer :

  • Démarrer : démarrer l'ordinateur virtuel

  • Arrêter : arrêter l'ordinateur virtuel

-ServiceName

ServiceName

Oui

Nom du service Microsoft Azure dans lequel la machine virtuelle existe.

-Name

Nom

Oui

Nom de la machine virtuelle Microsoft Azure.

Système de déploiement XBAP

Cet outil déploie une application XBAP. Il est basé sur un exécutable personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-pn

NomProjet

Oui

Nom du projet XBAP à déployer.

-d

Chemin d'installation

Oui

Chemin d'accès de l'installation de l'application XBAP.

-ml

Non

Chemin d'accès complet à l'exécutable de l'utilitaire mage. S'il n'est pas défini, l'outil utilisera celui fourni en tant que ressource dans l'outil.

-pl

Non

Chemin d'accès complet de l'emplacement où se trouve le projet XBAP à déployer. S'il n'est pas spécifié, l'outil utilisera l'emplacement du package où il est exécuté.

-url

Non

S'il est spécifié, le système remplacera l'URL du fichier setup.exe par celui qui est spécifié.

-cf

Non

S'il est spécifié, celui-ci sera utilisé comme nom de certification lors de la mise à jour du manifeste.

-pwd

Non

S'il est spécifié, celui-ci sera utilisé comme mot de passe de certification lors de la mise à jour du manifeste.

-log

Non

Un fichier journal avec ce nom sera généré dans le répertoire physique.

Utilitaire de ligne de commande Microsoft Test Manager (MTM)

Cet outil crée et lance des tests automatisés sur MTM (Microsoft Test Manager). Il est basé sur un script PowerShell personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./TcmExec.ps1.

-Title

TestRunTitle

Oui

Nom qui sera utilisé lors de la création de la série de tests.

-PlanId

PlanId

Oui

Identificateur du plan de test sous lequel les tests doivent s'exécuter (ID unique comme défini dans Test Manager).

-SuiteId

SuiteId

Oui

Identificateur de la Suite que vous souhaitez exécuter (ID Unique tel que défini dans Test Manager).

-ConfigId

ConfigId

Oui

Identificateur de la configuration de test sous lequel les tests doivent s'exécuter (ID unique comme défini dans Test Manager).

-Collection

TFSCollection

Oui

URL de la collection du serveur Team Foundation Server pour laquelle les tests automatisés s'exécuteront.

-TeamProject

TeamProject

Oui

Nom du projet d'équipe dans lequel les tests automatisés ont été configurés.

-TestEnvironment

TestEnvironment

Oui

Environnement de test dans lequel les tests doivent être exécutés (l'environnement de test est associé au Contrôleur de test correspondant).

-BuildDirectory

BuildDirectory

Non*

Emplacement des tests automatisés. Dans MTM 2010, ce paramètre est requis. Dans MTM 2012 et 2013, ce paramètre est toujours pris en charge, mais les utilisateurs préfèrent utiliser les paramètres BuildDefinition et BuildNumber.

-BuildDefinition

Non*

Permet à l'utilisateur de spécifier la définition de build dans laquelle les tests automatisés sont inclus. Ce paramètre peut uniquement être utilisé avec MTM 2012. S'il est défini, le paramètre BuildNumber doit également être spécifié. S'il n'est pas spécifié, le champ « build » visible dans les détails d'une série de tests ne sera pas affecté par la série de tests.

-BuildNumber

Non*

Permet à l'utilisateur de spécifier un numéro de build dont l'emplacement cible contiendra les tests automatisés. Ce paramètre peut uniquement être utilisé sous MTM 2012. S'il est défini, le paramètre BuildDefinition doit également être spécifié. S'il n'est pas spécifié, le champ « build » visible dans les détails d'une série de tests ne sera pas affecté par la série de tests.

-SettingsName

Non

Permet à l'utilisateur de spécifier les paramètres à utiliser pour la série de tests. S'ils ne sont pas spécifiés, les paramètres de test par défaut seront utilisés.

-TestRunWaitDelay

Non

Permet à l'utilisateur de spécifier le délai, en secondes, entre chaque appel au Contrôleur de test. Celui-ci est requis pour permettre à la série de tests de se terminer avant le traitement des résultats des tests. S'il n'est pas spécifié, la valeur par défaut sera 10 secondes.

-InconclusiveFailsTests

N/A

Non

Lorsque cet indicateur est défini, l'existence de tests non concluants fera échouer le déploiement. Par défaut, un test non concluant ne fera pas échouer le déploiement.

-RemoveIncludeParameter

N/A

Non

Lorsque cet indicateur est défini, le paramètre /include ne sera pas ajouté à la commande de création de tests. Ceci signifie que tous les tests avec un état autre qu'Actif ne seront pas inclus dans la série de tests.

Si les test automatisés sont inclus dans le même processus de build que celui de l'application en cours de déploiement, il est possible d'utiliser les métadonnées comme valeur de variable et celle-ci sera automatiquement remplacée au moment de la publication. Les métadonnées actuellement disponibles qui peuvent être utilisées avec les variables de configuration sont les suivantes :

Variable

Métadonnées valeurs de variable

BuildDirectory

$(PackageLocation)

BuildNumber

$(BuildNumber)

BuildDefinition

$(BuildDefinition)

TFSCollection

$(TFSUrlWithCollection)

TeamProject

$(TeamProject)

Gestionnaire du fichiers INI

Cet outil modifie le contenu d'un fichier .ini et peut créer un fichier .ini s'il est spécifié. Il est basé sur un exécutable personnalisé de gestion des versions. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-Action

Oui

Indique l'action à effectuer :

  • ModifySection

  • RemoveSection

  • CreateKeyValue

  • ModifyKeyValue

  • RemoveKeyValue

-INIFile

INIFileName

Oui

Nom et chemin d'accès du fichier .ini (si nécessaire)

-SectionName

SectionName

Non

Nom de section à affecter. S'il n'est pas spécifié, la section racine sera prise en compte (toutes les clés se trouvant au début du fichier avant la première section sont prises en compte dans la racine).

-NewSectionName

Non

Nouveau nom de la section. S'il n'est pas spécifié, la section racine sera prise en compte (toutes les clés se trouvant au début du fichier avant la première section sont prises en compte dans la racine). Requis pour l'action ModifySection.

-KeyName

Non

Nom de la clé à affecter. Requis pour CreateKeyValue, ModifyKeyValue et RemoveKeyValue.

-KeyValue

Non

Valeur à utiliser pour la clé. Lors de l'utilisation de l'action ModifyKeyValue, si le paramètre n'est pas spécifié et que NewKeyName est spécifié, le système utilisera la valeur réelle. S'il n'est pas spécifié et que NewKeyName n'est pas spécifié, la valeur sera vide.

-NewKeyName

Non

Nouveau nom à donner à la clé. Utilisé uniquement dans l'action ModifyKeyValue.

-CreateFileIfNotExists

Non

Indique à l'outil qu'un fichier doit être créé s'il n'existe pas.

Processus Windows

Cet outil peut supprimer un processus Windows. Les variables de configuration de cet outil sont :

Paramètre

Variable

Obligatoire

Description

-command

N/A

Oui

Valeur fixe ./WindowsProcess.ps1.

-ProcessName

Oui

Nom du processus Windows à terminer.

-UserName

Non

Compte d'utilisateur exécutant le processus. S'il n'est pas spécifié, le processus sera terminé pour tous les utilisateurs.

-IsKillProcessTree

Non

Indicateur qui signale si l'arborescence des processus doit être supprimée. Les valeurs autorisées sont :

  • 1 : terminer l'arborescence des processus

  • 0 ou vide : ne pas terminer l'arborescence des processus