ConvertTo-Base64.ps1

function ConvertTo-Base64 {
    <#
        .SYNOPSIS
        Converts a string or array of strings to their base64 encoded representation.

        .DESCRIPTION
        This function takes a string or array of strings as input and converts them to base64 encoded strings using UTF-8 encoding.
        It accepts input from the pipeline and can process string values directly or as an array.

        .EXAMPLE
        "Hello World" | ConvertTo-Base64

        Output:
        ```powershell
        SGVsbG8gV29ybGQ=
        ```

        Converts the string "Hello World" to its base64 encoded equivalent.

        .EXAMPLE
        @("Hello", "World") | ConvertTo-Base64

        Output:
        ```powershell
        SGVsbG8=
        V29ybGQ=
        ```

        Converts each string in the array to its base64 encoded equivalent.

        .OUTPUTS
        System.String

        .NOTES
        The base64 encoded representation of the input string(s).

        .LINK
        https://psmodule.io/Base64/Functions/ConvertTo-Base64/
    #>
    [Alias('ConvertTo-Base64String')]
    [OutputType([string])]
    [CmdletBinding()]
    param(
        # The input string or array of strings to be converted to base64 encoding.
        [Parameter(
            Mandatory,
            ValueFromPipeline,
            ValueFromPipelineByPropertyName
        )]
        [string[]] $String,

        # The encoding to use when converting the string to bytes.
        [Parameter()]
        [ValidateSet('UTF8', 'UTF7', 'UTF32', 'ASCII', 'Unicode', 'BigEndianUnicode', 'Latin1')]
        [string] $Encoding = 'UTF8'
    )

    process {
        foreach ($item in $String) {
            [Convert]::ToBase64String([System.Text.Encoding]::$Encoding.GetBytes($item))
        }
    }
}