Utils/AdminTools.ps1
|
<# .NOTES =========================================================================== Created with: SAPIEN Technologies, Inc., PowerShell Studio 2019 v5.6.156 Created on: 1/28/2019 12:23 Created by: jisodl0 Organization: J.B. Hunt Filename: AdminTools.ps1 =========================================================================== .DESCRIPTION Contains various functions for admin use in PowerShell. #> <# .SYNOPSIS Launch a PowerShell console as an Administrator. .DESCRIPTION Launches a PowerShell console as an Administrator by using "Start-Process PowerShell -Verb runAs". .EXAMPLE PS C:\> Start-PowerShellAsAdmin #> function Start-PowerShellAsAdmin { [CmdletBinding()] [Alias('AdminPosh')] param () Start-Process PowerShell -Verb runAs } <# .SYNOPSIS Determines if the current process has administrator rights. .DESCRIPTION Determines if the current process has administrator rights and returns true or false. .EXAMPLE PS C:\> Get-IsUserAdmin False .EXAMPLE PS C:\> AmIAdmin True .NOTES Whether or not the process is an admin is done by checking if the current identity is part of the built in Windows Administrator role. #> function Get-IsUserAdmin { [CmdletBinding()] [Alias('AmIAdmin', 'IsAdmin')] param () return ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(` [Security.Principal.WindowsBuiltInRole] "Administrator") } |