Modify the Configure E-mail and Internet Connection Wizard script file

Each of the modifiable sections for networking, firewall, secure Web site, and e-mail correspond to pages in the Configure E-mail and Internet Connection Wizard. The properties in each modifiable section then correspond to fields on the respective wizard page, for which the value can be a string, Boolean, or constant value. The value is defined after the property name, following the equal sign (=).

 

Value Indicated by Description

String

Property names for string values start with an "s."

Type the value for the string following the equal sign and enclose it in quotation marks. The beginning and ending quotation marks around the value must be used when entering string values in the script, for example, sModemIPAddress = "206.73.118.2".

Boolean

Property names for Boolean values start with a "b."

Boolean values can be a TRUE or FALSE value, for example, bDhcp = TRUE.

Constant

Property names for constant values start with an "i."

Values must be chosen from the list of possible values provided for each property, for example, iHardwareSelection = HARDWARE_SELECTION_BROADBAND.

Note

  • Except for password property strings, values are not case sensitive.

SECTION: NETWORKING CONFIGURATION

The networking configuration section of the script allows you to specify the connection type used by the server to connect to the Internet. You must specify a connection type. Then, if you are using a broadband connection to connect to the Internet, you must specify information about the type of broadband connection. Once your connection type is defined, you must provide specific information about the connection information. Additionally, if you use a second network adapter to connect to the Internet, you must provide specific information about that adapter.

Connection Type Page

iHardwareSelection = CONSTANT. A value for this property is required. Type the value for the constant that matches the type of hardware device used to connect to the Internet.

 

Possible value Description
HARDWARE_SELECTION_BROADBAND

If you have a high-speed Internet connection, use this value.

HARDWARE_SELECTION_MODEM

If you use a modem or ISDN terminal adapter to connect to the Internet, use this value.

HARDWARE_SELECTION_DONTTOUCH

If you have already run the Configure E-mail and Internet Connection Wizard and do not want to change the connection type previously specified, use this value.

Broadband Connection Page

iBroadbandSelection = CONSTANT. If you specified iHardwareSelection = HARDWARE_SELECTION_BROADBAND, you must type the value for iBroadbandSelection that matches the type of broadband connection used by your server to connect to the Internet.

 

Possible value Description
BROADBAND_SELECTION_DIRECTBROADBAND

If the network adapter for your Internet connection connects directly to your ISP, or your server uses a networking device that does not have an IP address, use this value.

BROADBAND_SELECTION_ROUTER

If your server uses a router with an IP address supplied by your ISP, use this value.

BROADBAND_SELECTION_PPPOE

If your broadband connection requires authentication information and either the network adapter for your Internet connection connects directly to your ISP or your server uses a networking device that does not have an IP address, use this value.

PPPoE Connection Page

Several properties are required for this script section if you defined iBroadbandSelection = BROADBAND_SELECTION_PPPOE in the Broadband Connection Page script section.

 

Property Description
sPPPoEPbkEntryName = "string"

The name of the demand-dial interface as it is displayed in the Network Interfaces node of Routing and Remote Access. If you do not have a demand-dial interface defined, you must type a name that will be used to create the connection, and then set sPPPoECreatePbkEntry = TRUE.

Note

  • If you are using Internet Security and Acceleration (ISA) Server 2000 as your firewall, the name is displayed in Network Connections (click Start, point to Control Panel, right-click Network Connections, and then click Open).
bPPPoECreatePbkEntry = BOOLEAN

If you want to create a new PPPoE connection, type TRUE. Otherwise, type FALSE.

sPPPoEAccountName = "string"

The name of the account used to authenticate the PPPoE connection to your ISP.

sPPPoEPassword = "string"

The password for the account used to authenticate the PPPoE connection to your ISP.

bPPPoEStaticIP = BOOLEAN

If your ISP assigns a static IP address to your PPPoE connection, type TRUE. Otherwise, type FALSE.

sPPPoEIPAddress = "string"

If bPPPoEStaticIP = TRUE, type the IP address assigned by your ISP for your PPPoE connection.

sPPPoEDnsIPAddress = "string"

If bPPPoEStaticIP = TRUE, type the IP address of your ISP's DNS server used for name resolution across the Internet.

sPPPoEDns2IPAddress = "string"

If bPPPoEStaticIP = TRUE, and your ISP provides a secondary DNS server, type the IP address. This value is optional and may be left blank. The property cannot be the same IP address as the sPPPoEDnsIPAddress property.

Modem Connection Page

