forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
New-ADOServiceEndpoint.ps1
148 lines (128 loc) · 5.12 KB
/
New-ADOServiceEndpoint.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
148
function New-ADOServiceEndpoint
{
<#
.Synopsis
Creates Azure DevOps Service Endpoints
.Description
Creates Service Endpoints in Azure DevOps.
Service Endpoints are used to connect an Azure DevOps project to one or more web services.
To see the types of service endpoints, use Get-ADOServiceEndpoint -GetEndpointType
.Example
New-ADOServiceEndpoint -Organization MyOrg -Project MyProject -Name MyGitHubConnection -Url https://github.com -Type GitHub -Authorization @{
scheme = 'PersonalAccessToken'
parameters = @{
accessToken = $MyGitHubPersonalAccessToken
}
} -PersonalAccessToken $MyAzureDevOpsPersonalAccessToken -Data @{pipelinesSourceProvider='github'}
.Link
https://docs.microsoft.com/en-us/rest/api/azure/devops/serviceendpoint/endpoints/create?view=azure-devops-rest-5.1
#>
[CmdletBinding(DefaultParameterSetName='serviceendpoint/endpoints',SupportsShouldProcess)]
[OutputType('PSDevOps.ServiceEndpoint', [Hashtable])]
param(
# The Organization
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[Alias('Org')]
[string]
$Organization,
# The Project
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[string]
$Project,
# The name of the endpoint
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[string]
$Name,
# Initial administrators of the endpoint
[Parameter(ValueFromPipelineByPropertyName)]
[PSObject]
$AdministratorsGroup,
# Endpoint authorization data
[Parameter(ValueFromPipelineByPropertyName)]
[PSObject]
$Authorization,
# General endpoint data
[Parameter(ValueFromPipelineByPropertyName)]
[PSObject]
$Data,
# Initial readers of the endpoint
[Parameter(ValueFromPipelineByPropertyName)]
[PSObject]
$ReadersGroup,
# The endpoint type. To see available endpoint types, use Get-ADOServiceEndpoint -GetEndpointType
[Parameter(ValueFromPipelineByPropertyName)]
[string]
$Type,
# The endpoint description.
[Parameter(ValueFromPipelineByPropertyName)]
[string]
$Description,
# The endpoint service URL.
[Parameter(ValueFromPipelineByPropertyName)]
[uri]
$Url,
# If set, the endpoint will be shared across projects
[Parameter(ValueFromPipelineByPropertyName)]
[switch]
$IsShared,
# 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
$queryParameters = ,'apiVersion'
}
process {
$uri = # The URI is comprised of:
@(
"$server".TrimEnd('/') # the Server (minus any trailing slashes),
$Organization # the Organization,
$Project # the Project,
'_apis' # the API Root ('_apis'),
(. $ReplaceRouteParameter $PSCmdlet.ParameterSetName)
# 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 ($ApiVersion) { # * The api-version
"api-version=$ApiVersion"
}
) -join '&'
$notInvokeParams = . $getNotInvokeParameters $PSBoundParameters
foreach ($k in @($notInvokeParams.Keys)) {
if ($queryParameters -contains $k) {
$notInvokeParams.Remove($k)
}
}
$body = $notInvokeParams
$invokeParams += @{Uri=$uri;Body =$body;Method='POST'}
if ($WhatIfPreference) {
$invokeParams.Remove('PersonalAccessToken')
return $invokeParams
}
if (-not $psCmdlet.ShouldProcess("$($invokeParams.method) $($invokeParams.Uri)")) { return }
Invoke-ADORestAPI @invokeParams -PSTypeName @( # Prepare a list of typenames so we can customize formatting:
"$Organization.$Project.ServiceEndpoint" # * $Organization.$Project.ServiceEndpoint
"$Organization.ServiceEndpoint" # * $Organization.ServiceEndpoint
"PSDevOps.ServiceEndpoint" # * PSDevOps.ServiceEndpoint
) -Property @{
Organization = $organization
Project = $project
Server = $Server
}
}
}