Functions/Get-AzDOProjects.ps1
|
Function Get-AzDOProjects { <# .SYNOPSIS This will get a list of Projects in your organisation. .DESCRIPTION This will get a list of Projects in your organisation. .EXAMPLE Get-AzDOProjects -PersonalAccessToken gh5553hiih5lfewahq7n3g7x7oieuothushimanuoch8szn3u2sq -Organisation panzerbjrn .EXAMPLE $Projects = (Get-AzDOProjects -PersonalAccessToken $personalToken -Organisation $OrganizationName).value .PARAMETER PersonalAccessToken This is your personal access token from Azuree Devops. .PARAMETER OrganisationName The name of your Azure Devops Organisation .INPUTS Input is from command line or called from a script. .OUTPUTS This will output a list of projects. .NOTES Version: 1 Author: Lars Panzerbjørn Creation Date: 2020.07.31 Purpose/Change: Initial script development #> [CmdletBinding()] param ( [Parameter(Mandatory)] [Alias('PAT')] [string]$PersonalAccessToken, [Parameter(Mandatory)] [Alias('Company')] [string]$Organisation ) BEGIN { Write-Verbose "Beginning $($MyInvocation.Mycommand)" $Uri = "https://dev.azure.com/$($Organisation)/_apis/projects?api-version=5.1" $JsonContentType = 'application/json-patch+json' $Token = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes(":$($PersonalAccessToken)")) $Header = $AzureDevOpsAuthenicationHeader = @{Authorization = 'Basic ' + $Token;accept=$JsonContentType} } PROCESS { Write-Verbose "Processing $($MyInvocation.Mycommand)" $Projects = Invoke-RestMethod -Uri $Uri -Method get -Headers $Header #Retrieves list of Projects } END { Write-Verbose "Ending $($MyInvocation.Mycommand)" $Projects } } |