Functions/Add-AzDoPipeline.ps1
|
Function Add-AzDoPipeline{ <# .SYNOPSIS Creates an Azure DevOps pipeline. .DESCRIPTION Creates an Azure DevOps pipeline by using its pipeline ID or name. .EXAMPLE New-AzDoPipeline -PipelineName "Test_Pipe" -Project "CI Team" -RepositoryName CoolRepo .PARAMETER PipelineName The name of pipeline you wish to create .PARAMETER ProjectName The name of your Azure Devops Project or Team .PARAMETER RepositoryId The ID of your repository that hosts the pipelines. Either this or RepositoryName must be specified. .PARAMETER RepositoryName The name of the repository that hosts the pipelines. Either this or RepositoryId must be specified. .PARAMETER FolderPath If you use folders to organise your Pipelines, this can be added here. .PARAMETER YAMLPath The path to the yaml file the pipeline should use. .INPUTS Input is from command line or called from a script. .NOTES Author: Lars Panzerbjørn Creation Date: 2024.11.09 Purpose/Change: Initial script development #> [CmdletBinding()] param( [Parameter(Mandatory)] [string]$PipelineName, [Parameter()] [Alias('TeamName')] [string]$Project = $Script:Project, [Parameter()] [string]$RepositoryId, [Parameter()] [string]$RepositoryName, [Parameter()][string]$FolderPath, [Parameter(Mandatory)] [string]$YAMLPath ) BEGIN{ Write-Verbose "Beginning $($MyInvocation.Mycommand)" $Uri = $BaseUri + "$Project/_apis/pipelines?api-version=7.0" Write-Verbose "$Uri" #Testing Repo Name or ID exists if (-not $RepositoryId -and -not $RepositoryName) { Write-Error "You must specify either a RepositoryId or a RepositoryName." return } } PROCESS{ Write-Verbose "Processing $($MyInvocation.Mycommand)" #Converting repo name to repo ID if (($RepositoryName) -and (-not $RepositoryId)) { # Get the repository ID by name $RepositoryId = (Get-AzDORepo -Project $Project -RepoName $RepositoryName).id Write-Verbose "Found Repository ID: $RepositoryId" } $Body = @{ name = $PipelineName configuration = @{ type = "yaml" path = $YAMLPath repository = @{ id = $RepositoryId name = $RepositoryId type = "azureReposGit" } } } $Body IF($FolderPath){ $Body.folder = $FolderPath } $Body = $Body | ConvertTo-Json -Depth 10 Write-Verbose $Body $Result = Invoke-RestMethod -Uri $Uri -Method POST -Headers $Header -ContentType "application/json" -Body $Body } END{ Write-Verbose "Ending $($MyInvocation.Mycommand)" $Result #| Select-Onject -Property id, name, url } } |