Get-EnvironmentVariable.ps1
|
# Copyright © 2017 Chocolatey Software, Inc. # Copyright © 2015 - 2017 RealDimensions Software, LLC # Copyright © 2011 - 2015 RealDimensions Software, LLC & original authors/contributors from https://github.com/chocolatey/chocolatey # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. function Get-EnvironmentVariable { [CmdletBinding()] [OutputType([string])] param( [Parameter(Mandatory=$true)][string] $Name, [Parameter(Mandatory=$true)][System.EnvironmentVariableTarget] $Scope, [Parameter(Mandatory=$false)][switch] $PreserveVariables = $false, [parameter(ValueFromRemainingArguments = $true)][Object[]] $ignoredArguments ) [string] $MACHINE_ENVIRONMENT_REGISTRY_KEY_NAME = "SYSTEM\CurrentControlSet\Control\Session Manager\Environment\"; [Microsoft.Win32.RegistryKey] $win32RegistryKey = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey($MACHINE_ENVIRONMENT_REGISTRY_KEY_NAME) if ($Scope -eq [System.EnvironmentVariableTarget]::User) { [string] $USER_ENVIRONMENT_REGISTRY_KEY_NAME = "Environment"; [Microsoft.Win32.RegistryKey] $win32RegistryKey = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey($USER_ENVIRONMENT_REGISTRY_KEY_NAME) } elseif ($Scope -eq [System.EnvironmentVariableTarget]::Process) { return [Environment]::GetEnvironmentVariable($Name, $Scope) } [Microsoft.Win32.RegistryValueOptions] $registryValueOptions = [Microsoft.Win32.RegistryValueOptions]::None if ($PreserveVariables) { Write-Verbose "Choosing not to expand environment names" $registryValueOptions = [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames } [string] $environmentVariableValue = [string]::Empty try { if ($win32RegistryKey -ne $null) { # Some versions of Windows do not have HKCU:\Environment $environmentVariableValue = $win32RegistryKey.GetValue($Name, [string]::Empty, $registryValueOptions) } } catch { Write-Debug "Unable to retrieve the $Name environment variable. Details: $_" } finally { if ($win32RegistryKey -ne $null) { $win32RegistryKey.Close() } } if ($environmentVariableValue -eq $null -or $environmentVariableValue -eq '') { $environmentVariableValue = [Environment]::GetEnvironmentVariable($Name, $Scope) } return $environmentVariableValue } |