Get-EnvironmentVariable

Windows: Retrieves environment variables from specified scopes

Script

#Requires -Version 5.1

[CmdletBinding()]
Param (
    [string]$Name = "*",

    [ValidateSet('Machine', 'User', 'Process')]
    [string]$Scope = 'Process',

    [string]$ComputerName = $env:COMPUTERNAME,

    [pscredential]$Credential
)

Process {
    try {
        $scriptBlock = {
            Param($VarName, $VarScope)
            if ($VarScope -eq 'Process') {
                $vars = Get-ChildItem -Path Env: | Where-Object { $_.Name -like $VarName }
                $vars | ForEach-Object {
                    [PSCustomObject]@{
                        Name  = $_.Name
                        Value = $_.Value
                        Scope = 'Process'
                    }
                }
            }
            else {
                $results = [System.Environment]::GetEnvironmentVariables($VarScope)
                $results.Keys | Where-Object { $_ -like $VarName } | ForEach-Object {
                    [PSCustomObject]@{
                        Name  = $_
                        Value = $results[$_]
                        Scope = $VarScope
                    }
                }
            }
        }

        if ($ComputerName -ne $env:COMPUTERNAME) {
            $invokeParams = @{
                'ComputerName' = $ComputerName
                'ScriptBlock'  = $scriptBlock
                'ArgumentList' = @($Name, $Scope)
                'ErrorAction'  = 'Stop'
            }
            if ($null -ne $Credential) {
                $invokeParams.Add('Credential', $Credential)
            }

            $result = Invoke-Command @invokeParams
        }
        else {
            $result = &$scriptBlock -VarName $Name -VarScope $Scope
        }

        $results = foreach ($r in $result) {
            $r | Add-Member -MemberType NoteProperty -Name ComputerName -Value $ComputerName -PassThru
        }

        Write-Output ($results | Sort-Object Name)
    }
    catch {
        throw
    }
}

Customize

Name string

Specifies the name of the environment variable to retrieve. Supports wildcards.

Scope string

Specifies the scope to query: Machine, User, or Process. Defaults to Process.

ComputerName string

Specifies the name of the target computer. Defaults to the local computer.

env string

Credential pscredential

Specifies a PSCredential object for remote connection.