PoshCode Archive  Artifact [6acb37b90f]

Artifact 6acb37b90f465220e5541f4d36e3db4e7ea5538546105ba3ae9f718f14c434d8:

  • File IE-Proxy-Toggle-Silent.ps1 — part of check-in [7e71ce2905] at 2018-06-10 13:16:39 on branch trunk — Immediately toggle the current user’s Internet Explorer proxy settings on/off. Uses a ‘hidden’ Internet Explorer process to trigger the application of the new proxy setting once its been changed in the registry. Accepts a single command line parameter “disable”. If no parameter is given, the proxy is “enabled”. (user: Dan Smith size: 4034)

# encoding: ascii
# api: powershell
# title: IE Proxy Toggle (Silent)
# description: Immediately toggle the current user’s Internet Explorer proxy settings on/off. Uses a ‘hidden’ Internet Explorer process to trigger the application of the new proxy setting once its been changed in the registry. Accepts a single command line parameter “disable”.  If no parameter is given, the proxy is “enabled”.
# version: 1.1
# type: function
# author: Dan Smith
# license: CC0
# function: Start-HiddenIEProcess
# x-poshcode-id: 2897
# x-archived: 2017-05-11T14:37:13
# x-published: 2012-08-05T22:23:00
#
#
# Process command line parameter (if present).
	[bool] $DISABLE_PROXY = $false;
    	foreach ($param in $MyInvocation.UnboundArguments) {
		if ($param -like 'disable') { $DISABLE_PROXY = $true; }
	}
	
# Apply/refresh the organization's default proxy settings.
	[string] $proxyServer   = '###.###.###.###:####';
	[string] $proxyOverride = '*.local;192.168.*;<local>';
	[int]    $migrateProxy  = 1;
	[int]    $proxyHttp11   = 1;
	
	REG ADD """HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings"" /v ""ProxyServer"" /t REG_SZ /d ""$proxyServer"" /f" | Out-Null;
	REG ADD """HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings"" /v ""ProxyOverride"" /t REG_SZ /d ""$proxyOverride"" /f" | Out-Null;
	REG ADD """HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings"" /v ""MigrateProxy"" /t REG_DWORD /d $migrateProxy /f" | Out-Null;
	REG ADD """HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings"" /v ""ProxyHttp1.1"" /t REG_DWORD /d $proxyHttp11 /f" | Out-Null;

<# 
Define a function to start a 'hidden' Internet Explorer process. 
This is needed since there is no easy way to programmatically 'refresh'
the user's proxy settings after they have been changed in the registry.
#>
function Start-HiddenIEProcess () {
	[object] $ieProcess = $null;
	
	# Launch Internet Explorer (use 32-bit version only) in a hidden window.
		if (Test-Path "$env:PROGRAMFILES(X86)\Internet Explorer\iexplore.exe") {	
			$ieProcess = Start-Process -Passthru -FilePath "$env:PROGRAMFILES(X86)\Internet Explorer\iexplore.exe" -WindowStyle Hidden;
		} else {		
			$ieProcess = Start-Process -Passthru -FilePath "$env:PROGRAMFILES\Internet Explorer\iexplore.exe" -WindowStyle Hidden;
		}
	# Wait for Internet Explorer to load fully.
		[int] $count = 10;
		do {
			if (($ieProcess.WaitForInputIdle())) {
				$waiting = $false; # IE is ready.
				$count   = 0;
			} else { 
				Start-Sleep 1;     # Sleep for another second.
				$count--;          # Decrement wait counter.
			}
		} while ($waiting -or ($count -gt 0));
		
	# Check to see if our new process exists.
		if ((Get-Process -Name iexplore -ErrorAction SilentlyContinue)) {
			return $true;
		} else {
			return $false;
		}
} # END

<# 
Define a function to toggle the user's proxy settings by altering the
required registry entry and then forcing a 'refresh' of the proxy status
by utilizing a hidden/temporary Internet Explorer process. 
#>
function Set-ProxyState ([bool] $disable) {
	# Kill existing IE processes.
		Stop-Process -Name iexplore -Force -ErrorAction SilentlyContinue;
		
	# Toggle proxy state.
		if ($disable) {
			Write-Host 'DISABLING user''s proxy settings...';
			REG ADD '"HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v "ProxyEnable" /t REG_DWORD /d 0 /f' | Out-Null; # Disable proxy.
		} else {
			Write-Host 'ENABLING user''s proxy settings...';
			REG ADD '"HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings" /v "ProxyEnable" /t REG_DWORD /d 1 /f' | Out-Null; # Enable proxy.
		}
		
	# Start a new/hidden IE process temporarily.
		Start-HiddenIEProcess;
		
	# Kill existing IE processes.
		Stop-Process -Name iexplore -Force -ErrorAction SilentlyContinue;
		
	Write-Host '[DONE]';
		
	return $null;
} # END

# Toggle the user's proxy settings.
	$null = Set-ProxyState $DISABLE_PROXY;