CLI to manage work item admin tasks in Azure DevOps
- Open solution in Visual Studio and build the project.
- Open bin > release folder (or debug) to find witadmin.exe
- Run command line
adoadmin.exe - Add arguments below to run specific commands
adoadmin.exe /org:myorgname /pat:1461fe40a1074619b1b29438ad19c71b /action:listallfields
/org:{value} azure devops organization name
/pat:{value} personal access token
/action:{value} listallfields, getfield, addfield, listfieldsforprocess, allpicklists, picklistswithnofield, emptyrecyclebin
/refname:{value} refname of field getting or adding
/name:{value} field friendly name
/type:{value} type field creating
/days:{value} used with emptyrecyclebin and list-delete-plans action. Number of days in the past from today
listallfields lists all fields in the organization
getfield get a specific field by refname
addfield add a field
listfieldsforprocess list of fields in a process
searchfields search for a specific field by refname to see if it exists
getfieldforprojects list of projects and work item types the field is used in
allpicklists list all picklists and the field they are associated to
picklistswithnofield picklists that are not being used
list-delete-plans list out and delete (optional) delivery plans that have not been accessed in x number of days
adoadmin.exe /org:{organization name} /pat:{value} /action:listallfields
adoadmin.exe /org:{organization name} /pat:{value} /action:allpicklists
adoadmin.exe /org:{organization name} /pat:{value} /action:picklistswithnofield
adoadmin.exe /org:{organization name} /pat:{value} /action:listfieldsforprocess /process:Agile
adoadmin.exe /org:{organization name} /pat:{value} /action:getfield /refname:System.Title
Clean up Delivery Plans that have not been accessed over a number of days. This can be helpful when trying to stay under the 1,000 plan limit per project. We recommend deleting plans that have not had any activity in the last 3-6 months.
list-delete-plans list out and delete (optional) delivery plans that have not been accessed in x number of days
adoadmin.exe /org:{organization name} /pat:{value} /action:list-delete-plans /days:182
Used to delete work items forever out the recycle bin.
adoadmin.exe /org:{organization name} /pat:{value} /action:emptyrecyclebin /project:{project name} /days:0
Empty everything from the recycle bin
adoadmin.exe /org:{organization name} /pat:{value} /action:emptyrecyclebin /project:{project name} /days:0
Empty work items that have not been updated in the last 365 days
adoadmin.exe /org:{organization name} /pat:{value} /project:{project name} /days:365
Find all the tags that are not used and can be deleted.
adoadmin.exe /org:{organization name} /pat:{value} /action:listemptytags /project:{project name}
Delete a specific tag in a project.
adoadmin.exe /org:{organization name} /pat:{value} /action:deletetag /project:{project name} /name:{tag name}