AzureDevOps.VariableGroups/Public/Get-AzureDevOpsVariableGroup.ps1
|
function Get-AzureDevOpsVariableGroup { <# .SYNOPSIS Retrieve a variable group or a set of variable groups. .DESCRIPTION Retrieves a variable group by its ID or a set of variable groups based on a search string. .PARAMETER GroupId The variable group ID. If this parameter is specified. the variable group with the specified ID will be retrieved. .PARAMETER SearchString The search string. If this parameter is specified, the variable groups whose names start with the specified search string will be retrieved. .EXAMPLE Get-AzureDevOpsVariableGroup -GroupId "2" Gets the variable group with ID: "2". .EXAMPLE Get-AzureDevOpsVariableGroup -SearchString "contoso" Gets variable groups which have names starting with "contoso". #> [CmdletBinding(DefaultParameterSetName = 'GroupId')] param ( [Parameter(ParameterSetName='GroupId')] [string]$GroupId = "", [Parameter(ParameterSetName='SearchString')] [string]$SearchString = "" ) if($PSCmdlet.ParameterSetName -eq 'GroupId') { $result = Invoke-AzureDevOpsRestMethod -PartialUri "/distributedtask/variablegroups/$($GroupId)?api-version=4.1-preview.1" -Method Get; if($null -eq $result) { Write-Warning -Message "No variable groups found with ID '$GroupId'."; } return $result } else { if($SearchString) { $PartialUri = "/distributedtask/variablegroups/?groupName=$SearchString*&api-version=4.1-preview.1"; } else { $PartialUri = "/distributedtask/variablegroups/?api-version=4.1-preview.1"; } $result = Invoke-AzureDevOpsRestMethod -PartialUri $PartialUri -Method Get; if($result.count -eq 0) { Write-Warning -Message "No variable groups found with a name that starts with '$SearchString'."; } return $result.value; } } |