Several properties are required for this script section if you defined iHardwareSelection = HARDWARE_SELECTION_MODEM in the Connection Type Page script section.

Note

  • If you have multiple modems installed in your server, the script will configure your Internet connection to use the first modem detected.

 

Property Description
sModemPbkEntryName = "string"

The name of the demand-dial interface as it is displayed in the Network Interfaces node of Routing and Remote Access. If you do not have a demand-dial interface defined, you must type a name that will be used to create the connection, and then set sModemCreatePbkEntry = TRUE.

Note

  • If you are using Internet Security and Acceleration (ISA) Server 2000 as your firewall, the name is displayed in Network Connections (click Start, point to Control Panel, right-click Network Connections, and then click Open).
bModemCreatePbkEntry = BOOLEAN

If you want to create a new dial-up connection, type TRUE. Otherwise, type FALSE.

sModemPhoneNumber = "string"

If sModemCreatePbkEntry = TRUE, type the phone number used to dial a connection to your ISP.

sModemAccountName = "string"

The name of the account used to authenticate the dial-up connection to your ISP.

sModemPassword = "string"

The password for the account used to authenticate the dial-up connection to your ISP.

bModemStaticIP = BOOLEAN

If your ISP assigns a static IP address to your dial-up connection, type TRUE. Otherwise, type FALSE.

sModemIPAddress = "string"

If bModemStaticIP = TRUE, type the IP address assigned by your ISP for your dial-up connection.

sModemDnsIPAddress = "string"

If bModemStaticIP = TRUE, type the IP address of your ISP's DNS server used for name resolution across the Internet.

sModemDns2IPAddress = "string"

If bModemStaticIP = TRUE, and your ISP provides a secondary DNS server, type the IP address. This value is optional and may be left blank. The property cannot be the same IP address as the sModemDnsIPAddress property.

Network Connection Page

Several properties are required for this script section if your server has two or more network adapters.

 

Property Description
sConnectionToEnable = "string"

The name of the network connection as it is displayed in Network Connections in Control Panel.

bDhcp = BOOLEAN

If the network adapter that is used to connect to the Internet is automatically assigned an IP address (using DHCP) by your ISP, type TRUE. Otherwise, type FALSE.

sIpAddress = "string"

If bDhcp = FALSE, type the static IP address assigned to you by your ISP to use for the network adapter used to connect to the Internet.

sSubnetMask = "string"

If bDhcp = FALSE, type the subnet mask for the static IP address assigned to you by your ISP.

sDefaultGateway = "string"

If bDhcp = FALSE, type the IP address of the default gateway to your ISP.

sLanConnection ="string"

A value for this property is required. The name of the network connection used to access the local network as it is displayed in Network Connections in Control Panel.

sExternalConnection = "string"

Required if using a broadband connection with two network adapters. The name of the network connection used to access the Internet as it is displayed in Network Connections in Control Panel.

Router Connection Page

Several properties are required for this script section if you defined iHardwareSelection = HARDWARE_SELECTION_ROUTER in the Broadband Connection Page script section.

 

Property Description
sRouterIPAddress = "string"

Type the IP address of the router interface used to connect to your private network.

bRouterOnLocalNic = BOOLEAN

If the server uses only one network adapter to connect to both your private and public network, type TRUE. Otherwise, type FALSE.

sRouterDnsIPAddress = "string"

Type the IP address of your ISP's DNS server that is used for name resolution across the Internet.

sRouterDns2IPAddress = "string"

If your ISP provides a secondary DNS server to use for backup DNS service when connecting to the Internet, type the IP address. This value is optional and may be left blank. The property cannot be the same IP address as the sRouterDnsIPAddress property.

bUPnP = BOOLEAN

If the firewall device on your network supports the UPnP architecture, type TRUE. If the firewall device does not support the UPnP architecture, or if you are using the firewall provided by the server, type FALSE.

Direct Broadband Connection Page

Several properties are required for this script section if you defined iHardwareSelection = HARDWARE_SELECTION_DIRECTBROADBAND in the Broadband Connection Page script section.

 

Property Description
sGatewayIPAddress = "string"

Type the IP address used by the server to send requests to the Internet.

sFullTimeDnsIPAddress = "string"

Type the IP address of your ISP's preferred DNS server that is used for name resolution across the Internet.

sFullTimeDns2IPAddress = "string"

If your ISP provides a secondary DNS server to use for backup DNS service when connecting to the Internet, enter the IP address. This value is optional and may be left blank. The property cannot be the same IP address as the sDirectBroadbandDnsIPAddress property.

