Public/Test-ALHIsUpn.ps1

<#PSScriptInfo
 
.VERSION 1.0.0
 
.GUID 531acbf8-aa34-4a20-98ac-9de1932d73bc
 
.AUTHOR Dieter Koch
 
.COMPANYNAME
 
.COPYRIGHT (c) 2021-2023 Dieter Koch
 
.TAGS
 
.LICENSEURI https://github.com/admins-little-helper/ALH/blob/main/LICENSE
 
.PROJECTURI
 
.ICONURI
 
.EXTERNALMODULEDEPENDENCIES
 
.REQUIREDSCRIPTS
 
.EXTERNALSCRIPTDEPENDENCIES
 
.RELEASENOTES
    1.0.0
    - Initial release
 
#>



<#
 
.DESCRIPTION
 Contains a function to check if a given string is a valid UPN.
 
#>


function Test-ALHIsUpn {
    <#
    .SYNOPSIS
    Check if a given string is a valid UPN.
 
    .DESCRIPTION
    Checkif a given string is a valid UPN.
 
    .EXAMPLE
    Test-ALHIsUpn -UPN "somebody@somedomain.tld"
 
    .INPUTS
    System.String
 
    .OUTPUTS
    System.Boolean
 
    .NOTES
    Author: Dieter Koch
    Email: diko@admins-little-helper.de
 
    .LINK
    https://github.com/admins-little-helper/ALH/blob/main/Help/Test-ALHIsUpn.txt
    #>


    [OutputType([bool])]
    [CmdletBinding()]
    param(
        [Parameter(Mandatory, ValueFromPipeline)]
        [string]
        $UPN
    )

    try {
        if($null -eq ($UPN -as [System.Net.Mail.MailAddress])) {
            $false
        }
        else {
            $true
        }
    }
    catch {
        $_
    }
}


#region EndOfScript
<#
################################################################################
################################################################################
#
# ______ _ __ _____ _ _
# | ____| | | / _| / ____| (_) | |
# | |__ _ __ __| | ___ | |_ | (___ ___ _ __ _ _ __ | |_
# | __| | '_ \ / _` | / _ \| _| \___ \ / __| '__| | '_ \| __|
# | |____| | | | (_| | | (_) | | ____) | (__| | | | |_) | |_
# |______|_| |_|\__,_| \___/|_| |_____/ \___|_| |_| .__/ \__|
# | |
# |_|
################################################################################
################################################################################
# created with help of http://patorjk.com/software/taag/
#>

#endregion