Public/Add-EnvPath.ps1
|
Function Add-EnvPath { <# .SYNOPSIS Add a Folder to Environment Variable PATH .DESCRIPTION Add Path to Environment Variable PATH for Machine, User or Process scope And removes missing PATH locations .PARAMETER Path Folder to add to PATH .PARAMETER VariableTarget Which Env Path the directory gets added to. Machine, User or Process .INPUTS String - Folder Path .OUTPUTS String - List of the New Path Variable .EXAMPLE Add-EnvPath -Path 'C:\temp' -VariableTarget Machine #> param( [Parameter(Mandatory,ValueFromPipeline)] [ValidateScript({ if (-not (Test-Path -Path $_ -PathType Container)) { throw 'Path must be a Folder' } if (-not ([System.IO.Path]::IsPathRooted($_))) { throw 'Path must be absolute, such as - C:\Program Files\Notepad++' } return $true })] [String[]]$Path, [System.EnvironmentVariableTarget]$VariableTarget = [System.EnvironmentVariableTarget]::Machine ) begin { if (-not (Test-IfAdmin)) { throw 'RUN AS ADMINISTRATOR' } $OldPath = [System.Environment]::GetEnvironmentVariable('PATH',$VariableTarget).Split(';').TrimEnd('\') | Convert-Path -ErrorAction SilentlyContinue $NewPath = [System.Collections.ArrayList]::new() $NewPath.AddRange($OldPath) } process{ foreach($NDir in $Path) { $NDir = (Convert-Path -Path $NDir -ErrorAction SilentlyContinue).TrimEnd('\') if ($NewPath -notcontains $NDir) { $NewPath.Remove($NDir) } else { Write-Warning -Message ('SKIPPING: {0} - was found within - ({1}) PATH' -f $NDir,$VariableTarget) } } } end { [System.Environment]::SetEnvironmentVariable('PATH',(($NewPath | Sort-Object -Unique) -join ';'),$VariableTarget) $Confirm = [System.Environment]::GetEnvironmentVariable('PATH',$VariableTarget).Split(';') return $Confirm } } |