forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Set-ADOTeam.ps1
147 lines (133 loc) · 5.59 KB
/
Set-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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
function Set-ADOTeam
{
<#
.Synopsis
Sets properties of an Azure DevOps team
.Description
Sets metadata for an Azure DevOps team.
.Link
Get-ADOTeam
.Example
Get-ADOTeam -Organization MyOrganization -Project MyProject -Team MyTeam |
Set-ADOTeam -Setting @{
Custom = 'Value'
}
.Link
https://docs.microsoft.com/en-us/rest/api/azure/devops/work/teamsettings/update?view=azure-devops-rest-6.0
#>
[CmdletBinding(SupportsShouldProcess)]
[OutputType([Nullable],[PSObject])]
[Diagnostics.CodeAnalysis.SuppressMessageAttribute("Test-ForParameterSetAmbiguity", "", Justification="Ambiguity Desired.")]
param(
# The Organization.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[Alias('Org')]
[string]
$Organization,
# The project.
[Parameter(Mandatory,ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[string]
$Project,
# The team.
[Parameter(Mandatory,ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[string]
$Team,
# A dictionary of team settings. This is directly passed to the REST api.
[Parameter(ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[Collections.IDictionary]
$Setting = @{},
# The team working days.
[Parameter(ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[Alias('WorkingDays','Workdays')]
[string[]]
$Workday,
# The default iteration for the team.
[Parameter(ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[Alias('IterationID')]
[string]
$DefaultIteration,
# The bug behavior for the team.
[Parameter(ParameterSetName='/{Organization}/{Project}/{Team}/_apis/work/teamsettings',ValueFromPipelineByPropertyName)]
[Alias('BugBehaviors','BugBehaviour', 'BugBehaviours')]
[ValidateSet('AsRequirements','AsTasks','Off')]
[string]
$BugBehavior,
# 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-preview.
# 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-preview"
)
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 {
$q.ToArray() |
Group-Object { $_.PSParameterSet + ':' + $_.Project + ':' + $_.Team }|
ForEach-Object {
$group = $_
if ($group.Name -like '*/teamsettings:*') {
$settings = @{}
foreach ($g in $group.Group) {
if ($BugBehavior) {
$settings.bugsBehavior = $BugBehavior
}
if ($Workday) {
$settings.workingDays = $Workday
}
if ($DefaultIteration) {
$setttings.defaultIteration = $DefaultIteration
}
if ($g.Setting.Count) {
foreach ($kv in $g.Setting.GetEnumerator()) {
$settings[$kv.Key] = $kv.Value
}
}
}
$invokeParams.Method = 'PATCH'
$invokeParams.Body = $settings
}
if ($invokeParams.Body) {
$uriBase, $null = $group.Name -split ':', 2
$uri = @(
"$server".TrimEnd('/') # * The Server
. $ReplaceRouteParameter $uriBase
) -join ''
$uri += '?'
$uri += @(
if ($Server -ne 'https://dev.azure.com' -and
-not $psBoundParameters['apiVersion']) {
$apiVersion = '2.0'
}
if ($ApiVersion) { # an api-version (if one exists)
"api-version=$ApiVersion"
}
) -join '&'
$invokeParams.Uri = $uri
if ($WhatIfPreference) {
$invokeParams.Remove('PersonalAccessToken')
return $invokeParams
}
if ($PSCmdlet.ShouldProcess("$($invokeParams.Method) $($invokeParams.Uri) $($invokeParams.Body | ConvertTo-Json)")) {
Invoke-ADORestAPI @invokeParams -Property @{
Organization = $Organization
Server = $server
ProjectID = $ProjectID
}
}
}
}
}
}