functions/PathUtilities.ps1
|
Function Get-PathVariable { [cmdletbinding()] [OutputType("EnvPath")] Param( [ValidateSet("All", "User", "Machine")] [string]$Scope = "All" ) Write-Verbose "Starting $($myinvocation.MyCommand)" #private helper function to create the custom object Function NewEnvPath { [cmdletbinding()] Param( [Parameter(ValueFromPipeline)] [string]$Path, [string]$Scope ) Process { [pscustomobject]@{ PSTypeName = "EnvPath" Scope = $Scope Computername = [System.Environment]::MachineName UserName = [System.Environment]::UserName Path = $path Exists = Test-Path $Path } } } #newEnvPath $user = { Write-Verbose "Getting USER paths" #filter out blanks if path ends in a splitter $paths = [System.Environment]::GetEnvironmentVariable("PATH", "User") -split $splitter | Where-Object { $_ } Write-Verbose "Found $($paths.count) path entries" $paths | NewEnvPath -Scope User } $machine = { Write-Verbose "Getting MACHINE paths" $paths = [System.Environment]::GetEnvironmentVariable("PATH", "Machine") -split $splitter | Where-Object { $_ } Write-Verbose "Found $($paths.count) path entries" $paths | NewEnvPath -Scope Machine } $lx = { Write-Verbose "Getting ALL paths (Non-Windows)" $paths = [System.Environment]::GetEnvironmentVariable("PATH", "Process") -split $splitter | Where-Object { $_ } Write-Verbose "Found $($paths.count) path entries" $paths | NewEnvPath -scope "Process" } Write-Verbose "Using scope setting of $Scope" #get the path separator character specific to this operating system $splitter = [System.IO.Path]::PathSeparator if ($IsLinux -OR $IsMacOS) { Invoke-Command -scriptblock $lx } elseif ($scope -eq "User") { Invoke-Command -scriptblock $user } elseif ($scope -eq "Machine") { Invoke-Command -scriptblock $machine } else { Write-Verbose "Getting ALL paths (Windows)" $paths = @() $paths += Invoke-Command -scriptblock $user $paths += Invoke-Command -scriptblock $machine Write-Verbose "Found $($paths.count) path entries" $paths } Write-Verbose "Ending $($myinvocation.MyCommand)" } #end function |