https://github.com/danhellem/azure-devops-admin-cli
cli to help manage specific admin tasks in azure devops
https://github.com/danhellem/azure-devops-admin-cli
azure-devops cli devops
Last synced: 4 months ago
JSON representation
cli to help manage specific admin tasks in azure devops
- Host: GitHub
- URL: https://github.com/danhellem/azure-devops-admin-cli
- Owner: danhellem
- License: mit
- Created: 2019-02-06T20:10:17.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-05T20:17:58.000Z (over 1 year ago)
- Last Synced: 2024-04-28T01:58:47.051Z (about 1 year ago)
- Topics: azure-devops, cli, devops
- Language: C#
- Homepage:
- Size: 140 KB
- Stars: 10
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# azure-devops-admin-cli
CLI to manage work item admin tasks in Azure DevOps
## Building and running
1. Open solution in Visual Studio and build the project.
2. Open bin > release folder (or debug) to find witadmin.exe
3. Run command line ```adoadmin.exe```
4. Add arguments below to run specific commands
#### Example
```
adoadmin.exe /org:myorgname /pat:1461fe40a1074619b1b29438ad19c71b /action:listallfields
```
## Arguments
```
/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
```
## 📃Process
```
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
```
### Examples
```
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
```
## 📅 Delivery Plans
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
```
### Example
```
adoadmin.exe /org:{organization name} /pat:{value} /action:list-delete-plans /days:182
```
## ♻️ Recyle bin
Used to delete work items forever out the recycle bin.
```
adoadmin.exe /org:{organization name} /pat:{value} /action:emptyrecyclebin /project:{project name} /days:0
```
### Examples
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
```
## 🏷️ Tags
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}
```