Get-GitlabConnect.ps1
|
function Get-GitLabConnect { <# .SYNOPSIS Composes and Returns a GitlabConnect object. .DESCRIPTION Composes and Returns a GitlabConnect object. Uses active token from stored config by default. you can add tokens with Add-GitlabToken. Passing -ID of a token forces gitlabconnect to use that token to create a connect object. Gitlabconnect objects can be passed to all functions to specify a connection to use for interaction with gitlab. A gitlabconnectobject can also be generated on the fly by passing -GitlabURI and -Token .EXAMPLE Get-GitLabConnect --------------------------------------------------------------- returns a Connect object based of the current active gitlabtoken .EXAMPLE Get-GitLabConnect -id 695c6eea-1fc3-4f78-886e-6b7c0f27102e --------------------------------------------------------------- returns a Connect object based of token 695c6eea-1fc3-4f78-886e-6b7c0f27102e tokenid can be retrieved with Get-GitlabToken .EXAMPLE Get-GitLabConnect -GitLabURI gitlab.com -Token XXXXXXXXXX --------------------------------------------------------------- Returns a Connect object based on passed hostname and token. These connect settings are not persistent .EXAMPLE $GitLabConnectObj = Get-GitLabConnect -GitLabURI gitlab.com -Token XXXXXXXXXX Get-GitLabProject -GitLabConnect $GitLabConnectObj --------------------------------------------------------------- Creates a connect object on the fly. Returns all the projects that the token has access to. #> [CmdletBinding(DefaultParameterSetName = 'ByTokenID')] [Alias()] [OutputType()] param( #Specifies token to be used to create a connectobject, tokenid can be retrieved with Get-GitlabToken. [parameter(Mandatory = $false, ParameterSetName='ByTokenID')] [Alias('KeyId')] [system.guid]$id, #Gitlab URI, e.a. https://gitab.com [Parameter(HelpMessage = 'GitlabServer URI', Mandatory = $true, ParameterSetName='OnTheFly')] [ValidatePattern("^(?:http|https):\/\/(?:[\w\.\-\+]+:{0,1}[\w\.\-\+]*@)?(?:[a-z0-9\-\.]+)(?::[0-9]+)?(?:\/|\/(?:[\w#!:\.\?\+=&%@!\-\/\(\)]+)|\?(?:[\w#!:\.\?\+=&%@!\-\/\(\)]+))?$")] [string]$GitLabURI, # Token supplied from gitlab. This can be an private and an Access Token. [Parameter(Mandatory = $true, ParameterSetName='OnTheFly')] [string]$Token ) if($PSCmdlet.ParameterSetName -like 'ByTokenID'){ if($id){ $Gitlabtoken = (Get-GitLabToken).where({$_.id -eq $id}) if(-not $Gitlabtoken){ $errormessage = 'No Token found with Id [$ID]' Write-Error -Message $errormessage -Category ResourceUnavailable -ErrorAction Stop } }else{ $Gitlabtoken = Get-GitLabToken -active } return [gitlabconnect]::new($Gitlabtoken.gitlabhost,$Gitlabtoken.gitlabuser) } if($PSCmdlet.ParameterSetName -like 'OnTheFly') { return [gitlabconnect]::new($GitLabURI,$Token) } } |