Set-ADOBuild.ps1

function Set-ADOBuild
{
    <#
    .Synopsis
        Sets ADO Build information
    .Description
        Sets the Azure DevOps Build information
    .Example
        Set-ADOBuild -Log .\MyLog.log
    .Example
        Set-ADOBuild -BuildNumber 21
    .Example
        Set-ADOBuild -Tag TestPassed, CodeCoveragePassed
    .Example
        Set-ADOBuild -ReleaseName NewRelease
    .Link
        https://docs.microsoft.com/en-us/azure/devops/pipelines/scripts/logging-commands
    #>

    [CmdletBinding(PositionalBinding=$false)]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingWriteHost", "", Justification="Directly outputs in certain scenarios")]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "", Justification="Confirmation would be impossible within host")]
    param(
    # A new build number (or identifier)
    [Parameter(ValueFromPipelineByPropertyName)]
    [Alias('BN')]
    [string]
    $BuildNumber,

    # One or more tags for this build
    [Parameter(ValueFromPipelineByPropertyName)]
    [Alias('T')]
    [string[]]
    $Tag,

    # The name of the release
    [Parameter(ValueFromPipelineByPropertyName)]
    [Alias('Name','RN')]
    [string]
    $ReleaseName,

    # Adds a location to the environment path
    [Alias('PP','EP', 'PrependPath')]
    [string]
    $EnvironmentPath
    )

    process {
        $out = & {
            if ($BuildNumber) {
                "##vso[build.updatebuildnumber]$BuildNumber"
            }

            if ($tag) {
                foreach ($t in $tag) {
                    "##vso[build.addbuildtag]$t"
                }
            }

            if ($ReleaseName) {
                "##vso[build.updatereleasename]$ReleaseName"
            }

            if ($EnvironmentPath) {
                "##vso[task.prependpath]$EnvironmentPath"
            }
        }

        if ($env:Agent_ID -and $DebugPreference -eq 'SilentlyContinue') {
            $out | Out-Host
        } else {
            $out
        }
    }
}