Bitsadmin /util /setieproxy

Article
04/18/2012

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

Set proxy settings to use when transferring files using a service account.

Syntax

bitsadmin /Util /GetIEProxy <Account> <Usage>[/Conn <ConnectionName>]

Parameters

Parameter	Description
Account	Specifies the service account whose proxy settings you want to retrieve. Possible values are: LOCALSYSTEM NETWORKSERVICE LOCALSERVICE
Usage	Specifies the form of proxy detection to use. Possible values are: NO_PROXY—Do not use a proxy server. AUTODETECT—Automatically detect the proxy settings. MANUAL_PROXY—Use an explicit proxy list and bypass list. Specify the proxy list and bypass list immediately following the usage tag. For example, MANUAL_PROXY proxy1,proxy2 NULL. The proxy list is a semicolon or space delimited list of proxy servers to use. The bypass list is 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. AUTOSCRIPT— Same as AUTODETECT, except it also executes a script. Specify the script URL immediately following the usage tag. For example, AUTOSCRIPT https://server/proxy.js.
ConnectionName	Optional—used with the /Conn command to specify the use of a modem connection. If you do not specify the /Conn command, BITS uses the LAN connection. Specify the modem connection name immediately following the /Conn parameter.

Account

Specifies the service account whose proxy settings you want to retrieve. Possible values are:

LOCALSYSTEM
NETWORKSERVICE
LOCALSERVICE

Usage

Specifies the form of proxy detection to use. Possible values are:

NO_PROXY—Do not use a proxy server.
AUTODETECT—Automatically detect the proxy settings.
MANUAL_PROXY—Use an explicit proxy list and bypass list. Specify the proxy list and bypass list immediately following the usage tag. For example, MANUAL_PROXY proxy1,proxy2 NULL.
- The proxy list is a semicolon or space delimited list of proxy servers to use.
- The bypass list is 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.
AUTOSCRIPT— Same as AUTODETECT, except it also executes a script. Specify the script URL immediately following the usage tag. For example, AUTOSCRIPT https://server/proxy.js.

ConnectionName

Optional—used with the /Conn command to specify the use of a modem connection. If you do not specify the /Conn command, BITS uses the LAN connection. Specify the modem connection name immediately following the /Conn parameter.

Remarks

Each successive call using this command replaces the previously specified usage but not the parameters of the previously defined usage. For example, if you specify NO_PROXY, AUTODETECT, and MANUAL_PROXY on separate calls, BITS uses the last supplied usage but keeps the parameters from the previously defined usage.

Important

You must run this command from an elevated command prompt for it to complete successfully.

Examples

The following example sets the proxy usage for the NETWORK SERVICE account.

C:\>bitsadmin /Util /SetIEProxy localsystem AUTODETECT

Additional references

Command-Line Syntax Key

Share via