SECTION: FIREWALL CONFIGURATION

This section in the script allows you to specify the firewall configuration settings for your local network. The script can be used to configure either the firewall running on the server or a firewall device on the network that supports the UPnP architecture. To determine if the firewall device on the network supports the UPnP architecture, see your manufacturer documentation.

Note

  • To configure a firewall device on the network that supports the UPnP architecture, you must set bUPnP = BOOLEAN in the Router Connection Page script section.

Firewall Page

iPFSelection = CONSTANT. A value for this property is required. Type the value for the constant.

 

Possible Values Description
PF_SELECTION_ENABLE

If you want to use the firewall provided by the server or you have a firewall device that supports the UPnP architecture, use this value.

PF_SELECTION_DISABLE

If you do not want to use the firewall on the server to secure your local network, use this value.

PF_SELECTION_DONTTOUCH

If you plan to configure a firewall on your own or if you have previously run the Configure E-mail and Internet Connection Wizard and do not want to modify the settings, use this value.

Web Site Publishing Page

iWebPublishing = CONSTANT. A value for this property is required. Type the value for the constant.

Note

  • The option to configure your Web site for Internet access is not available if you use either a dial-up or PPPoE connection to the Internet and the connection is not assigned a static IP address.

 

Possible value Description
WEBPUBLISHING_DISABLE

If you do not want any part of your default Web site accessible to users on the Internet, use this value.

WEBPUBLISHING_PUBLISH

If you want specific Web-based services available to users on the Internet, but you do not want your entire default Web site accessible, use this value. You must then specify which Web services to allow in the following section.

WEBPUBLISHING_PUBLISHALL

If you want to allow access to the entire default Web site from the Internet, use this value.

If you defined iWebPublishing = WEBPUBLISHING_PUBLISH you must then specify which Web services to allow access from the Internet.

 

Property Description
bOWA = BOOLEAN

If you want to allow users to access their mailboxes from the Internet using a Web browser, type TRUE. Otherwise, type FALSE.

bRemoteWebWorkplace = BOOLEAN

If you want to allow users to connect to the local network from the Internet using a Web browser to access the Remote Web Workplace, type TRUE. Otherwise, type FALSE.

bPerformanceAndUsage = BOOLEAN

If you want to allow users to access server performance and usage reports, type TRUE. Otherwise, type FALSE.

bOutlookMobileAccess = BOOLEAN

If you want to allow users to access their mailboxes from a mobile device using Outlook Mobile Access, type TRUE. Otherwise, type FALSE.

bOutlookViaInternet = BOOLEAN

If you want to allow users to access their e-mail from a client computer on the Internet using Outlook 2003 (using RPC over HTTP Proxy), type TRUE. Otherwise, type FALSE.

bSharepointIntranet = BOOLEAN

If you want to allow users to access the intranet Web site from the Internet, type TRUE. Otherwise, type FALSE.

Note

  • The intranet Web site is created with Windows SharePoint Services during Setup.
bBusinessWebSite = BOOLEAN

If you want to allow users to access the company's Internet Web site on the Internet Information Services (IIS) default Web site (wwwroot) from the Internet, type TRUE. Otherwise, type FALSE.

Firewall Configuration Page

