public/Invoke-ElevatePowerShellAsAdmin.ps1
|
<# .SYNOPSIS Checks the current user's permissions and if they are not an administrator, attempts to elevate the PowerShell session to run with administrator privileges. .DESCRIPTION The Invoke-ElevatePowerShellAsAdmin function checks whether the current user has administrative privileges. If they do not, the function attempts to elevate the PowerShell session to run with administrator privileges by invoking the PowerShell script with admin rights. This operation requires at least Windows Vista. If the user already has administrative privileges, a message is displayed and no action is taken. .INPUTS None. .OUTPUTS None. This function does not return a value. .EXAMPLE Invoke-ElevatePowerShellAsAdmin Attempts to elevate the current PowerShell session to run with administrator privileges. .NOTES This function requires at least Windows Vista to elevate the session. If the OS is older than Windows Vista, the function will display a message and will not attempt to elevate the session. #> function Invoke-ElevatePowerShellAsAdmin { if (-Not (Test-IsElevatedAsAdmin)) { Write-Host 'Elevating PowerShell session to run with administrator privileges...' if ([int](Get-CimInstance -Class Win32_OperatingSystem | Select-Object -ExpandProperty BuildNumber) -ge 6000) { $scriptFilename = Get-InvocationScript Invoke-PowerShellAsAdmin -Script $scriptFilename Exit } else { Write-Error 'Elevation requires Windows Vista or later.' -ErrorAction Stop } } else { Write-Warning 'The current user already has administrator privileges.' } } |