forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Get-ADOExtension.ps1
97 lines (88 loc) · 3.18 KB
/
Get-ADOExtension.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
function Get-ADOExtension
{
<#
.Synopsis
Gets Azure DevOps Extensions
.Descriptions
Gets Extensions to Azure DevOps.
.Example
Get-ADOExtension -Organization StartAutomating
.Link
https://docs.microsoft.com/en-us/rest/api/azure/devops/extensionmanagement/installed%20extensions/list?view=azure-devops-rest-5.1
#>
[CmdletBinding(DefaultParameterSetName='/{Organization}/_apis/extensionmanagement/installedextensions')]
param(
# The organization.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[string]
$Organization,
# A list of asset types
[Alias('AssetTypes')]
[string[]]
$AssetType,
# If set, will include disabled extensions
[Alias('Disabled')]
[switch]
$IncludeDisabled,
# If set, will include extension installation issues
[Alias('IncludeInstallationIssue','IncludeInstallationIssues')]
[switch]
$InstallationIssue,
# If set, will include errors
[Alias('IncludeErrors')]
[switch]
$IncludeError,
# 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://extmgmt.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-preview"
)
dynamicParam { . $GetInvokeParameters -DynamicParameter }
begin {
#region Copy Invoke-ADORestAPI parameters
$invokeParams = . $getInvokeParameters $PSBoundParameters
#endregion Copy Invoke-ADORestAPI parameters
}
process {
$uri = # The URI is comprised of:
@(
"$server".TrimEnd('/') # the Server (minus any trailing slashes),
(. $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 ($IncludeDisabled) {
"includeDisabledExtensions=true"
}
if ($InstallationIssue) {
"includeInstallationIssues=true"
}
if ($IncludeError) {
"includeErrors=true"
}
if ($Server -ne 'https://extmgmt.dev.azure.com/' -and
-not $PSBoundParameters.ApiVersion) {
$ApiVersion = '2.0'
}
if ($ApiVersion) { # the api-version
"api-version=$apiVersion"
}
) -join '&'
$typename = @($psCmdlet.ParameterSetName -split '/')[-1].TrimEnd('s') # We just need to drop the 's'
$typeNames = @(
"$organization.$typename"
"PSDevOps.$typename"
)
Invoke-ADORestAPI -Uri $uri @invokeParams -PSTypeName $typenames -Property @{
Organization = $Organization
Server = $Server
}
}
}