cookbook 'ie', '= 2.1.0'
ie (7) Versions 2.1.0 Follow1
Configures Internet Explorer browser
cookbook 'ie', '= 2.1.0', :supermarket
knife supermarket install ie
knife supermarket download ie
IE Cookbook
The following recipes are available for configuring Internet Explorer:
- BFCache - Enable/Disable IE Feature Back-Forward Cache
- ESC - Enable/Disable IE Enhanced Security Configuration
- FirstRun - Enable/Disable IE 8 & 9 First Run Set Up Pop-up
- Zone - Configure IE Security Zones; Local Home, Internet, Local Internet, Trusted Sites, and Restricted Sites
- Zoom - Configure IE Zoom Level
A ie_version
method is also available to retrieve the exact version of Internet Explorer installed.
Tested against:
- IE 11 on Windows Server 2012 R2
- IE 10 on Windows Server 2012
- IE 9 on Windows Server 2008 R1 SP2
Requirements
- Chef 11.6.0 or higher (includes a built-in registry_key resource)
Platforms
- Windows
Usage
See ie_test cookbook for examples.
Include ie
as a dependency to make ie_version
method available. Note that there is no default recipe.
A library method ie_version
is provided to retrieve the IE version installed:
v = ie_version
Tip: use allow_any_instance_of
to stub ie_version method when testing with rspec:
allow_any_instance_of(Chef::Recipe).to receive(:ie_version).and_return('11.0.0.0')
BFCache
Enable/Disable IE Feature Back-Forward Cache. Allows drivers to maintain a connection to IE.
Attributes
-
node['ie']['bfcache']
- Defaults totrue
(enabled)
Example
Enable bfcache:
include_recipe 'ie::bfcache'
ESC
Enable/Disable Internet Explorer Enhanced Security Configuration (ESC).
Attributes
-
node['ie']['esc']
- Defaults tofalse
(disabled)
Example
Disable enhanced security configuration:
include_recipe 'ie::esc'
FirstRun
Enable/Disable Internet Explorer 8 & 9 First Run Set Up Pop-up.
Attributes
-
node['ie']['firstrun']
- Defaults tofalse
(disabled)
Example
Disable first run:
include_recipe 'ie::firstrun'
Zone
Configure IE Security Zones (REG_DWORD types only); Local Home, Internet, Local Internet, Trusted Sites, and
Restricted Sites.
See Zones section in http://support.microsoft.com/kb/182569 for a complete listing of security zone
settings.
A setting of zero sets a specific action as permitted, a setting of one causes a prompt to appear, and a setting
of three prohibits the specific action.
Attributes
-
node['ie']['zone']['local_home']
- Defaults to{}
-
node['ie']['zone']['internet']
- Defaults to{}
-
node['ie']['zone']['local_internet']
- Defaults{}
-
node['ie']['zone']['trusted_sites']
- Defaults to{}
-
node['ie']['zone']['restricted_sites']
- Defaults to{}
Example
Enable both protected mode for main zones and active scripting for internet zone only:
node.set['ie']['zone']['internet'] = { '1400' => 0, # enable active scripting '2500' => 0 # enable protected mode } node.set['ie']['zone']['local_internet'] = { '2500' => 0 # enable protected mode } node.set['ie']['zone']['trusted_sites'] = { '2500' => 0 # enable protected mode } node.set['ie']['zone']['restricted_sites'] = { '2500' => 0 # enable protected mode } include_recipe 'ie::zone'
Zoom
Configure IE Zoom level.
Attributes
-
node['ie']['zoom']
- Defaults to100_000
(100%)
Example
Set zoom level to 125%:
node.set['ie']['zoom'] = 125_000 include_recipe 'ie::zoom'
Getting Help
- Ask specific questions on Stack Overflow.
- Report bugs and discuss potential features in Github issues.
Contributing
Please refer to CONTRIBUTING.
License
MIT - see the accompanying LICENSE file for details.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
Changelog
2.1.0
- Add IE first run
2.0.0
- Configure IE for all users via Active Setup
- Add IE zoom level
1.0.2
- Update ie_version to support older IE browsers
1.0.1
- Do not set group policy in security zones recipe
1.0.0
- Initial release
Foodcritic Metric
2.1.0 passed this metric
2.1.0 passed this metric