Private/Assert-RunAsAdministrator.ps1
|
<#
.SYNOPSIS Verifies if current user context has Administrator privileges. .DESCRIPTION Checks whether the current PowerShell session is running with elevated (Administrator) privileges. Throws a terminating error if not elevated. .EXAMPLE Assert-RunAsAdministrator Verifies the session is elevated; throws if not. .OUTPUTS None. Throws a terminating error if not running as Administrator. .NOTES Author: Tom de Leeuw Website: https://systom.dev #> function Assert-RunAsAdministrator { [CmdletBinding()] [OutputType([void])] param() process { $CurrentUser = New-Object Security.Principal.WindowsPrincipal( [Security.Principal.WindowsIdentity]::GetCurrent() ) if ($CurrentUser.IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)) { Write-Verbose 'Script is running with Administrator privileges.' } else { $ErrorRecord = [System.Management.Automation.ErrorRecord]::new( [System.UnauthorizedAccessException]::new('Script/function is NOT running with Administrator privileges. Please re-run as Administrator.'), 'NotElevated', [System.Management.Automation.ErrorCategory]::PermissionDenied, $null ) $PSCmdlet.ThrowTerminatingError($ErrorRecord) } } } |