Bitsadmin /setproxysettings

 

Updated: April 17, 2012

Applies To: Windows Vista, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows 8

Sets the proxy settings for the specified job.

bitsadmin /SetProxySettings <Job> <Usage> [List] [Bypass]

Parameter

Description

Job

The job's display name or GUID

Usage

One of the following values:

  • PRECONFIG—use the owner's Internet Explorer defaults.

  • NO_PROXY—do not use a proxy server.

  • OVERRIDE—use an explicit proxy list and bypass list. A proxy and proxy bypass list must follow.

  • AUTODETECT—automatically detect proxy settings.

List

Used when the Usage parameter is set to OVERRIDE—contains a semicolon or space delimited list of proxy servers to use.

Bypass

Used when the Usage parameter is set to OVERRIDE—contains a semicolon or space-delimited list of host names or IP addresses, or both, for which transfers are not to be routed through a proxy. This can be <local> to refer to all servers on the same LAN. Values of NULL or "" may be used for an empty proxy bypass list.

The following example sets the proxy settings for the job named myDownloadJob.

C:\>bitsadmin /SetProxySettings myDownloadJob PRECONFIG
Show: