Get Even More Visitors To Your Blog, Upgrade To A Business Listing >>

How to unconfigure TFS Build Agent Service

There may be times when you need to unconfigure, or remove a build Agent configured as a service  TFS 2015 and above and there are a few steps missing from the online documentation.


The steps to configure/unconfigure are located here

Open a Command Prompt in admin mode and navigate to the folder where the build agent is located and the ConfigureAgent.cmd file exists. There is a sub folder called agent and this contains vsoagent.exe, which is used to unconfigure the agent from TFS.

Enter command .agentvsoagent.exe /unconfigure

Check the Agent Pools tab in TFS to ensure the build agent is no longer appearing.


There are times when the VSO Agent will not uninstall correctly and a manually removal is required

Open the Services applet to view the list of build services and the name of the service starts with VSO Agent

List of Services


Run the following query from the command line to find the service names: SC QUERY state= all | FIND “VSO”


Right click on the Build Service to remove and select Properties

Highlight the Service Name and right click and select Copy


Open a Command Prompt in Admin mode

If the build is running: SC STOP vsoagent.localhost.BuildDude

Delete the service

SC DELETE vsoagent.localhost.BuildDude

Run the query to make sure the service is now gone:

SC QUERY state= all | FIND “VSO”

Note: You need to run the command prompt as an administrator, not just logged in as the administrator, but also with administrative rights. If you get errors above about not having the necessary access rights to stop and/or delete the service, run the command prompt as an administrator. You can do this by searching for the command prompt on your start menu and then right-clicking and selecting “Run as administrator”.


If you need to find the short service name of a service, use the following command to generate a text file containing a list of services and their statuses:

SC QUERY state= all | FIND “VSO” >”C:Service List.txt”

Share the post

How to unconfigure TFS Build Agent Service


Subscribe to Msdn Blogs | Get The Latest Information, Insights, Announcements, And News From Microsoft Experts And Developers In The Msdn Blogs.

Get updates delivered right to your inbox!

Thank you for your subscription