このタスクは、一連のマシンでテストを実行するようにテスト エージェントをデプロイして構成します。
重要
このタスクは非推奨です。 Visual Studio テスト タスク を使用して、単体テストと機能テストを実行します。
構文
# 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.
入力
testMachineGroup
-
マシン
string
。 必須。
この入力には、次の 3 つのオプションがあります。
- コンピューターの IP アドレスまたは FQDN のコンマ区切りの一覧とポートを提供します。 既定のポートは、選択したプロトコルに基づいています。 たとえば、
dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986
のようにします。 - 他のタスクの出力変数を提供します。 たとえば、
$(variableName)
のようにします。 - マシン グループ名を提供します。 HTTPS を使用している場合、コンピューターの名前/IP は証明書の CN と一致する必要があります。
adminUserName
-
管理者ログイン
string
。
ターゲット マシンの管理者ログインを指定します。
adminPassword
-
管理者パスワードの
string
。
ターゲット マシンの管理者パスワードを指定します。 この入力は、ビルド/リリース定義で定義された変数を $(passwordVariable)
として受け取ることができます。 変数の型は、セキュリティで保護するために secret
としてマークできます。
winRmProtocol
-
プロトコル
string
。 使用できる値: Http
、Https
。
コンピューターとの WinRM 接続に使用するプロトコルを指定します。 既定値は HTTPS
です。
testCertificate
-
テスト証明書の
boolean
。 任意
winRmProtocol = Https
するときに使用します。 既定値: true
.
信頼された証明機関によるマシンの証明書の信頼性検証をスキップするオプションを提供します。 このパラメーターは、WinRM HTTPS プロトコルに必要です。
によるマシンの選択を resourceFilteringMethod
- する
string
。 使用できる値: machineNames
(コンピューター名)、tags
。 既定値: machineNames
.
フィルター条件の testMachines
-
string
。
dbserver.fabrikam.com, dbserver_int.fabrikam.com, 192.168.12.34
などのマシンや Role:DB;OS:Win8.1
などのタグの一覧を提供します。 いずれかのタグを持つマシンを返します。 Azure リソース グループの場合は、マシン名の VM ホスト名を指定します。 既定では、[マシン] フィールドで表されるすべてのマシンにエージェントがデプロイされます。
machineUserName
-
ユーザー名の
string
。 必須。
テスト エージェントを実行する必要があるユーザー名を指定します。
machinePassword
-
パスワード
string
。 必須。
上記のユーザー名のパスワードを指定します。
対話型プロセスの runAsProcess
-
boolean
。 既定値: false
.
テスト エージェントを対話型プロセスとして実行する必要があるかどうかを示します。 この入力は、コード化された UI テストに必要です。
agentLocation
-
テスト エージェントの場所の
string
。
任意 ネットワークまたはローカルの場所から vstf_testagent.exe するパスを指定します。 パスが指定されていない場合は、ダウンロード センター からダウンロードされます。
テスト エージェントの更新 updateTestAgent
-
boolean
。 既定値: true
.
任意 テスト エージェントを更新する必要があるかどうかを指定します。
isDataCollectionOnly
-
データ収集のみを有効にする
boolean
。 既定値: false
.
任意 テスト エージェントがデータ収集にのみ使用され、テストの実行には使用されないかどうかを指定します。 これは通常、テスト (AUT) マシン グループの下のアプリケーションで見つけることができます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。