forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathGet-ADOTeam.ps1
107 lines (94 loc) · 3.68 KB
/
Get-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
function Get-ADOTeam
{
<#
.Synopsis
Gets Azure DevOps Teams
.Description
Gets teams from Azure DevOps or TFS
.Link
Get-ADOProject
.Example
Get-ADOTeam -Organization StartAutomating
#>
[CmdletBinding(DefaultParameterSetName='teams')]
[OutputType('PSDevOps.Team','PSDevOps.TeamMember')]
param(
# The Organization.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[Alias('Org')]
[string]
$Organization,
# The project name or identifier
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams',ValueFromPipelineByPropertyName)]
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}/members',ValueFromPipelineByPropertyName)]
[string]
$Project,
# If set, will return teams in which the current user is a member.
[Parameter(ParameterSetName='teams',ValueFromPipelineByPropertyName)]
[Parameter(ParameterSetName='projects/{Project}/teams',ValueFromPipelineByPropertyName)]
[Alias('My')]
[switch]
$Mine,
# The Team Identifier
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}/members',ValueFromPipelineByPropertyName)]
[string]
$TeamID,
# If set, will return members of a team.
[Parameter(Mandatory,ParameterSetName='projects/{Project}/teams/{teamId}/members')]
[Alias('Members','Membership')]
[switch]
$Member,
# 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/"
)
dynamicParam { . $GetInvokeParameters -DynamicParameter }
begin {
#region Copy Invoke-ADORestAPI parameters
$invokeParams = . $getInvokeParameters $PSBoundParameters
#endregion Copy Invoke-ADORestAPI parameters
}
process {
$psParameterSet = $psCmdlet.ParameterSetName
$in = $_
if ($in.Project -and $psParameterSet -notlike '*Project*') {
$psParameterSet = 'projects/{Project}/teams'
$project = $psBoundParameters['Project'] = $in.Project
}
$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 '/'
$uri += '?' # The URI has a query string containing:
$uri += @(
if ($Server -ne 'https://dev.azure.com/' -and
-not $PSBoundParameters.ApiVersion) {
$ApiVersion = '2.0'
}
if ($Mine) {
'$mine=true'
}
if ($ApiVersion) { # the api-version
"api-version=$apiVersion"
}
) -join '&'
# We want to decorate our return value. Handily enough, both URIs contain a distinct name in the last URL segment.
$typename = @($psCmdlet.ParameterSetName -split '/')[-1].TrimEnd('s') -replace 'Member', 'TeamMember' # We just need to drop the 's'
$typeNames = @(
"$organization.$typename"
if ($Project) { "$organization.$Project.$typename" }
"PSDevOps.$typename"
)
Invoke-ADORestAPI -Uri $uri @invokeParams -PSTypeName $typenames -Property @{
Organization = $Organization
Project = $Project
Server = $Server
}
}
}