次の方法で共有


DeployVisualStudioTestAgent@2 - Visual Studio テスト エージェントのデプロイ v2 タスク

重要

このタスクは非推奨となり、2024 年 1 月 31 日に廃止されます。 Visual Studio テスト タスク を使用して、単体テストと機能テストを実行します。

重要

DeployVisualStudioTestAgent@2は非推奨です。 Visual Studio テスト タスク を使用して、単体テストと機能テストを実行します。

構文

# 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.

入力

testMachines - Machines
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。 既定値: Http.

コンピューターとの WinRM 接続に使用するプロトコルを指定します。 既定値は HTTPS です。


testCertificate - テスト証明書の
boolean. 任意 winRmProtocol = Httpsするときに使用します。 既定値: true.

信頼された証明機関によるマシンの証明書の信頼性検証をスキップするオプションを提供します。 このパラメーターは、WinRM HTTPS プロトコルに必要です。


machineUserName - ユーザー名の
string. 必須。

テスト エージェントを実行する必要があるユーザー名を指定します。


machinePassword - パスワード
string. 必須。

上記のユーザー名のパスワードを指定します。


runAsProcess - UI テスト を実行する
boolean. 既定値: false.

テスト エージェントを対話型プロセスとして実行する必要があるかどうかを示します。 この入力は、コード化された UI テストに必要です。


isDataCollectionOnly - データ収集のみを有効にする
boolean. 既定値: false.

任意 テスト エージェントがデータ収集にのみ使用され、テストの実行には使用されないかどうかを指定します。 これは通常、テスト (AUT) マシン グループの下のアプリケーションで見つけることができます。


testPlatform - テスト エージェントのバージョン
string. 使用できる値: 15.0 (Visual Studio 2017)、14.0 (Visual Studio 2015)。 既定値: 14.0.

Visual Studio テスト エージェントのバージョンを指定します。 ビルドされたテスト バイナリを使用して、VS バージョンと一致する適切なバージョンを選択します。


agentLocation - テスト エージェントの場所の
string.

任意 ネットワークまたはローカルの場所から vstf_testagent.exe するパスを指定します。 パスが指定されていない場合は、ダウンロード センターから自動的にダウンロードされます。 Test Agent 2015 Update 3をインストールします。
Test Agent 2017をインストールします。


updateTestAgent - テスト エージェントの を更新する
boolean. 既定値: false.

テスト エージェントが既にマシンにデプロイされている場合、このオプションは、そのバージョンで更新プログラムが利用可能かどうかを確認します。


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

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

出力変数

なし。

注釈

このタスク バージョンの新機能:

  • Visual Studio Test Agent 2017 のサポート: 複数のバージョンの Visual Studio テスト エージェントを使用してテストをデプロイおよび実行できるようになりました。 バージョン 2015 と 2017 がサポートされています。
  • テスト ハブから作成されたマシン グループはサポートされなくなりました。 マシンまたは Azure リソース グループの一覧を引き続き使用できます。

必要条件

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