public/Get-IsElevateAsAdmin.ps1

<#
    .SYNOPSIS
    Determines if the current user has administrative privileges.

    .DESCRIPTION
    The Get-IsElevatedAsAdmin function determines if the current user has administrative privileges by using the .NET Framework to check the Windows built-in role of the current Windows identity. The function returns a Boolean value indicating whether the current user is a member of the 'Administrator' role.

    .EXAMPLE
    Get-IsElevatedAsAdmin

    This example returns $True if the current user has administrative privileges, or $False if the current user does not have administrative privileges.

    .OUTPUTS
    System.Boolean. $True if the current user has administrative privileges, or $False if the current user does not have administrative privileges.

    .NOTES
    None.

    .FUNCTIONALITY
    Checking the current user's Windows built-in role.
#>

function Get-IsElevatedAsAdmin {
    $isElevatedAsAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator')

    return $isElevatedAsAdmin
}