Encodes a PSCredential for use against an API using Basic authentication

New-EncodedCredential.ps1

function New-EncodedCredential {
    <#
        .SYNOPSIS
        Return an base64 encoded credential for use against API authentication
        
        .PARAMETER Credential
        The PSCredential object to encode

        .PARAMETER AsHeader
        Returns a header containing the required authorization information for use with the -Header parameter of Invoke-RestMethod
        
        .EXAMPLE
        New-EncodedCredential -Credential (Get-Credential)

        .EXAMPLE
        New-EncodedCredential -Credential $Credential -AsHeader
    #>
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory)]
        [System.Management.Automation.PSCredential]
        $Credential,

        [Parameter()]
        [Switch]
        $AsHeader
    )

    process {
        $credPair = "{0}:{1}" -f $Credential.UserName,$Credential.GetNetworkCredential().Password
        $encodedCreds = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($credPair))
        
        if($AsHeader){
            @{ Authorization = "Basic $encodedCreds" }
        }
        else {
            return $encodedCreds   
        }
    }
}