New-GitLabProjectLabel.ps1
|
function New-GitLabProjectLabel { <# .SYNOPSIS Create a new label in a project. .DESCRIPTION The New-GitLabProjectLabel function creates a new label. A label color can be passed using -Color #xxxxxx .EXAMPLE New-GitLabProjectLabel -ProjectID 20 -Name 'To Do' --------------------------------------------------------------- Creates a New label named 'To Do' in project 20. .EXAMPLE New-GitLabProjectLabel -ProjectID 20 -Name 'To Do' -PassThru --------------------------------------------------------------- Creates a New label named 'To Do' in project 20. Returns the created Label. #> [CmdletBinding()] [Alias()] [OutputType()] Param ( # The ID of the project [Parameter(HelpMessage = 'ProjectID', Mandatory = $true)] [Alias('ID')] [int]$ProjectID, # The Label Name [Parameter(HelpMessage = 'Label Name', Mandatory = $true)] [Alias()] [string]$Name, # The label color HEX Notation [Parameter(HelpMessage = 'Label Color Hex notation (#000000)', Mandatory = $false)] [Alias('HEXColor')] [ValidatePattern('^#[A-Fa-f0-9]{6}$')] [string]$Color = '#428bca', # Description for the label [Parameter(HelpMessage = 'Label Description', Mandatory = $false)] [Alias()] [string]$description, # Specify Existing GitlabConnector [Parameter(HelpMessage = 'Specify Existing GitlabConnector', Mandatory = $false, DontShow = $true)] [psobject]$GitlabConnect = (Get-GitlabConnect), # Passthru the created label [Parameter(HelpMessage = 'Passthru the created label', Mandatory = $false)] [switch]$PassThru ) $httpmethod = 'post' $apiurl = "projects/$ProjectID/labels" $parameters = @{ id = $ProjectID name = $name color = $Color } if($description) { $parameters.description = $description } $newlabel = $GitlabConnect.callapi($apiurl,$httpmethod,$parameters) if($PassThru) { return $newlabel } } |