mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-12 05:17:22 +00:00
272 lines
13 KiB
Markdown
272 lines
13 KiB
Markdown
---
|
||
ms.localizationpriority: medium
|
||
ms.mktglfcycl: deploy
|
||
ms.pagetype: appcompat
|
||
description: Use the Enterprise Mode Site List Manager to create and update your Enterprise Mode site list for devices running Windows 7 or Windows 8.1 Update.
|
||
author: dansimp
|
||
ms.prod: ie11
|
||
ms.assetid: 17c61547-82e3-48f2-908d-137a71938823
|
||
ms.reviewer:
|
||
audience: itpro
|
||
manager: dansimp
|
||
ms.author: dansimp
|
||
title: Enterprise Mode schema v.1 guidance (Internet Explorer 11 for IT Pros)
|
||
ms.sitesec: library
|
||
ms.date: 07/27/2017
|
||
---
|
||
|
||
|
||
# Enterprise Mode schema v.1 guidance
|
||
|
||
[!INCLUDE [Microsoft 365 workloads end of support for IE11](../includes/microsoft-365-ie-end-of-support.md)]
|
||
|
||
|
||
**Applies to:**
|
||
|
||
- Windows 10
|
||
- Windows 8.1
|
||
- Windows 7
|
||
|
||
Use the Enterprise Mode Site List Manager (schema v.1) to create and update your Enterprise Mode site list for devices running the v.1 version of the schema, or the Enterprise Mode Site List Manager (schema v.2) to create and update your Enterprise Mode site list for devices running the v.2 version of the schema. We strongly recommend moving to the new schema, v.2. For more info, see [Enterprise Mode schema v.2 guidance](enterprise-mode-schema-version-2-guidance.md).
|
||
|
||
If you don't want to use the Enterprise Mode Site List Manager, you also have the option to update your XML schema using Notepad, or any other XML-editing app.
|
||
|
||
## Enterprise Mode schema v.1 example
|
||
The following is an example of the Enterprise Mode schema v.1. This schema can run on devices running Windows 7 and Windows 8.1.
|
||
|
||
> [!IMPORTANT]
|
||
> Make sure that you don't specify a protocol when adding your URLs. Using a URL like `<domain>contoso.com</domain>` automatically applies to both http://contoso.com and https://contoso.com.
|
||
|
||
```xml
|
||
<rules version="1">
|
||
<emie>
|
||
<domain exclude="false">www.cpandl.com</domain>
|
||
<domain exclude="true">www.woodgrovebank.com</domain>
|
||
<domain exclude="false" forceCompatView="true">adatum.com</domain>
|
||
<domain exclude="true">contoso.com</domain>
|
||
<domain exclude="true">relecloud.com
|
||
<path exclude="false">/about</path>
|
||
</domain>
|
||
<domain exclude="false">fabrikam.com
|
||
<path exclude="true">/products</path>
|
||
</domain>
|
||
</emie>
|
||
<docMode>
|
||
<domain>contoso.com
|
||
<path docMode="7">/travel</path>
|
||
</domain>
|
||
<domain>fabrikam.com
|
||
<path docMode="7">/products</path>
|
||
</domain>
|
||
</docMode>
|
||
</rules>
|
||
```
|
||
|
||
### Schema elements
|
||
This table includes the elements used by the Enterprise Mode schema.
|
||
|
||
<table>
|
||
<thead>
|
||
<tr class="header">
|
||
<th>Element</th>
|
||
<th>Description</th>
|
||
<th>Supported browser</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td><rules></td>
|
||
<td>Root node for the schema.
|
||
<p><b>Example</b>
|
||
<pre class="syntax">
|
||
<rules version="205">
|
||
<emie>
|
||
<domain>contoso.com</domain>
|
||
</emie>
|
||
</rules></pre></td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
<tr>
|
||
<td><emie></td>
|
||
<td>The parent node for the Enterprise Mode section of the schema. All <domain> entries will have either IE8 Enterprise Mode or IE7 Enterprise Mode applied.
|
||
<p><b>Example</b>
|
||
<pre class="syntax">
|
||
<rules version="205">
|
||
<emie>
|
||
<domain>contoso.com</domain>
|
||
</emie>
|
||
</rules></pre>
|
||
<strong>-or-</strong>
|
||
<p>For IPv6 ranges:<pre class="syntax"><rules version="205">
|
||
<emie>
|
||
<domain>[10.122.34.99]:8080</domain>
|
||
</emie>
|
||
</rules></pre>
|
||
<strong>-or-</strong>
|
||
<p>For IPv4 ranges:<pre class="syntax"><rules version="205">
|
||
<emie>
|
||
<domain>10.122.34.99:8080</domain>
|
||
</emie>
|
||
</rules></pre></td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
<tr>
|
||
<td><docMode></td>
|
||
<td>The parent node for the document mode section of the section. All <domain> entries will get IE5 - IE11 document modes applied. If there's a <domain> element in the <docMode> section that uses the same value as a <domain> element in the <emie> section, the <emie> element is applied.
|
||
<p><b>Example</b>
|
||
<pre class="syntax">
|
||
<rules version="205">
|
||
<docMode>
|
||
<domain docMode="7">contoso.com</domain>
|
||
</docMode>
|
||
</rules></pre></td>
|
||
<td>Internet Explorer 11</td>
|
||
</tr>
|
||
<tr>
|
||
<td><domain></td>
|
||
<td>A unique entry added for each site you want to put on the Enterprise Mode site list. The first <domain> element will overrule any additional <domain> elements that use the same value for the section. You can use port numbers for this element.
|
||
<p><b>Example</b>
|
||
<pre class="syntax">
|
||
<emie>
|
||
<domain>contoso.com:8080</domain>
|
||
</emie></pre></td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
<tr>
|
||
<td><path></td>
|
||
<td>A unique entry added for each path under a domain you want to put on the Enterprise Mode site list. The <path> element is a child of the <domain> element. Additionally, the first <path> element will overrule any additional <path> elements in the schema section.
|
||
<p><b>Example</b>
|
||
<pre class="syntax">
|
||
<emie>
|
||
<domain exclude="true">fabrikam.com
|
||
<path exclude="false">/products</path>
|
||
</domain>
|
||
</emie></pre><p>
|
||
Where <a href="https://fabrikam.com" data-raw-source="https://fabrikam.com">https://fabrikam.com</a> doesn't use IE8 Enterprise Mode, but <a href="https://fabrikam.com/products" data-raw-source="https://fabrikam.com/products">https://fabrikam.com/products</a> does.</td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
</table>
|
||
|
||
### Schema attributes
|
||
This table includes the attributes used by the Enterprise Mode schema.
|
||
|
||
<table>
|
||
<thead>
|
||
<tr class="header">
|
||
<th>Attribute</th>
|
||
<th>Description</th>
|
||
<th>Supported browser</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>version</td>
|
||
<td>Specifies the version of the Enterprise Mode Site List. This attribute is supported for the <rules> element.</td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
<tr>
|
||
<td>exclude</td>
|
||
<td>Specifies the domain or path excluded from applying Enterprise Mode. This attribute is only supported on the <domain> and <path> elements in the <emie> section. If this attribute is absent, it defaults to false.
|
||
<br />
|
||
<p><b>Example:</b></p>
|
||
<pre class="syntax">
|
||
<emie>
|
||
<domain exclude="false">fabrikam.com
|
||
<path exclude="true">/products</path>
|
||
</domain>
|
||
</emie></pre><p>
|
||
Where <a href="https://fabrikam.com" data-raw-source="https://fabrikam.com">https://fabrikam.com</a> uses IE8 Enterprise Mode, but <a href="https://fabrikam.com/products" data-raw-source="https://fabrikam.com/products">https://fabrikam.com/products</a> does not.</p></td>
|
||
<td>Internet Explorer 11</td>
|
||
</tr>
|
||
<tr>
|
||
<td>docMode</td>
|
||
<td>Specifies the document mode to apply. This attribute is only supported on <domain> or <path> elements in the <docMode> section.
|
||
<br />
|
||
<p><b>Example:</b></p>
|
||
<pre class="syntax">
|
||
<docMode>
|
||
<domain>fabrikam.com
|
||
<path docMode="9">/products</path>
|
||
</domain>
|
||
</docMode></pre><p>
|
||
Where <a href="https://fabrikam.com" data-raw-source="https://fabrikam.com">https://fabrikam.com</a> loads in IE11 document mode, but <a href="https://fabrikam.com/products" data-raw-source="https://fabrikam.com/products">https://fabrikam.com/products</a> uses IE9 document mode.</p></td>
|
||
<td>Internet Explorer 11</td>
|
||
</tr>
|
||
<tr>
|
||
<td>doNotTransition</td>
|
||
<td>Specifies that the page should load in the current browser, otherwise it will open in IE11. This attribute is supported on all <domain> or <path> elements. If this attribute is absent, it defaults to false.
|
||
<br />
|
||
<p><b>Example:</b></p>
|
||
<pre class="syntax">
|
||
<emie>
|
||
<domain doNotTransition="false">fabrikam.com
|
||
<path doNotTransition="true">/products</path>
|
||
</domain>
|
||
</emie></pre><p>
|
||
Where <a href="https://fabrikam.com" data-raw-source="https://fabrikam.com">https://fabrikam.com</a> opens in the IE11 browser, but <a href="https://fabrikam.com/products" data-raw-source="https://fabrikam.com/products">https://fabrikam.com/products</a> loads in the current browser (eg. Microsoft Edge).</p></td>
|
||
<td>Internet Explorer 11 and Microsoft Edge</td>
|
||
</tr>
|
||
<tr>
|
||
<td>forceCompatView</td>
|
||
<td>Specifies that the page should load in IE7 document mode (Compat View). This attribute is only supported on <domain> or <path> elements in the <emie> section. If the page is also configured to load in Enterprise Mode, it will load in IE7 Enterprise Mode. Otherwise (exclude="true"), it will load in IE11's IE7 document mode. If this attribute is absent, it defaults to false.
|
||
<br />
|
||
<p><b>Example:</b></p>
|
||
<pre class="syntax">
|
||
<emie>
|
||
<domain exclude="true">fabrikam.com
|
||
<path forceCompatView="true">/products</path>
|
||
</domain>
|
||
</emie></pre><p>
|
||
Where <a href="https://fabrikam.com" data-raw-source="https://fabrikam.com">https://fabrikam.com</a> does not use Enterprise Mode, but <a href="https://fabrikam.com/products" data-raw-source="https://fabrikam.com/products">https://fabrikam.com/products</a> uses IE7 Enterprise Mode.</p></td>
|
||
<td>Internet Explorer 11</td>
|
||
</tr>
|
||
</table>
|
||
|
||
### Using Enterprise Mode and document mode together
|
||
If you want to use both Enterprise Mode and document mode together, you need to be aware that <emie> entries override <docMode> entries for the same domain.
|
||
|
||
For example, say you want all of the sites in the contoso.com domain to open using IE8 Enterprise Mode, except test.contoso.com, which needs to open in document mode 11. Because Enterprise Mode takes precedence over document mode, if you want test.contoso.com to open using document mode, you'll need to explicitly add it as an exclusion to the <emie> parent node.
|
||
|
||
```xml
|
||
<rules version="1">
|
||
<emie>
|
||
<domain exclude="false">contoso.com</domain>
|
||
<domain exclude="true">test.contoso.com</domain>
|
||
</emie>
|
||
<docMode>
|
||
<domain docMode="11">test.contoso.com</domain>
|
||
</docMode>
|
||
</rules>
|
||
```
|
||
|
||
### What not to include in your schema
|
||
We recommend that you not add any of the following items to your schema because they can make your compatibility list behave in unexpected ways:
|
||
- Don’t use protocols. For example, `http://`, `https://`, or custom protocols. They break parsing.
|
||
- Don’t use wildcards.
|
||
- Don’t use query strings, ampersands break parsing.
|
||
|
||
## How to use trailing slashes
|
||
You can use trailing slashes at the path-level, but not at the domain-level:
|
||
- **Domain-level.** Don’t add trailing slashes to a domain, it breaks parsing.
|
||
- **Path-level.** Adding a trailing slash to a path means that the path ends at that point. By not adding a trailing slash, the rule applies to all of the sub-paths.
|
||
|
||
**Example**
|
||
|
||
```xml
|
||
<domain exclude="true">contoso.com
|
||
<path exclude="false">/about/</path>
|
||
</domain>
|
||
```
|
||
In this example, `contoso.com/about/careers` will use the default version of Internet Explorer, even though `contoso.com/about/` uses Enterprise Mode.
|
||
|
||
|
||
## How to target specific sites
|
||
If you want to target specific sites in your organization.
|
||
|
||
|Targeted site |Example |Explanation |
|
||
|--------------|--------|------------|
|
||
|You can specify subdomains in the domain tag. |<code><docMode><br><domain docMode="5">contoso.com</domain><br><domain docMode="9">info.contoso.com</domain><br><docMode></code> |<ul><li>contoso.com uses document mode 5.</li><li>info.contoso.com uses document mode 9.</li><li>test.contoso.com also uses document mode 5.</li></ul>|
|
||
|You can specify exact URLs by listing the full path. |<code><emie><br><domain exclude="false">bing.com</domain><br><domain exclude="false" forceCompatView="true">contoso.com</domain><br><emie></code>|<ul><li>bing.com uses IE8 Enterprise Mode.</li><li>contoso.com uses IE7 Enterprise Mode.</li></ul>|
|
||
|You can nest paths underneath domains. |<code><emie><br><domain exclude="true">contoso.com<br><path exclude="false">/about</path><br><path exclude="true"><br>/about/business</path><br></domain><br></emie></code> |<ul><li>contoso.com will use the default version of IE.</li><li>contoso.com/about and everything underneath that node will load in Enterprise Mode, except contoso.com/about/business, which will load in the default version of IE.</li></ul> |
|
||
|You can’t add a path underneath a path. The file will still be parsed, but the sub-path will be ignored. |<code><emie><br><domain exclude="true">contoso.com<br><path>/about<br><path exclude="true">/business</path><br></path><br></domain><br></emie></code> |<ul><li>contoso.com will use the default version of IE.</li><li>contoso.com/about and everything underneath that node will load in Enterprise Mode, including contoso.com/about/business because the last rule is ignored.</li></ul> |
|