Public/Api/DistributedTask/VariableGroups/Add-AzDoVariableGroupVariable.ps1
|
function Add-AzDoVariableGroupVariable { <# .SYNOPSIS This script adds variables to variable groups in a given project. .DESCRIPTION This script adds variables to variable groups in a given project. When used in a pipeline, you can use the pre defined CollectionUri, ProjectName and AccessToken (PAT) variables. .EXAMPLE $splat = @{ CollectionUri = 'https://dev.azure.com/ChristianPiet0452/' ProjectName = 'Ditproject' VariableGroupName = @('Group1', 'Group2') Variables = @{ test = @{ value = 'test' } kaas = @{ value = 'kaas' } } } Add-AzDoVariableGroupVariable @splat This example creates a new Variable Group with a variable "test = test". .EXAMPLE $splat = @{ CollectionUri = 'https://dev.azure.com/ChristianPiet0452/' ProjectName = 'Ditproject' VariableGroupName = @('Group1', 'Group2') } Get-AzDoVariableGroup @splat | Add-AzDoVariableGroupVariable -Variables @{ test = @{ value = 'test' } } This example creates a few new Variable Groups with a variable "test = test". .OUTPUTS PSObject .NOTES #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')] param ( # Collection Uri of the organization [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateScript({ Validate-CollectionUri -CollectionUri $_ })] [string] $CollectionUri, # Project where the variable group has to be created [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [string] $ProjectName, # Name of the variable group [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [string] $VariableGroupName, # Variable names and values [Parameter(Mandatory, ValueFromPipelineByPropertyName, ValueFromPipeline)] [hashtable] $Variables ) begin { $result = @() Write-Verbose "Starting function: Add-AzDoVariableGroupVariable" } process { Write-Information "Starting function: Add-AzDoVariableGroupVariable" $groups = Get-AzDoVariableGroup -CollectionUri $CollectionUri -ProjectName $ProjectName # Get the variable group based on it's name and match to ID for URI $group = $groups | Where-Object { $_.VariableGroupName -eq $VariableGroupName } # $group.Variables isn't a hashtable, so it needs to be converted and back to be able $group.Variables = ($group.Variables | ConvertTo-Json | ConvertFrom-Json -AsHashtable) $trimmedvars = @{} foreach ($variable in $Variables.GetEnumerator()) { $trimmedvars += @{ $variable.Key = @{ value = $variable.Value } } } $body = @{ variables = $trimmedvars + $group.Variables name = $group.VariableGroupName } $params = @{ uri = "$CollectionUri/$ProjectName/_apis/distributedtask/variablegroups/$($group.VariableGroupId)?api-version=7.1-preview.1" Method = 'PUT' body = $Body | ConvertTo-Json -Depth 99 ContentType = 'application/json' } if ($PSCmdlet.ShouldProcess($CollectionUri, "Add Variables to Variable Group named: $($PSStyle.Bold)$name$($PSStyle.Reset)")) { $result += Invoke-AzDoRestMethod @params } else { Write-Verbose "Calling Invoke-AzDoRestMethod with $($params| ConvertTo-Json -Depth 10)" } } end { if ($result) { $result | ForEach-Object { [PSCustomObject]@{ CollectionURI = $CollectionUri ProjectName = $ProjectName VariableGroupName = $_.name VariableGroupId = $_.id Variables = $_.variables CreatedOn = $_.createdOn IsShared = $_.isShared } } } } } |