DeployVisualStudioTestAgent@1 – Visual Studio Test Agent Deployment v1-Aufgabe

Artikel
03/24/2025

Mit dieser Aufgabe wird der Test-Agent bereitgestellt und konfiguriert, um Tests auf einer Reihe von Computern auszuführen.

Wichtig

Diese Aufgabe ist veraltet. Verwenden Sie die Visual Studio Test-Aufgabe, um Komponenten- und Funktionstests auszuführen.

Syntax

# Visual Studio Test Agent Deployment v1
# Deploy and configure Test Agent to run tests on a set of machines.
- task: DeployVisualStudioTestAgent@1
  inputs:
  # Test Machine Group
    testMachineGroup: # string. Required. Machines. 
    #adminUserName: # string. Admin Login. 
    #adminPassword: # string. Admin Password. 
    #winRmProtocol: # 'Http' | 'Https'. Protocol. 
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
    #resourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #testMachines: # string. Filter Criteria. 
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Interactive Process. Default: false.
  # Advanced
    #agentLocation: # string. Test Agent Location. 
    #updateTestAgent: true # boolean. Update Test Agent. Default: true.
    #isDataCollectionOnly: false # boolean. Enable Data Collection Only. Default: false.

Eingänge

testMachineGroup - Computer
string. Erforderlich.

Diese Eingabe hat drei Optionen:

Stellt eine durch Trennzeichen getrennte Liste von Computer-IP-Adressen oder FQDNs zusammen mit Ports bereit. Der Standardport basiert auf dem ausgewählten Protokoll. Beispiel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
Stellt die Ausgabevariable anderer Aufgaben bereit. Beispiel: $(variableName).
Stellt einen Computergruppennamen bereit. Wenn Sie HTTPS verwenden, sollte der Name/die IP des Computers mit dem CN des Zertifikats übereinstimmen.

adminUserName - Administratoranmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.

adminPassword - Administratorkennwort
string.

Gibt das Administratorkennwort für die Zielcomputer an. Diese Eingabe kann eine variable akzeptieren, die in Build-/Releasedefinitionen als $(passwordVariable)definiert ist. Sie können den Variablentyp als secret markieren, um ihn zu sichern.

winRmProtocol - Protokoll-
string. Zulässige Werte: Http, Https.

Gibt das Protokoll an, das für die WinRM-Verbindung mit den Computern verwendet werden soll. Der Standardwert ist HTTPS.

testCertificate - Testzertifikat
boolean. Wahlfrei. Wird verwendet, wenn winRmProtocol = Https. Standardwert: true.

Bietet die Möglichkeit, die Echtheitsüberprüfung des Zertifikats des Computers durch eine vertrauenswürdige Zertifizierungsstelle zu überspringen. Der Parameter ist für das WinRM HTTPS-Protokoll erforderlich.

resourceFilteringMethod - Computer nach auswählen
string. Zulässige Werte: machineNames (Computernamen), tags. Standardwert: machineNames.

testMachines - Filterkriterien
string.

Stellt eine Liste von Computern wie dbserver.fabrikam.com, dbserver_int.fabrikam.com, 192.168.12.34 oder Tags wie Role:DB;OS:Win8.1bereit. Gibt Computer zurück, die über eines der Tags verfügen. Geben Sie für die Azure-Ressourcengruppe den VM-Hostnamen für den Computernamen an. Der Standardwert stellt einen Agent auf allen Computern bereit, die im Feld "Computer" dargestellt sind.

machineUserName - Benutzername
string. Erforderlich.

Gibt den Benutzernamen an, mit dem der Test-Agent ausgeführt werden muss.

machinePassword - Kennwort
string. Erforderlich.

Gibt das Kennwort für den oben angegebenen Benutzernamen an.

runAsProcess - Interaktiver Prozess
boolean. Standardwert: false.

Gibt an, ob der Test-Agent als interaktiver Prozess ausgeführt werden muss. Diese Eingabe ist für Codierte UI-Tests erforderlich.

agentLocation - Test-Agent-Standort
string.

Wahlfrei. Stellt den Pfad zum vstf_testagent.exe aus dem Netzwerk oder dem lokalen Standort bereit. Wenn kein Pfad angegeben wird, wird er aus download Centerheruntergeladen.

updateTestAgent - Updatetest-Agent-
boolean. Standardwert: true.

Wahlfrei. Gibt an, ob der Test-Agent aktualisiert werden muss.

isDataCollectionOnly - Nur aktivieren
boolean. Standardwert: false.

Wahlfrei. Gibt an, ob der Test-Agent nur für die Datensammlung und nicht für die Ausführung von Tests verwendet wird. Dies kann in der Regel in der Anwendung unter der Computergruppe "Test" (AUT) gefunden werden.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.104.0 oder höher
Vorgangskategorie	Testen

Teilen über