Functions/BloxOne/BloxOneDDI/ConvertTo-RNAME.ps1

function ConvertTo-RNAME {
    <#
    .SYNOPSIS
        Uses the BloxOne API to convert an email address to RNAME format

    .DESCRIPTION
        This function uses the BloxOne API to convert an email address to RNAME format

    .PARAMETER Email
        The email address to convert into RNAME format

    .EXAMPLE
        PS> ConvertTo-RNAME -Email 'admin.user@company.corp'

        Email RNAME
        ----- -----
        admin.user@company.corp admin\.user.company.corp
    
    .FUNCTIONALITY
        BloxOneDDI

    .FUNCTIONALITY
        Logs
    #>

    param(
      [Parameter(Mandatory=$true,ValueFromPipeline=$true)]
      [string[]]$Email
    )

    process {
        $Results = @()
        foreach ($iEmail in $Email) {
            
            $Result = Invoke-CSP -Uri "$(Get-B1CSPUrl)/api/ddi/v1/dns/convert_rname/$($iEmail)" -Method GET
            $Results += [PSCustomObject]@{
                "Email" = $iEmail
                "RNAME" = $Result.rname
            }
        }

        if ($Results) {
            return $Results
        } else {
            Write-Host "Error. Unable to convert email address to RNAME." -ForegroundColor Red
            break
        }
    }
}