Automatos.Common

1.0.0

Functions/Data/Convert-StringToBase64.ps1

<#
.SYNOPSIS
Converts a value to base-64 encoding.
#>
function Convert-StringToBase64
{
    [CmdletBinding()]
    param
    (
        # The value to base-64 encode
        [Parameter(Mandatory=$true,ValueFromPipeline=$true)]
        [AllowNull()]
        [AllowEmptyString()]
        [string[]]
        $Value,
        
        # The encoding to use. Default is UTF8
        [Parameter(Mandatory=$false)]
        [ValidateSet("UTF8","Unicode","ASCII","UTF7","UTF32","BigEndianUnicode")]
        [string]
        $Encoding = "UTF8"
    )

    Begin
    {
        [Text.Encoding]$Encode = ([System.Text.Encoding]::$Encoding)
    }

    process
    {
        $Value | ForEach-Object {
            if( $_ -eq $null )
            {
                return $null
            }
            $bytes = $Encode.GetBytes($_)
            [Convert]::ToBase64String($bytes)
        }
    }
}