The IEZoneSettings
object provides a scripting interface to settings of Internet Explorer’s security zone. To obtain the object in scripts, use the GetZoneSettingsById
or GetZoneSettingsByUrl
methods of the IEZoneSettingsManager
object.
The object properties correspond to the security zone settings that are displayed in the Security Settings dialog of Internet Explorer (to display it, select Tools | Internet Options from Internet Explorer’s menu, switch to the Security page and click Custom Level).
Below is a list of object properties with brief descriptions. The properties are ordered by the Internet Explorer setting groups’ and settings’ names.
Two properties do not correspond to Internet Explorer settings:
Property | Description |
---|---|
ZoneId |
Integer. Read-Only. Specifies the identifier of the zone, to which the given IEZoneSettings object corresponds. |
ZoneName |
String. Read-Only. Specifies the name of the zone, to which the given IEZoneSettings object corresponds. |
.NET Framework
Loose XAML
LooseXAML
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
XAML Browser Applications
WinFXBrowserApplications
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
XPS Documents
XPSDocuments
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
.NET Framework-reliant components
Run components not signed with Authenticode
RunNotSignedDotNETComponents
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Run components signed with Authenticode
RunSignedDotNETComponents
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
ActiveX controls and plugins
Only allow approved domains to use ActiveX without prompt
AllowActiveXControlsToRunWithoutPromptInApprovedDomains
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Allow previously unused ActiveX controls to run without prompt
AllowUnusedActiveXControlsToRunWithoutPrompt
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Allow Scriptlets
AllowScriptlets
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
Automatic prompting for ActiveX controls
AutoPromptForActiveXControls
.
Boolean. Read/Write.
Binary and script behaviors
BinaryAndScriptBehaviors
. Integer. Read/Write. Possible values:
- (Hex) 00010000 - Administrator approved
- 0 - Enable
- 3 - Disable
Display video and animation on a web page that does not use external media player
DisplayDynSrcImageContent
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Download signed ActiveX controls
DownloadSignedActiveXControls
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Download unsigned ActiveX controls
DownloadUnsignedActiveXControls
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Initialize and run ActiveX controls not marked as safe
ScriptNotSafeActiveXControls
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Run ActiveX controls and plugins
RunActiveXControlsAndPlugIns
. Integer. Read/Write. Possible values:
- (Hex) 00010000 - Administrator approved
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Script ActiveX controls marked safe for scripting
ScriptSafeActiveXControls
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Downloads
Automatic prompting for file downloads
AutoPromptForFileDownload
.
Boolean. Read/Write.
File download
FileDownloadEnabled
.
Boolean. Read/Write.
Font download
FontDownload
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Enable .NET Framework Components Setup
Enable .NET Framework Components Setup
NetFrameworkSetupEnabled
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Java VM
Java Permissions
JavaPermissions
. Integer. Read/Write. Possible values:
- (Hex) 00000000 - Disable Java
- (Hex) 00010000 - High safety
- (Hex) 00020000 - Medium safety
- (Hex) 00030000 - Low safety
- (Hex) 00800000 - Custom
Available in Internet Explorer 10 and later.
File download
FileDownloadEnabled
.
Boolean. Read/Write.
Font download
FontDownload
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Miscellaneous
Access data sources across domains
AccessDataSourcesAcrossDomain
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Allow META REFRESH
AllowMetaRefresh
.
Boolean. Read/Write.
Allow script-initiated windows without size or position constraints
AllowNotConstrainedScriptWindows
.
Boolean. Read/Write.
Allow web sites to open windows without address or status bars
AllowWindowsWithoutAddressOrStatusBars
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Allow web pages to use restricted protocols for active content
AllowRestrictedProtocolsForActiveContent
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Allow scripting of Internet Explorer WebBrowser control
AllowScriptingOfWebbrowserControl
.
Boolean. Read/Write.
Display mixed content
DisplayMixedContent
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Don't prompt for client certificate selection when no certificates or only one certificate exists
SuppressOddCertificateSelectionPrompt
.
Boolean. Read/Write.
Drag and drop or copy and paste files
DragAndDropFiles
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Include local directory path when uploading files to a server
IncludeLocalPathWhenUploadingFiles
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Installation of desktop items
InstallationOfDesktopItems
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Launching applications and unsafe files
LaunchingApplicationsAndUnsafeFiles
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
Launching programs and files in an IFRAME
LaunchingProgramsInIFRAME
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Navigate sub-frames across different domains
NavigateSubFramesAcrossDomains
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Open files based on content, not file extension
OpenFilesBasedOnContent
.
Boolean. Read/Write.
Protected mode
ProtectedMode
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Software channel permissions
SoftwareChannelPermissions
. Integer. Read/Write. Possible values:
- (Hex) 00010000 - High safety
- (Hex) 00020000 - Medium safety
- (Hex) 00030000 - Low safety
Submit nonencrypted form data
SubmitNonencryptedFromData
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Use Phishing Filter
UsePhishingFilter
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Use Pop-up Blocker
UsePopupBlocker
.
Boolean. Read/Write.
Userdata persistence
UserdataPersistence
.
Boolean. Read/Write.
Web sites in less privileged web content zone can navigate into this zone
NavigateFromLowerZoneToThisZone
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Scripting
Active scripting
ActiveScripting
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Allow paste operations via script
AllowScriptPasteOperations
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Allow status bar updates via script
AllowScriptStatusBarUpdates
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
Available in Internet Explorer 10 and later.
Allow websites to prompt for information using scripted windows
AllowInformationPromptUsingScriptedWindows
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Enable XSS filter
EnableXSSFilter
.
Boolean. Read/Write.
Available in Internet Explorer 10 and later.
Scripting of Java applets
ScriptingOfJavaApplets
.
Integer. Read/Write. Possible values:
- 0 - Enable
- 1 - Prompt
- 3 - Disable
User Authentication
Logon
UserAuthentication
. Integer. Read/Write. Possible values:
- 0 - Automatic logon with current username and password
- (Hex) 00010000 - Prompt for user name and password
- (Hex) 00020000 - Automatic logon only in Intranet zone
- (Hex) 00030000 - Anonymous logon
Example
The code below changes the value of the Run ActiveX controls and plugins option, performs some test commands and then restores the option's value at the end of the test.
JavaScript, JScript
function IEZoneDemo()
{
// Obtains the Zone Settings object of the "My Computer" zone
var MyCompZoneID = 0;
var ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID);
// Saves the current value of the option
var currentVal = ieOptions.RunActiveXControlsAndPlugIns;
//Changes the value of the option
ieOptions.RunActiveXControlsAndPlugIns = 1;
// ...
// Performs test commands
// ...
// Restores the option's value
ieOptions.RunActiveXControlsAndPlugIns = currentVal;
}
Python
def IEZoneDemo():
# Obtains the Zone Settings object of the "My Computer" zone
MyCompZoneID = 0
ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID)
# Saves the current value of the option
currentVal = ieOptions.RunActiveXControlsAndPlugIns
#Changes the value of the option
ieOptions.RunActiveXControlsAndPlugIns = 1
# ...
# Performs test commands
# ...
# Restores the option's value
ieOptions.RunActiveXControlsAndPlugIns = currentVal
VBScript
Sub IEZoneDemo()
' Obtains the Zone Settings object of the "My Computer" zone
MyCompZoneIDD = 0
Set ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID)
' Saves the current value of the option
currentVall = ieOptions.RunActiveXControlsAndPlugIns
' Changes the value of the option
ieOptions.RunActiveXControlsAndPlugIns = 1
' ...
' Performs test commands
' ...
' Restores the option's value
ieOptions.RunActiveXControlsAndPlugIns = currentVal
End Sub
DelphiScript
function IEZoneDemo;
var MyCompZoneID, ieOptions, currentVal;
begin
// Obtains the Zone Settings object of the "My Computer" zone
MyCompZoneID := 0;
ieOptions := Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID);
// Saves the current value of the option
currentVal := ieOptions.RunActiveXControlsAndPlugIns;
//Changes the value of the option
ieOptions.RunActiveXControlsAndPlugIns := 1;
// ...
// Performs test commands
// ...
// Restores the option's value
ieOptions.RunActiveXControlsAndPlugIns := currentVal;
end;
C++Script, C#Script
function IEZoneDemo()
{
// Obtains the Zone Settings object of the "My Computer" zone
var MyCompZoneID = 0;
var ieOptions = Options["IEZoneSettings"]["GetZoneSettingsById"](MyCompZoneID);
// Saves the current value of the option
var currentVal = ieOptions["RunActiveXControlsAndPlugIns"];
//Changes the value of the option
ieOptions["RunActiveXControlsAndPlugIns"] = 1;
// ...
// Performs test commands
// ...
// Restores the option's value
ieOptions["RunActiveXControlsAndPlugIns"] = currentVal;
}
See Also
Options.IEZoneSettings
GetZoneSettingsById Method
GetZoneSettingsByUrl Method