forked from StartAutomating/PSDevOps
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathAdd-ADOWiki.ps1
155 lines (132 loc) · 5.17 KB
/
Add-ADOWiki.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
149
150
151
152
153
function Add-ADOWiki {
<#
.Synopsis
Creates Azure DevOps Wikis
.Description
Creates Wikis in Azure DevOps.
.Example
Add-ADOWiki -Organization MyOrg -Project MyProject -Name MyWiki
.Example
Get-ADORepository -Organization MyOrg -Project MyProject |
Add-ADOWiki -Name BuildHistory
.Link
Get-ADOWiki
.Link
https://docs.microsoft.com/en-us/rest/api/azure/devops/wiki/wikis/create
#>
[CmdletBinding(SupportsShouldProcess,DefaultParameterSetName='wiki/wikis')]
[OutputType('PSDevOps.Wiki')]
param(
# The Organization.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[Alias('Org')]
[string]
$Organization,
# The Project.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[string]
$Project,
# The name of the wiki.
[Parameter(Mandatory,ValueFromPipelineByPropertyName)]
[string]
$Name,
# The ID of the repository used for the wiki.
[Parameter(ValueFromPipelineByPropertyName)]
[string]
$RepositoryID,
# The type of the wiki. This can be either 'ProjectWiki' or 'CodeWiki'.
# If a -RepositoryID is provided, this will be ignored as it must be a CodeWiki.
[Parameter(ValueFromPipelineByPropertyName)]
[ValidateSet('ProjectWiki','CodeWiki')]
[string]
$WikiType = 'ProjectWiki',
# The root path of the wiki within the repository.
[Parameter(ValueFromPipelineByPropertyName)]
[Alias('MappedPath')]
[string]
$RootPath,
# 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 {
$ParameterSet = $psCmdlet.ParameterSetName
$q.Enqueue(@{ParameterSet=$ParameterSet} + $PSBoundParameters)
}
end {
$c, $t, $id = 0, $q.Count, [Random]::new().Next()
$originalInvokeParams = @{} + $invokeParams
while ($q.Count) {
. $DQ $q # Pop one off the queue and declare all of it's variables (see /parts/DQ.ps1).
$projectID =
if ($Project -as [guid]) {
$Project
} else {
Get-ADOProject -Organization $Organization -Project $Project @originalInvokeParams |
Select-Object -ExpandProperty ProjectID
}
$c++
Write-Progress "Adding $(@($ParameterSet -split '/' -notlike '{*}')[-1])" "$Organization $Project $Team" -Id $id -PercentComplete ($c * 100/$t)
$uri = # The URI is comprised of:
@(
"$server".TrimEnd('/') # the Server (minus any trailing slashes),
$Organization # the Organization,
$Project
'_apis' # the API Root ('_apis'),
(. $ReplaceRouteParameter $ParameterSet)
# 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 '&'
$invokeParams.Uri = $uri
$invokeParams.Method = 'POST'
$additionalProperty = @{Organization=$Organization;Project=$Project}
$invokeParams.Property = $additionalProperty
$body = @{
name = $Name
projectID = $projectID
}
if ($RepositoryID) {
$body.repositoryID = $RepositoryID
$body.type = 'CodeWiki'
}
else {
$body.type = $WikiType
}
if ($RootPath) {
$body.MappedPath = $RootPath
}
$invokeParams.Body = $body
if ($WhatIfPreference) {
$invokeParams.Remove('PersonalAccessToken')
$invokeParams
continue
}
if (-not $psCmdlet.ShouldProcess("POST $($invokeParams.uri)")) {continue }
Invoke-ADORestAPI @invokeParams
}
Write-Progress "Adding $(@($ParameterSet -split '/' -notlike '{*}')[-1])" "$Organization $Project $Team" -Id $id -Completed
}
}