Public/New-PSGitLabEnvironment.ps1

function New-PSGitLabEnvironment {
    <#
    .SYNOPSIS
        A short one-line action-based description, e.g. 'Tests if a function is valid'
    .DESCRIPTION
        A longer description of the function, its purpose, common use cases, etc.
    .NOTES
        Information or caveats about the function e.g. 'This function is not supported in Linux'
    .LINK
        Specify a URI to a help page, this will show when Get-Help -Online is used.
    .EXAMPLE
        Test-MyTestFunction -Verbose
        Explanation of the function or its result. You can include multiple examples with additional .EXAMPLE lines
    #>

    
    
    [CmdletBinding()]
    param (
        [string]
        $OrganizationName,

        [string]
        $PrivateToken,

        [string]
        $ProjectFullPath,

        [string]
        $EnvironmentName,

        [string]
        [ValidateSet('PRODUCTION', 'STAGING', 'TESTING', 'DEVELOPMENT', 'OTHER')]
        $Tier
    )
    
    $query = @{
        query = @"
            mutation {
                environmentCreate(
                input: {projectPath: "$($ProjectFullPath)", name: "$($EnvironmentName)", tier: $($Tier)}
                ) {
                environment {
                    name
                    externalUrl
                }
                errors
                }
            }
"@

    } | ConvertTo-Json 

    $response = Invoke-RestMethod -Uri "https://$($OrganizationName)/api/graphql" -Headers @{Authorization = "Bearer $($PrivateToken)" } -Method Post -Body $query -ContentType 'application/json' 
    
    if ($response.errors) {
        Write-Error -Message $($response.errors.message) -InformationAction Continue
    }
    else {
        $response.data.environmentCreate.environment
    }
}