4.1.1 INS File Format
The install.ins file is a file divided into various formatted sections and written using the ANSI character set (ANSI). Each section is designed for a particular purpose, and the entries in a section are name-value pairs separated by a newline character. The name and value are separated by an equal (=) sign. The Augmented Backus-Naur Form (ABNF) definition (as specified in [RFC4234]) for the install.ins file format is as follows:
-
InsFile = *Section Section = SectionLine *ValueLine SectionLine = "[" SectionName "]" LineBreak SectionName = (ALPHA / %d95) *(ALPHA / DIGIT / %d95) ValueLine = ValueName "=" Value LineBreak ValueName = (ALPHA / %d95) *(ALPHA / DIGIT / %d95) Value = String/DquotedString String = 1*%d33-126 DQuotedString = %d34 1*(%d32-33/%d35-126) %d34 LineBreak = %d13.10
The remainder of this section specifies additional restrictions for the SectionName, ValueName, and Value strings, and their interrelationships (for example, a certain ValueName will be legal only after a certain SectionName has appeared). In specifying legal data for Values, the following types are used in this section:
Filename: Indicates that the value is a file name, represented as an ANSI string.
File path: Indicates that the value is the full path name of a file, represented as an ANSI string. It is allowed to be either a local path to a file on the same machine or a UNC path to a file on another machine.
Boolean: Indicates that the value is either 0 or 1 as an ANSI string.
String: Indicates that the value is an ANSI string that does not contain a newline.
URL: Indicates that the value is a URL (for more information, see [RFC3986]).
Numeric: Indicates that the value is an integer between 0 and 2^32-1 expressed in decimal as an ANSI string.
Hexadecimal: Indicates that the value is an integer between 0 and 2^32-1 expressed in hexadecimal as an ANSI string.
Hostname: Indicates that the value is the name of another computer. It is allowed to be either a fully qualified domain name (FQDN) (for more information, see [RFC1035] section 3.1 or [RFC2181] section 11) or a NetBIOS (for more information, see [RFC1001]) name.
IP Address: Indicates that the value is an IPv4 address as an ANSI string (for more information, see [RFC1123] section 2.1).
The following table specifies sections, corresponding names, and data types for the assigned values for the install.ins file. The description and sample value columns are for informative purposes only (not normative purposes). That is, the values of these settings are not to be interpreted by the Group Policy: Internet Explorer Maintenance Extension protocol. These values are merely applied as-is to Internet Explorer, which can interpret them in a way that is independent of what protocol or mechanism was used to configure them.<5>
|
SectionName |
ValueName |
Value type |
Sample value |
Description |
|---|---|---|---|---|
|
[Animation] |
Big_Name |
Filename |
38ani.bmp |
The name of a file containing a large animation to be used by Internet Explorer. This is equal to the last component of the Big_Path entry. |
|
|
Big_Path |
File path |
C:\My Documents\Branding\38ani.bmp |
The full path (local or remote) of a file containing an animation to be used by Internet Explorer. The file name component is equal to the value of the Big_Name entry. |
|
|
DoAnimation |
Boolean |
1 |
Indicates whether or not Internet Explorer is to customize the animation. |
|
|
Small_Name |
Filename |
22ani.bmp |
File name of bitmap file that contains the frames for the 22x22 animation. |
|
|
Small_Path |
File path |
C:\My Documents\Branding\22ani.bmp |
Full path to the 22x22 icon animation bitmap file. |
|
[ActiveSetup] |
WizardBitmap |
File path |
C:\My Documents\Branding\wizard.bmp |
Full path of a bitmap file that can be displayed by the Internet Explorer Setup Wizard. |
|
|
WizardBitmapTop |
File path |
C:\My Documents\Branding\wizardtop.bmp |
Full path of a bitmap file that can be displayed by the Internet Explorer Setup Wizard. |
|
|
WizardTitle |
String |
Custom Browser Setup |
Text to appear in the Internet Explorer Setup Wizard title bar. |
|
[ActiveSetupSites] |
SiteName0 |
String |
Microsoft Download Page |
Friendly name of the download site to be used by Internet Explorer. |
|
|
SiteRegion0 |
String |
Northwest Region |
Friendly name of the geographical region in which the download site is located. |
|
|
SiteURL0 |
URL |
http://www.microsoft.com/ie5/download/northwest |
URL of the download site. |
|
[Big_Logo] |
Name |
Filename |
static38x38.bmp |
Name of the bitmap file containing an icon that can be displayed by Internet Explorer. |
|
|
Path |
File Path |
C:\My Documents\Branding\static38x38.bmp |
Full path to the bitmap file containing the icon. The file name component is equal to the value of the Name entry above. |
|
[Branding] |
CabsURLPath |
File path |
http://example |
URL path of cabinet files |
|
|
CMBitmapName |
Filename |
|
Connection manager custom bitmap file name to be used by Internet Explorer. |
|
|
CMBitmapPath |
File path |
|
Full path to connection manager custom bitmap file. |
|
|
CMProfileName |
Filename |
|
Name of connection manager profile to be used by Internet Explorer. |
|
|
CMProfilePath |
File path |
|
Full path to connection manager profile. The file name component is equal to the value of the CMProfileName entry above. |
|
|
CMUseCustom |
Boolean |
0 |
Indicates whether or not a custom connection manager profile is to be used by Internet Explorer. |
|
|
CompanyName |
String |
Custom Company Name |
Name of company to be used by Internet Explorer. |
|
|
CompatibilityModeOn |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is to enable Compatibility Mode for all sites. |
|
|
Custom_Key |
String |
MICROSO |
A value of "MICROSO" will cause any custom branding to be removed from Internet Explorer. |
|
|
DisableSuggestedSites |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is to disable the Suggested Sites feature. |
|
|
EncodeFavs |
Boolean |
0 |
A value of 1 indicates that Internet Explorer is to interpret Favorites settings as Internet Explorer 5 did. |
|
|
FavoritesDelete |
Numeric |
0x89 |
Set this value to 0x89 to tell Internet Explorer to remove all pre-existing Favorites. |
|
|
FavoritesOnTop |
Boolean |
1 |
A value of 1 indicates that new Favorites are to be added at the top of the Favorites menu. A value of 0 indicates that new Favorites are to be added at the bottom. |
|
|
IE4 Welcome Msg |
Boolean |
1 |
Indicates to go to a welcome page the first time that the browser is opened. |
|
|
InsVersion |
String |
2010.03.28.02 |
Version of the INS file. |
|
|
Language ID |
Numeric |
1033 |
Code page of the language used by Internet Explorer. |
|
|
Language Locale |
String |
EN |
Friendly name for locale of the version of Internet Explorer being customized. |
|
|
NoDial |
Boolean |
0 |
A value of 1 indicates that Internet Explorer is not to use any kind of an IEAK-based sign-up process. A value of 0 indicates that it is to use an IEAK-based sign-up process.. |
|
|
NoFavoriteBar |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is not to populate the Favorites Bar with default content. |
|
|
NoIELite |
Boolean |
0 |
A value of 1 if the user wants the Internet Explorer Active Setup Wizard to optimize for download, using existing files if possible. |
|
|
NoRSSFeeds |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is not to install default RSS feeds. |
|
|
NoSearchGuide |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is not to offer a link to more search providers. |
|
|
Platform |
Numeric |
6 |
Indicates the platform and architecture being targeted by this package: 32-bit Windows XP = 1, 32-bit Windows Server 2003 = 2, 64-bit Windows Server 2003 = 4, 32-bit Windows Vista = 3, 64-bit Windows Vista = 5, 32-bit Windows 7 = 6, 64-bit Windows 7 = 7. |
|
|
RestartOption |
Numeric |
1 |
A value of 1 indicates that the custom package is to invoke Internet Explorer setup with the "/norestart" argument; a value of 2, with the "/forcerestart" argument. |
|
|
SilentInstall |
Boolean |
1 |
A value of 1 indicates that the custom package is to invoke Internet Explorer setup with the "/passive" argument |
|
|
StealthInstall |
Boolean |
1 |
A value of 1 indicates that the custom package is to invoke Internet Explorer setup with the "/quiet" argument. |
|
|
Toolbar Bitmap |
File path |
|
The full path of the bitmap that is to appear on the Internet Explorer toolbar. |
|
|
Type |
Numeric |
2 |
The type of customization being used by Internet Explorer: 2 = Corporate Administrator, 1 = Internet Service Provider, 0 = Internet Content Provider. |
|
|
User Agent |
String |
Acme v1.1 |
String to be appended to default User Agent string used by Internet Explorer. |
|
|
Version |
String |
5,0,0,1 |
Target version of Internet Explorer. |
|
|
Win32DownloadSite |
URL |
0 |
URL from which the Internet Explorer Setup file will be downloaded. |
|
|
Window_Title |
String |
Microsoft Internet Explorer provided by Custom Company |
Customized window title for Internet Explorer. |
|
|
Window_Title_CN |
String |
Custom Company Name |
The name to be appended to the Internet Explorer window title. |
|
|
Wizard_Version |
String |
8.0.0.1234 |
Indicates the version of the IEAK wizard that produced the INS file. |
|
|
GPVersion |
String |
6.0.6001.16474 |
Version of the software (IEM Tool Extension) that created the INS file. |
|
[BrowserToolbars] |
Action0 |
File path |
c:\windows\notepad.exe |
The full path of a command to be executed for a custom toolbar button in Internet Explorer. |
|
|
Caption0 |
String |
Sample |
A caption for the custom toolbar button in Internet Explorer. |
|
|
DeleteButtons |
Boolean |
1 |
Indicates whether or not to delete existing custom Internet Explorer toolbar buttons on install. |
|
|
HotIcon0 |
File path |
C:\My Documents\Branding\Icons\hoticon.ico |
The highlighted icon to appear in the button when the pointer is over the button in Internet Explorer. |
|
|
Icon0 |
File path |
C:\My Documents\Branding\Icons\icon.ico |
The gray icon to appear in the button when the pointer is not over the button in Internet Explorer. |
|
|
Show0 |
Boolean |
1 |
Displays the new toolbar button on the toolbar by default. |
|
|
ToolTipText0 |
String |
Click the sample button. |
ToolTip text for the custom button. |
|
[CabSigning] |
InfoURL |
URL |
http://www.contoso.com/moreinfo.htm |
The URL to appear on the certificate dialog in Internet Explorer. |
|
|
Name |
String |
Microsoft |
The company name that is associated with the certificate. |
|
|
pvkFile |
File path |
c:\key.pvk |
The full path of a private key file to be used by Internet Explorer. |
|
|
spcFile |
File path |
c:\cert.spc |
The full path of the actual certificate file. |
|
[CDCustomFiles] |
InstallIEVersion |
String |
7,0,0,0 |
Specifies the latest version of Internet Explorer to which this CD-based install will apply. |
|
[Channel Add] |
Category |
Boolean |
0 |
A value of 1 indicates that there will be only one Internet Explorer channel category; for multiple channel categories, set this value to 0. |
|
|
CDFUrl0 |
URL |
http://server/sample.cdf |
URL of the channel's .cdf file to be used by Internet Explorer. |
|
|
ChBmpPath0 |
File Path |
sample.bmp |
The full path of a bitmap for the channel, to appear in the Channel bar. |
|
|
ChIconPath0 |
File Path |
sample.ico |
The full path of an icon for the channel. |
|
|
ChPreloadUrlName0 |
Filename |
sample.cdf |
The name of .cdf file. |
|
|
ChPreloadUrlPath0 |
File Path |
C:\WINDOWS\WEB\sample.cdf |
Full path to .cdf file. The file name component is equal to the value of the ChPreloadUrlName0 entry above. |
|
|
ChTitle0 |
String |
Sample Custom Channel |
Title for the channel. |
|
|
No Channels |
Boolean |
1 |
No channels indicates that no channels will be added. |
|
[ConnectionSettings] |
ConnectName0 |
String |
Microsoft |
Name for connection to be used by Internet Explorer. |
|
|
DeleteConnectionSettings |
Boolean |
0 |
Set this to 1 to remove the existing Internet Explorer connection settings. |
|
|
EnableAutodial |
Boolean |
0 |
A value of 1 indicates that Internet Explorer is to always dial the default connection. |
|
|
NoNetAutodial |
Boolean |
0 |
A value of 1 indicates that Internet Explorer is to dial whenever a network connection is not present. |
|
|
Option |
Boolean |
0 |
A value of 1 indicates that the IEAK is to import the current connection settings and install them on target machines. |
|
[Custom Branding] |
Branding |
URL |
http://www.cohowinery.com/cabs/branding.cab,1998.09.26.03,-1,0 |
URL to branding cab to be used by Internet Explorer. |
|
[Custom Wallpaper] |
File0 |
Filename |
wallpaper.htm |
The name of an HTML file for custom wallpaper to be used by Internet Explorer. |
|
|
File1 |
Filename |
wallpaper.gif |
The name of a file referenced in the HTML above. |
|
|
NumFiles |
Numeric |
2 |
Total number of files for custom wallpaper. |
|
[DesktopObjects] |
Channel Bar |
Boolean |
1 |
Displays the Channel bar on Internet Explorer startup. |
|
|
Delete Old Channels |
Boolean |
1 |
Indicates to delete existing channels. |
|
|
Desktop Component URL |
URL |
http:// |
URL to the desktop component being added. |
|
|
Desktop Wallpaper Path |
File path |
C:\My Documents\Branding\wallpapr.bmp |
Path to the desktop wallpaper to be used by Internet Explorer. |
|
|
Option |
Boolean |
1 |
Set this to 1 if using any desktop customizations. |
|
[Device] |
Type |
String |
modem |
The type of connection being used for setup. |
|
[ExtRegInf] |
chat |
String |
*,chat.inf,DefaultInstall |
INF file and install mode for Internet Explorer components. |
|
[FavoritesEx] |
IconFile1 |
File Path |
c:\windows\temp\iedktemp\branding\favs\news.ico |
Icon for Favorite to be used by Internet Explorer. |
|
|
Offline1 |
Boolean |
1 |
Indicates if Internet Explorer is to make the Favorite available for offline browsing. |
|
|
Title1 |
String |
fav name.url |
Title of the Favorite. |
|
|
Url1 |
URL |
http://fav url |
URL of the Favorite. |
|
[Favorites] |
fav name.url |
URL |
http://fav url |
The ValueName in this setting is the Internet Explorer Favorite name, and the value is the Internet Explorer Favorite URL. |
|
[HideCustom] |
Boolean |
0 |
The ValueName in this setting is the GUID for the component. A value of 1 indicates that it is to be hidden on the Internet Explorer custom screen, and 0 if not. |
|
|
[ICW_IEAK] |
Header_Bitmap |
File path |
C:\My Documents\Branding\ICW_Header |
The file path of a custom header bitmap for the Internet Explorer Internet Connection Wizard. |
|
|
Watermark_Bitmap |
File path |
C:\My Documents\Branding\ICW_Watermark |
The file path of a custom watermark bitmap for the Internet Explorer Internet Connection Wizard. |
|
[IEAKLite] |
Certificate Customization |
Boolean |
1 |
A value of 1 indicates that the IEAK wizard is to show the "Certificate Customization" page. |
|
|
Sign-up Settings |
Boolean |
1 |
A value of 1 indicates that the IEAK wizard is to show the "Sign-up Settings" page. |
|
[Media] |
Build_BrandingOnly |
Boolean |
1 |
A value of 1 indicates that the IEAK will build a branding-only package. |
|
|
Build_CD |
Boolean |
0 |
A value of 1 indicates that the IEAK will build a CD package. |
|
|
Build_LAN |
Boolean |
0 |
A value of 1 indicates that the IEAK will build a LAN package. |
|
[Proxy] |
FTP_Proxy_Server |
String |
proxy |
Host name for proxy server to be used by Internet Explorer. |
|
|
Gopher_Proxy_Server |
String |
proxy |
Host name for proxy server. |
|
|
HTTP_Proxy_Server |
String |
proxy |
Host name for proxy server. |
|
|
Proxy_Enable |
Boolean |
0 |
If set, indicates to use a proxy server. |
|
|
Proxy_Override |
String |
<local> |
Host name for proxy server. |
|
|
Secure_Proxy_Server |
String |
proxy |
Host name for proxy server. |
|
|
Socks_Proxy_Server |
String |
proxy |
Host name for proxy server. |
|
|
Use_Same_Proxy |
Boolean |
1 |
Use one proxy server for all services. |
|
[Scripting] |
Name |
Filename |
dialup.scp |
File name of dial-up networking script used by Internet Explorer. |
|
|
Name16 |
Filename |
dialup.scp |
File name of dial-up networking script (16 bit). |
|
|
Name32 |
Filename |
dialup.scp |
File name of dial-up networking script (32 bit). |
|
|
Path16 |
File path |
c:\scripts\dialup.scp |
Full path to 16-bit script. |
|
|
Path32 |
File path |
c:\scripts\dialup.scp |
Full path to 32-bit script. |
|
[Script_File] |
1 |
String |
First line of script file |
Actual text of the script file to be used by Internet Explorer. |
|
[Security Imports] |
ImportAuthCode |
Boolean |
0 |
If set, Internet Explorer is to import the existing Authenticode settings. |
|
|
ImportRatings |
Boolean |
0 |
If set, Internet Explorer is to import the existing Content Ratings settings. |
|
|
ImportSecZones |
Boolean |
0 |
If set, Internet Explorer is to import the existing Security Zones settings. |
|
|
ImportSiteCert |
Boolean |
0 |
If set, Internet Explorer is to import existing site certificate authorities. |
|
|
TrustedPublisherLock |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is to enable Trusted Publisher Lockdown, which prevents users from adding new trusted publishers. |
|
|
Win16SiteCerts |
Boolean |
0 |
Use site certificates for 16-bit Windows systems. |
|
[Server] |
Disable_LCP |
String |
yes / no |
Default settings for Internet connection to be used by Internet Explorer. |
|
|
Negotiate_IPX/SPX |
String |
yes / no |
Internet Explorer is to use IPX protocol. |
|
|
Negotiate_NetBEUI |
String |
yes / no |
Use NetBEUI protocol. |
|
|
Negotiate_TCP/IP |
String |
yes / no |
Use TCP/IP protocol. |
|
|
Network_Logon |
String |
yes / no |
Internet Explorer is to log on to the network. |
|
|
PW_Encrypt |
String |
yes / no |
Internet Explorer is to use encrypted passwords. |
|
|
SW_Compress |
String |
yes / no |
Internet Explorer is to use software compression. |
|
|
SW_Encrypt |
String |
yes / no |
Require data encryption. |
|
|
Type |
String |
ppp |
Server type, such as ppp. |
|
[Signature] |
Signature_Text |
String |
This is fun\n |
Text of signature. |
|
|
Use_Signature |
Boolean |
1 |
If set, indicates to use the signature in the Signature_Text entry above. |
|
[SignupFiles] |
file0 |
Filename |
cancel.ins |
File name of signup INS to be used by Internet Explorer. |
|
[Small_Logo] |
Name |
Filename |
static22x22.bmp |
Name of 22x22 pixel bitmap file for icon to appear in upper right corner of Internet Explorer. |
|
|
Path |
File path |
C:\My Documents\Branding\static22x22.bmp |
Full path to the small logo bitmap file. The file name component is equal to the value of the Name entry above. |
|
[TCP/IP] |
DNS_Address |
IP Address |
127.0.0.1 |
IP number of DNS server that Internet Explorer is to use. |
|
|
DNS_Alt_Address |
IP Address |
127.0.0.1 |
IP number of alternate that DNS server to use. |
|
|
Gateway_On_Remote |
String |
yes / no |
Use remote gateway. |
|
|
IP_Header_Compress |
String |
yes / no |
Use IP header compression. |
|
|
Specify_IP_Address |
String |
yes / no |
Specify an IP address to use. |
|
|
Specify_Server_Address |
String |
yes / no |
Specify a server address to use. |
|
[URL] |
AutoConfig |
Boolean |
1 |
Set this to 1 to tell Internet Explorer to use an auto-configured proxy. |
|
|
AutoConfigJSURL |
URL |
http://auto proxy url |
URL of JS format auto-proxy file used by Internet Explorer. |
|
|
AutoConfigTime |
Numeric |
99 |
AutoConfig after this many minutes. |
|
|
AutoConfigURL |
URL |
http://auto config url |
The URL of auto-proxy file used by Internet Explorer. |
|
|
AutoDetect |
Boolean |
1 |
A value of 1 indicates that Internet Explorer is to automatically detect configuration settings. |
|
|
FirstHomePage |
URL |
http://custom welcome page |
Page to browse to on first run of customized browser. |
|
|
Help_Page |
URL |
http://online support |
URL of the Help page to be used by Internet Explorer. |
|
|
Home_Page |
URL |
http://homepage |
URL for the default home page to be used by Internet Explorer. |
|
|
NoWelcome |
Boolean |
1 |
Do not display a welcome page the first time that Internet Explorer is used. |
|
|
Quick_Link_1 |
URL |
http://www.microsoft.com/isapi/redir.dll?prd |
Quick link URL. |
|
|
Quick_Link_1_Name |
String |
Best of the Web.url |
Quick link name. |
|
|
Quick_Link_2 |
URL |
http://www.microsoft.com/isapi/redir.dll?prd |
Quick link URL. |
|
|
Quick_Link_2_Name |
String |
Channel Guide.url |
Quick Link name. |
|
|
Quick_Link_X |
URL |
http://link url |
Quick link URL. |
|
|
Quick_Link_X_Icon |
File path |
c:\windows\temp\iedktemp\branding\favs\news.ico |
Quick link icon. |
|
|
Quick_Link_X_Name |
String |
News |
Quick link name. |
|
|
Quick_Link_X_Offline |
Boolean |
1 |
If set, Internet Explorer is to make the quick link available for offline browsing. |
|
|
Search_Page |
URL |
http://searchpane |
Default search page to be used by Internet Explorer. |
|
|
Signup |
File path |
signup.htm |
Path to page with link to INS file for signup server. |
|
|
UseLocalIns |
Boolean |
0 |
If set, Internet Explorer is to use a local INS file. |