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.
# 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 - マシン
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 するパスを指定します。 パスが指定されていない場合は、 ダウンロード センターから自動的にダウンロードされます。 テスト エージェント 2015 Update 3 をインストールします。
テスト エージェント 2017 をインストールします。


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

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


タスク制御オプション

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

出力変数

[なし] :

解説

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

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

要件

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