forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Remove-ADOTeam.ps1
104 lines (91 loc) · 3.58 KB
/
Remove-ADOTeam.ps1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
function Remove-ADOTeam
{
<#
.Synopsis
Removes Azure DevOps Teams
.Description
Removes teams from Azure DevOps or TFS
.Example
Remove-ADOTeam -Organization StartAutomating -Project PSDevOps -TeamID Stakeholders -WhatIf
.Link
New-ADOTeam
.Link
Get-ADOTeam
#>
[OutputType([Nullable], [Collections.IDictionary])]
[CmdletBinding(SupportsShouldProcess,ConfirmImpact='High')]
param(
# The Organization.
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}',ValueFromPipelineByPropertyName)]
[Alias('Org')]
[string]
$Organization,
# The project name or identifier
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}',ValueFromPipelineByPropertyName)]
[string]
$Project,
# The Team Identifier
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}',ValueFromPipelineByPropertyName)]
[string]
$TeamID,
# The server. By default https://dev.azure.com/.
# To use against TFS, provide the tfs server URL (e.g. http://tfsserver:8080/tfs).
[Parameter(ValueFromPipelineByPropertyName)]
[uri]
$Server = "https://dev.azure.com/",
# The api version. By default, 5.1.
# If targeting TFS, this will need to change to match your server version.
# See: https://docs.microsoft.com/en-us/azure/devops/integrate/concepts/rest-api-versioning?view=azure-devops
[string]
$ApiVersion = "5.1")
dynamicParam { . $GetInvokeParameters -DynamicParameter }
begin {
#region Copy Invoke-ADORestAPI parameters
$invokeParams = . $getInvokeParameters $PSBoundParameters
#endregion Copy Invoke-ADORestAPI parameters
$q = [Collections.Queue]::new()
}
process {
$q.Enqueue(@{psParameterSet = $PSCmdlet.ParameterSetName} + $psBoundParameters)
}
end {
$c, $t, $id = 0, $q.Count, [Random]::new().Next()
while ($q.Count) {
. $dq $q
$uri = # The URI is comprised of:
@(
"$server".TrimEnd('/') # the Server (minus any trailing slashes),
$Organization # the Organization,
'_apis' # the API Root ('_apis'),
(. $ReplaceRouteParameter $psParameterSet)
# and any parameterized URLs in this parameter set.
) -as [string[]] -ne '' -join '/'
Write-Progress "Removing Teams" "$uri" -PercentComplete ($c * 100/ $t) -Id $id
$c++
$uri += '?' # The URI has a query string containing:
$uri += @(
if ($Server -ne 'https://dev.azure.com/' -and
-not $PSBoundParameters.ApiVersion) {
$ApiVersion = '2.0'
}
if ($ApiVersion) { # the api-version
"api-version=$apiVersion"
}
) -join '&'
$invokeParams.Method = 'DELETE'
$invokeParams.Uri = $uri
if ($WhatIfPreference) {
$invokeParams.Remove('PersonalAccessToken')
$invokeParams
continue
}
if (! $PSCmdlet.ShouldProcess("Delete $Organization\$Project\$team")) { continue }
Invoke-ADORestAPI @invokeParams -PSTypeName $typenames -Property @{
Organization = $Organization
Project = $Project
Server = $Server
}
}
Write-Progress "Removing Teams" " " -Completed -Id $id
}
}