AdministratorRole.psm1

Set-StrictMode -Version Latest

function Test-AdministratorRole {
  $isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")
  return $isAdmin

  <#
.SYNOPSIS
    Gets a value indicating whether the current user is an administrator.
.DESCRIPTION
    Returns $True or $False, depending on whether the current user is in the built-in Administatrators role
.OUTPUTS
    System.Boolean. Returns a value indicating whether the current user is a administrator
#>
}

function Assert-AdministratorRole {
  param(
    [parameter(position = 0)]
    [string]$errorMessage = "You do not have Administrator rights to run this script!`nPlease re-run this script as an Administrator!"
  );

  $isAdmin = (Test-AdministratorRole)
  if (-not $isAdmin) {
    throw $errorMessage
  }

  <#
.SYNOPSIS
    Asserts that the current user is an administrator.  Throws an error if not.
.DESCRIPTION
    Checks whether the current user is in the built-in Administrator role, and throws an error message if not.
.PARAMETER errorMessage
    The message to throw when the user is not an administrator
#>
}

function Invoke-Elevated {
  param(
    [parameter(position = 0, mandatory)]
    [ScriptBlock] $ScriptBlock
  )

  Start-Process Powershell -Verb runAs $ScriptBlock
  <#
.SYNOPSIS
    Invokes the provided scriptblock as an administrator.
.DESCRIPTION
    Opens a new elevated powershell which runs the provided scriptblock.
.PARAMETER ScriptBlock
    The ScriptBlock to run in the elevated shell.
#>
}

Export-ModuleMember Test-AdministratorRole
Export-ModuleMember Assert-AdministratorRole
Export-ModuleMember Invoke-Elevated