Export (0) Print
Expand All

4.1.1 INS File Format

The install.ins file must be 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 must be either 0 or 1 as an ANSI string.

String: Indicates that the value must be an ANSI string that does not contain a newline.

URL: Indicates that the value must be a URL (for more information, see [RFC3986]).

Numeric: Indicates that the value must be an integer between 0 and 2^32-1 expressed in decimal as an ANSI string.

Hexadecimal: Indicates that the value must be an integer between 0 and 2^32-1 expressed in hexadecimal as an ANSI string.

Hostname: Indicates that the value must be 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 must not 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 must be 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 must be 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 must be 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 must be 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 should.

 

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 must be 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]

GUID

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 must be 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.

 
Show:
© 2014 Microsoft