Partager via


DeployVisualStudioTestAgent@2 - Tâche de déploiement de l’agent de test Visual Studio v2

Important

Cette tâche est déconseillée et sera mise hors service le 31 janvier 2024. Utilisez la tâche de test Visual Studio pour exécuter des tests unitaires et fonctionnels.

Important

DeployVisualStudioTestAgent@2 est déconseillé. Utilisez la tâche de test Visual Studio pour exécuter des tests unitaires et fonctionnels.

Syntax

# Visual Studio test agent deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.
# Visual Studio Test Agent Deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.

Entrées

testMachines - Machines
string. Obligatoire.

Cette entrée a trois options :

  • Fournit une liste séparée par des virgules des adresses IP ou des noms de domaine complets de l’ordinateur, ainsi que des ports. Le port par défaut est basé sur le protocole sélectionné. Par exemple : dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
  • Fournit la variable de sortie d’autres tâches. Par exemple : $(variableName).
  • Fournit un nom de groupe d’ordinateurs. Si vous utilisez HTTPS, le nom/l’adresse IP de l’ordinateur doit correspondre au nom commun sur le certificat.

adminUserName - connexion Administration
string. Obligatoire.

Spécifie la connexion administrateur pour les ordinateurs cibles.


adminPassword - mot de passe Administration
string. Obligatoire.

Spécifie le mot de passe administrateur pour les machines cibles. Cette entrée peut accepter une variable définie dans les définitions de build/mise en production en tant que $(passwordVariable). Vous pouvez marquer le type de variable comme secret pour le sécuriser.


winRmProtocol - Protocole
string. Obligatoire. Valeurs autorisées : Http, Https. Valeur par défaut : Http.

Spécifie le protocole à utiliser pour la connexion WinRM avec la ou les machines. La valeur par défaut est HTTPS.


testCertificate - Certificat de test
boolean. facultatif. Utilisez quand winRmProtocol = Https. Valeur par défaut : true.

Fournit la possibilité d’ignorer la validation d’authenticité du certificat de la machine par une autorité de certification approuvée. Le paramètre est requis pour le protocole HTTPS WinRM.


machineUserName - Nom d'utilisateur
string. Obligatoire.

Spécifie le nom d’utilisateur avec lequel l’agent de test doit s’exécuter.


machinePassword - Mot de passe
string. Obligatoire.

Spécifie le mot de passe du nom d’utilisateur indiqué ci-dessus.


runAsProcess - Exécuter des tests d’interface utilisateur
boolean. Valeur par défaut : false.

Indique si l’agent de test doit s’exécuter en tant que processus interactif. Cette entrée est nécessaire pour les tests codés de l’interface utilisateur.


isDataCollectionOnly - Activer la collecte de données uniquement
boolean. Valeur par défaut : false.

facultatif. Spécifie si l’agent de test est utilisé uniquement pour la collecte de données et non pour l’exécution de tests. Cela se trouve généralement sur l’application sous le groupe de machines de test (AUT).


testPlatform - Version de test de l’agent
string. Valeurs autorisées : 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015). Valeur par défaut : 14.0.

Spécifie la version de l’agent de test Visual Studio. Choisit une version appropriée pour correspondre à la version de VS à l’aide des fichiers binaires de test qui ont été générés.


agentLocation - Emplacement de l’agent de test
string.

facultatif. Fournit le chemin d’accès à vstf_testagent.exe à partir du réseau ou de l’emplacement local. Si aucun chemin d’accès n’est fourni, il est automatiquement téléchargé à partir du centre de téléchargement. Installez l’agent de test 2015 Update 3.
Installez l’agent de test 2017.


updateTestAgent - Mettre à jour l’agent de test
boolean. Valeur par défaut : false.

Si l’agent de test est déjà déployé sur un ordinateur, cette option vérifie si une mise à jour est disponible pour cette version.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Nouveautés de cette version de tâche :

  • Prise en charge de Visual Studio Test Agent 2017 : vous pouvez désormais déployer et exécuter des tests à l’aide de plusieurs versions de Visual Studio Test Agent. Les versions 2015 et 2017 sont prises en charge.
  • Les groupes d’ordinateurs créés à partir du hub de test ne sont plus pris en charge. Vous pouvez continuer à utiliser une liste de machines ou de groupes de ressources Azure.

Configuration requise

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent
Demandes None
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande Quelconque
Variables paramétrables Quelconque
Version de l’agent 2.0.0 ou version ultérieure
Catégorie de la tâche Test