次の方法で共有


DeployVisualStudioTestAgent@1 - Visual Studio Test Agent Deployment v1 タスク

このタスクは、一連のマシンでテストを実行するようにテスト エージェントをデプロイして構成します。

重要

このタスクは非推奨です。 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。 使用できる値: HttpHttps

コンピューターとの 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) マシン グループの下のアプリケーションで見つけることができます。


タスク コントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。

出力変数

なし。

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
の需要 なし
機能の このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 どれでも
設定可能な変数 どれでも
エージェントのバージョン 1.104.0 以上
タスク カテゴリ テスト