SetIEMode command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "__TOC__ {| |width="50%"| '''Action:''' |width="50%"| <span class="f_Para">Controls whether, and the host URLs for which, the Debugger will serve as the </span><span class="f...")
 
No edit summary
Line 33: Line 33:
<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>
<span class="f_Para">For parameter options that modify the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> modifications at Client startup, then removes them when the Client closes). </span>


<span class="f_Para">Example: </span>
'''Example:'''


<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> initial settings: </span>
<span class="f_Para">If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_Para"> initial settings: </span>
Line 43: Line 43:
<span class="f_Para">See also: </span>
<span class="f_Para">See also: </span>


*<span class="f_ListBul1">The </span><span class="f_Monospace">[[generatepac_cmd.html|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>
*<span class="f_ListBul1">The </span><span class="f_Monospace">[[GeneratePac command|generatePac]]</span><span class="f_ListBul1"> command, which creates and/or merges a PAC file, but makes no modifications to </span><span class="f_Para">the </span><span class="f_GUIlabel">Internet Properties</span><span class="f_ListBul1"> configuration settings. </span>


*<span class="f_ListBul1">The </span><span class="f_Monospace">[[showie_cmd.html|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>
*<span class="f_ListBul1">The </span><span class="f_Monospace">[[SowIE command|showIE]]</span><span class="f_ListBul1"> command, which displays the current Internet connection settings plus additional details. </span>


*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[retryhttppac_cmd.html|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>
*<span class="f_ListBul1">The </span><span class="f_CodeExample">[[RetryHttpPac command|retryHttpPac]]</span><span class="f_ListBul1"> command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file. </span><span class="f_CodeExample"> </span>
|-
|-
| '''Client menu:'''
| '''Client menu:'''

Revision as of 17:56, 9 July 2022

Action:

Controls whether, and the host URLs for which, the Debugger will serve as the proxy server for users of the Internet Explorer or Chrome browser. The command has options to set or remove the setting of the Client as the proxy server for IE or Chrome browser requests. The command also has an option to create a PAC (Proxy Auto Config) file, which restricts the host URLs for which the Client will act as proxy server, and an option to merge such a PAC file with a preexisting PAC file, if any.

Syntax:

setIEMode {none|proxy|newPac|mergedPac} [file|http]

Where:

  • none
    • Makes no changes to the Internet Properties tool, which contains configuration settings for Internet Explorer and Chrome browsers, and undoes any such setting changes made since the Debugger Client was started.
This option also undoes the effects of any other setIEMode commands issued since the Client was started.
  • proxy
    • Makes the Debugger Client the proxy server for Internet Explorer and Chrome. This is the same as setting the Preferences dialog box equivalent, the proxy option for IE Mode.
  • newPac
    • Generates a PAC file using the hosts and ports specified in the Debugger configuration file (debuggerConfig.xml) settings, and sets IE and Chrome to use it. Any existing PAC file (that is, specified in the Internet Properties tool) is not used.
  • mergedPac
    • Merges any existing PAC file with a PAC file generated from the Debugger configuration file settings, and sets IE and Chrome to use it.
  • file or http

If you are using newPac or mergedPac to produce a PAC, specifying file or http sets the type of the URL that is sent to the browser. file is the default.

To take advantage of an http setting, you must also configure an HTTP server to service the PAC file.

For parameter options that modify the Internet Properties configuration, no restart of the browser is necessary, and the Debugger provides automatic maintenance (makes the Internet Properties modifications at Client startup, then removes them when the Client closes).

Example:

If you issue the following command, the Debugger Client immediately generates a merged PAC file and configures the browser to run it; then at Client shutdown, the command restores the Internet Properties initial settings:

 setIEMode mergedPac 

Once the above command is issued, the browser runs the script each time a URL is requested, and the Debugger Client serves as proxy only for the hosts specified in the script. The merged PAC file specification will persist through Client closes and starts until you use setIEMode or the Preferences dialog box to change or remove it.

See also:

  • The generatePac command, which creates and/or merges a PAC file, but makes no modifications to the Internet Properties configuration settings.
  • The showIE command, which displays the current Internet connection settings plus additional details.
  • The retryHttpPac command, which verifies whether your HTTP PAC server is working and pointed to from the Client configuration file.
Client menu: --
Introduced: Build 62