次の方法で共有

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. 使用できる値: 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) マシン グループの下のアプリケーションで確認できます。


タスク制御オプション

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

出力変数

[なし] :

必要条件

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