Switch branches/tags
master releases/m95 releases/node0.8 releases/0.7 releases/0.8 releases/2.7.0 revert-261-users/nigurr/AddTelemetryFunction users/achalla/PublishTask users/brcrista/platform users/brcrista/strict-null-checks users/bryanmac/gendoc users/bryanmac/uncfix users/damccorm/fix-enum users/damccorm/issue-148 users/damccorm/issue-227 users/damccorm/issue-263 users/damccorm/issue-372 users/damccorm/issue-420 users/damccorm/sync-documentation users/damccorm/update-dependencies users/damccorm/update-docs users/damccorm/upgrade-typescript users/ersciple/extension users/ersciple/m100fixtest users/ersciple/m100positionmessage users/ersciple/m100setresultissue users/ersciple/m105boolinput users/ersciple/m105processinvoker users/ersciple/m106ino users/ersciple/m106minimatch users/ersciple/m107mkdirpstrings users/ersciple/m107strings users/ersciple/m116tsc users/ersciple/m117yaml users/ersciple/m119yaml users/ersciple/m120copyfiles users/ersciple/m120econnreset users/ersciple/m120npm users/ersciple/m120pslib users/ersciple/m121yaml users/ersciple/m122yml users/ersciple/m133pipe users/ersciple/m137norc users/ersciple/m142done users/ersciple/stepbystep users/kerobert/alertAboutBuffering users/kerobert/fixPoxyMocks users/madhurig/docs users/madhurig/securefiles users/nigurr/AddCodeToTaskResult users/nigurr/AddTelemetryFunction users/nigurr/FindFilesfunctionality users/nigurr/FixCommandString users/nigurr/UpdateTS users/philho/debugExecNotMocked users/philho/filterMocking users/philho/testImprovements users/stfrance/add-agent-version users/stfrance/casting-bug users/stfrance/cleanup users/stfrance/component-governance users/stfrance/fix-badges users/stfrance/increase-timeout users/stfrance/multiple-resource-files users/stfrance/timeout users/stfrance/timeout2 users/stfrance/update-release-notes users/stfrance/update-ts-add-strict users/tihuang/dotnettask
Nothing to show
Find file Copy path
306ddaa Nov 27, 2017
2 contributors

Users who have contributed to this file

@ericsciple @stephenmichaelf
66 lines (46 sloc) 1.68 KB

Minimum Agent Version

Property in task.json

The minimumAgentVersion property in the task.json is used for routing build/release jobs to agents that satisfy the minimum version demand.

Branching within your code

You can use the variable agent.version to check the agent version and branch within your code.

Agent features relevant to task authors

Use the details below to determine when specific agent features were added:


  • task.settaskvariable
    • Added in 2.115.0 (related to prejobexecution and postjobexecution handler sections)
  • task.prependpath
    • Added in 2.115.0

Task execution handler

  • General
    • prejobexecution and postjobexecution handler sections were added in 2.115.0
  • node handler
    • Added in 1.95.1. Used node v5.10.1.
    • Updated in 2.117.0 to use node v6.10.3.
  • powershell3 handler
    • Added in 1.95.1
    • Updated in 1.97 to propagate Data property for endpoints


  • Agent.TempDirectory
    • Added in 2.115.0
  • Agent.ToolsDirectory
    • Added in 2.115.0
  • Agent.Version
    • Added in 2.104.1

Agent version to TFS mapping

The following chart details the agent versions that shipped with each on-premises TFS release:

2.x agent

Agent TFS
2.122.1 TFS 2017 Update 3
2.117.x TFS 2017 Update 2
2.112.0 TFS 2017 Update 1
2.105.7 TFS 2017 RTM

Legacy 1.x Windows agent

Agent TFS
1.105.7 TFS 2017 RTM
1.95.4 TFS 2015 Update 4
1.95.3 TFS 2015 Update 3
1.95.1 TFS 2015 Update 2
1.89.1 TFS 2015 Update 1
1.83.2 TFS 2015 RTM