lib/poshy-env-var.0.6.0/src/Get-EnvPathItem.ps1

#!/usr/bin/env pwsh
$ErrorActionPreference = "Stop"
Set-StrictMode -Version Latest


<#
.SYNOPSIS
    Gets the path entries of the environment variable `PATH` at the given environment variable scope.
.PARAMETER Process
    Gets the path entries of the environment variable `PATH` at the Process-level environment variable scope.
.PARAMETER User
    Gets the path entries of the environment variable `PATH` at the User-level environment variable scope.
.PARAMETER Machine
    Gets the path entries of the environment variable `PATH` at the Machine-level environment variable scope.
.PARAMETER Scope
    The scope of the environment variable from which the path entries will be retrieved.
.OUTPUTS
    string
.COMPONENT
    env
#>

function Get-EnvPathItem() {
    [CmdletBinding(DefaultParameterSetName = "ProcessScopeForValue")]
    param(
        [Parameter(Mandatory=$true, ParameterSetName="MachineScopeForValue", Position=0)]
        [switch] $Machine,

        [Parameter(Mandatory=$true, ParameterSetName="ProcessScopeForValue", Position=0)]
        [switch] $Process,

        [Parameter(Mandatory=$true, ParameterSetName="UserScopeForValue", Position=0)]
        [switch] $User,

        [Parameter(Mandatory=$true, ParameterSetName="ScopeValueForValue", Position=0)]
        [System.EnvironmentVariableTarget] $Scope
    )

    $new_args = $PSBoundParameters + @{Name="PATH"}
    Get-EnvVarPathItem @new_args
}