Several properties are required for this script section if you defined iPFSelection = PF_SELECTION_ENABLE in the Firewall Page script section.

  1. sPF_PortMappings = "string". Type the XML syntax for additional services that you want to allow through the firewall. You must use the following XML syntax for the string:
    <PortMappings><PortMapping PublicPort=""Port_number"" PrivatePort=""Port_number"" PublicAddress=""0.0.0.0"" PrivateAddress=""127.0.0.1"" Protocol=""UDP_or_TCP"" Direction = ""Direction"" Enable = ""1""/</PortMappings>
    
    

     

    Element of Syntax Description

    PortMapping PublicPort

    The port number used by the protocol for incoming traffic to the network adapter used to connect to the Internet.

    PrivatePort

    The port number used by the protocol when it is routed from the local network adapter.

    PublicAddress

    Is set to 0.0.0.0 to represent from anyone. It is recommended that you do not change this value.

    PrivateAddress

    The IP address for the loopback address (the address of the local computer used for routing outgoing packets back to the source computer).

    Protocol

    Either UDP or TCP.

    Direction

    If you are using Internet Security and Acceleration (ISA) Server 2000 as your firewall, you must also provide the direction for the service.

    If the service is TCP, type Inbound, Outbound, or Both.

    If the service is UDP, type Send, Receive, SendReceive, or ReceiveSend.

    Enable

    If you want to allow this service through the firewall, type 1. Otherwise, type 0.

    Predefined additional services

     

    Predefined additional service Description

    E-mail

    PortMapping PublicPort=""25"" PrivatePort=""25""
    PublicAddress=""0.0.0.0"" PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/

    Web server (http://and https://)

    PortMapping PublicPort=""80"" PrivatePort=""80""
    PublicAddress=""0.0.0.0"" PrivateAddress=""127.0.0.1""
    Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/
    
    PortMapping PublicPort=""443"" PrivatePort=""443""
    PublicAddress=""0.0.0.0"" PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/
    

    Virtual private network (VPN)

    PortMapping PublicPort=""1723"" PrivatePort=""1723""
    PublicAddress=""0.0.0.0"" PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/

    Terminal Services

    PortMapping PublicPort=""3389"" PrivatePort=""3389"" PublicAddress=""0.0.0.0""
    PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/

    FTP

    PortMapping
    PublicPort=""21"" PrivatePort=""21"" PublicAddress=""0.0.0.0""
    PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/

    Remote Web Workplace

    PortMapping
    PublicPort=""4125"" PrivatePort=""4125"" PublicAddress=""0.0.0.0""
    PrivateAddress=""127.0.0.1"" Protocol=""TCP"" Direction = ""Inbound"" Enable = ""1""/
  2. sPF_CustomServices = "string". Type the XML syntax for additional custom services that you want to allow to pass through the firewall. You must use the following XML syntax for the string:
    <CustomPortMappings><CustomPortMapping Name=""Friendly_name_of_service"" PublicPort=""Port_number""
    PrivatePort=""Port_number"" PublicAddress=""0.0.0.0""
    PrivateAddress=""127.0.0.1"" Protocol=""UDP or TCP"" Direction = ""Direction""/></CustomPortMappings>
    

SECTION: SECURE WEB SITE PUBLISHING CONFIGURATION

This section in the script allows you to specify the certificate that will be used to configure Secure Sockets Layer (SSL). You must define a property for this page if you defined iWebPublishing = WEBPUBLISHING_PUBLISH or iWebPublishing = WEBPUBLISHING_PUBLISHALL for the Web Site Publishing Page script section.

Web Server Certificate Page

You must define a value to use for iCertSelection if you are allowing access to a Web service from the Internet.

Important

  • If you already created a certificate, use SSL_SELECTION_USECURRENT for iCertSelection.

 

Property Description
iCertSelection = CONSTANT

You must provide a constant value for the certificate that your Web server will use for Secure Sockets Layer (SSL) connections.

Possible Values:

  • CERT_SELECTION_NEW. Use this value to create a self-signed certificate using the Web server name you provide in sWebServerName = "string".
  • CERT_SELECTION_USEFILE. Use this value if you have already obtained a certificate from a trusted authority, and then provide a path to the certificate in sCertFile.
  • CERT_SELECTION_USECURRENT
sWebServerName = "string"

If iCertSelection = CERT_SELECTION_NEW, type the full Internet name of your server.

sCertFile = "string"

If iCertSelection = CERT_SELECTION_USEFILE, type the path to the certificate file that you obtained from a trusted authority.

SECTION: E-MAIL CONFIGURATION

This section in the script allows you to specify the e-mail configuration on your server.

Internet E-mail Page

iEmailSelection = CONSTANT. A value for this property is required. Type the value for the constant.

 

Property Description
EMAIL_SELECTION_ENABLE

If you want Exchange to handle your Internet e-mail using the SmallBusiness SMTP Connector, use this value.

EMAIL_SELECTION_DISABLE

If you do not want to use Exchange for Internet e-mail, use this value.

EMAIL_SELECTION_DONTTOUCH

If you are currently using Exchange and do not want your settings overwritten, use this value.

E-mail Delivery Method Page

Several properties are required for this script section if you defined iEmailSelection = EMAIL_SELECTION_ENABLE in the Internet E-mail Page script section.

 

Property Description
bSmtpUseDnsToSend = BOOLEAN

If you want to use DNS to send e-mail, type TRUE for this option. Type FALSE if your ISP has a dedicated mail server and then specify the name of the server for sSmtpSmartHostName = "string".

sSmtpSmartHostName = "string"

If you defined bSmtpUseDnsToSend = FALSE, type the fully qualified host name of your ISP's e-mail server.

E-Mail Retrieval Method Page

Several properties are required for this script section if you defined iEmailSelection = EMAIL_SELECTION_ENABLE in the Internet E-mail Page script section.

 

Property Description
bEnablePOP3 = BOOLEAN

If you want to download e-mail from a POP3 account at an ISP, type TRUE. Otherwise, type FALSE. To configure mailbox accounts, you must use the POP3 Connector Manager. For more information, see Add or remove a POP3 mailbox.

bExchangeReceive = BOOLEAN

If you want to download e-mail from an SMTP server at your ISP, type TRUE. Otherwise, type FALSE.

iSmtpDequeueMethod = CONSTANT

Complete this property only if you defined bExchangeReceive = TRUE. Type your dequeue method.

Possible Values:

  • DEQUEUE_METHOD_ETRN. If Exchange notifies your ISP that it is online and ready to receive e-mail by issuing an ETRN command, use this constant value.
  • DEQUEUE_METHOD_TURN. If Exchange notifies your ISP that it is online and ready to receive e-mail by using a TURN command, use this constant value.
  • DEQUEUE_METHOD_NONE. If your e-mail is delivered directly to Exchange, use this constant value.
sDequeueHostName= "string"

Complete this property only if you defined iSmtpDequeueMethod = DEQUEUE_METHOD_ETRN or iSmtpDequeueMethod = DEQUEUE_METHOD_TURN. Type the fully qualified host name of your ISP's e-mail DNS server name to which Exchange will send its signal.

TURN Authentication Information Page

Several properties are required for this script section if you defined iSmtpDequeueMethod = DEQUEUE_METHOD_TURN in the E-mail Retrieval Method Page script section.

 

Property Description
sTurnAccountName = "string"

Type the name of the account used to authenticate Exchange to your ISP's e-mail server.

sTurnPassword = "string"

Type the password for the account used to authenticate Exchange to your ISP's e-mail server.

bTurnUseSSL = BOOLEAN

If your ISP supports you to encrypt authentication information using Secure Sockets Layer (SSL) encryption, type TRUE. Otherwise, type FALSE.

Mail Schedule Page

Complete the properties for this script section only if you defined iEmailSelection = EMAIL_SELECTION_ENABLE.

 

Property Description
bCustomSchedule = BOOLEAN

If you do not want to change a schedule you have previously defined, type TRUE. If you want to set your schedule to a new delivery frequency, type FALSE.

iMailFrequencyHours = CONSTANT

Complete this property only if you defined bCustomSchedule = FALSE. Type the interval in hours (0-24) for sending and receiving e-mail.

iMailFrequencyMinutes = CONSTANT

Complete this property only if you defined bCustomSchedule = FALSE. Type the interval in 15-minute increments (0, 15, 30, or 45) for sending and receiving e-mail.

Note

  • The value for the iMailFrequencyMinutes property cannot be 0 if the value for iMailFrequencyHours is 0.

E-mail Domain Name Page

Several properties are required for this script section if you defined iEmailSelection = EMAIL_SELECTION_ENABLE in the Internet E-mail Page script section.

 

Property Description
sDomainName = "string"

Type your registered Internet domain name.

Remove E-mail Attachments Page

Several properties are required for this script section if you defined iEmailSelection = EMAIL_SELECTION_ENABLE in the Internet E-mail Page script section.

  • sAttachConfig = "string". Type the XML syntax for e-mail attachment types that you do not want to allow from the Internet. You must use the following XML syntax for the string:
    "sAttachConfig = "<SecAttsConfig><Enabled>True</Enabled><SaveToFile Enabled=""True"" Location=""full_path_to_folder""/><UnsafeAttachments><Attachment Enabled=""True""Extenson=""Extension_used_by_attachment""Description=""Friendly_name_of_attachment""/></UnsafeAttachments></SecAttsConfig>"
    
    Important
    • If you do not want to remove e-mail attachments for Internet e-mail, change the Enabled value to False, as follows:
      <SecAttsConfig><Enabled>False</Enabled>
      
      It is not necessary to delete the UnsafeAttachments list.
    • If you do not want to save e-mail attachments for Internet e-mail, change the Enabled value to False, as follows:
      <SaveToFile Enabled=""False""
      
    • If you want to allow some e-mail attachments through, change Enabled=""True"" to False for that specific attachment type. For example:
      Attachment Enabled=""False""Extenson=""ade""Description=""Microsoft Access project extension""
      

     

    Element of Syntax Description

    Extension_used_by_attachment

    The file name extension. For example, .bat is the file name extension for a batch file.

    Friendly_name_of_attachment

    The name used to recognize the type of extension.

See Also

Community Additions

ADD
Show: