Skip to content
Switch branches/tags
Go to file
1 contributor

Users who have contributed to this file

# Author: Miodrag Milic <>
# Last Change: 14-Aug-2015.
#requires -version 2.0
Get or set system proxy properties.
This function implements unified method to set proxy system wide settings.
It sets both WinINET ("Internet Options" proxy) and WinHTTP proxy.
Without any arguments function will return the current proxy properties.
To change a proxy property pass adequate argument to the function.
Update-Proxy -Server "" -Override "" -ShowGUI
Set proxy server, clear overrides and show IE GUI.
Update-Proxy | Export-CSV proxy; Import-CSV proxy | Update-Proxy -Verbose
Save and restore proxy properties
$p = Update-Proxy; $p.Override += $p.Override += "*" ; $p | proxy
Add "*" to the proxy override list
The format of the parameters is the same as seen in Internet Options GUI.
To bypass proxy for a local network specify keyword ";<local>" at the end
of the Overide values.
Setting the winhttp proxy requires administrative prvilegies.
function Update-Proxy() {
# Proxy:Port
[Parameter(ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)]
[string] $Server,
# Semicollon delimited list of exlusions
[string] $Override,
# 0 to disable, anything else to enable proxy
[string] $Enable,
# Show Internet Options GUI
[switch] $ShowGUI
$key = "HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings"
$r = gp $key
Write-Verbose "Reading proxy data from the registry"
Server = if ($PSBoundParameters.Keys -contains 'Server') {$Server} else { $r.ProxyServer }
Override = if ($PSBoundParameters.Keys -contains 'Override') {$Override} else { $r.ProxyOverride }
Enable = if ($PSBoundParameters.Keys -contains 'Enable') {$Enable} else { $r.ProxyEnable }
$set = "Server","Override","Enable" | ? {$PSBoundParameters.Keys -contains $_ }
if ($set) {
#if (!(test-admin)) { throw "Setting proxy requires admin privileges" }
Write-Verbose "Saving proxy data to registry"
sp $key ProxyServer $proxy.Server
sp $key ProxyOverride $proxy.Override
sp $key ProxyEnable $proxy.Enable
if (!(refresh-system)) { Write-Warning "Can not force system refresh after proxy change" }
Write-Verbose "Importing winhttp proxy from IE settings"
$OFS = "`n"
[string]$res = netsh.exe winhttp import proxy source=ie
if ($res -match 'Access is denied') {Write-Warning $res}
else { Write-Verbose $res.Trim()}
New-Object PSCustomObject -Property $proxy
if ($ShowGUI) { start control "inetcpl.cpl,,4" }
# The registry changes aren't seen until system is notified about it.
# Without this function you need to open Internet Settings window for changes to take effect. See
function refresh-system() {
$signature = @'
[DllImport("wininet.dll", SetLastError = true, CharSet=CharSet.Auto)]
public static extern bool InternetSetOption(IntPtr hInternet, int dwOption, IntPtr lpBuffer, int dwBufferLength);
$type = Add-Type -MemberDefinition $signature -Name wininet -Namespace pinvoke -PassThru
$a = $type::InternetSetOption(0, $INTERNET_OPTION_SETTINGS_CHANGED, 0, 0)
$b = $type::InternetSetOption(0, $INTERNET_OPTION_REFRESH, 0, 0)
return $a -and $b
Set-Alias proxy Update-Proxy