Modify the Configure E-mail and Internet Connection Wizard script file
Van toepassing op: Windows SBS 2003
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 |
---|---|
|
If you have a high-speed Internet connection, use this value. |
|
If you use a modem or ISDN terminal adapter to connect to the Internet, use this value. |
|
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 |
---|---|
|
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. |
|
If your server uses a router with an IP address supplied by your ISP, use this value. |
|
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 |
---|---|
|
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 want to create a new PPPoE connection, type TRUE. Otherwise, type FALSE. |
|
The name of the account used to authenticate the PPPoE connection to your ISP. |
|
The password for the account used to authenticate the PPPoE connection to your ISP. |
|
If your ISP assigns a static IP address to your PPPoE connection, type TRUE. Otherwise, type FALSE. |
|
If bPPPoEStaticIP = TRUE, type the IP address assigned by your ISP for your PPPoE connection. |
|
If bPPPoEStaticIP = TRUE, type the IP address of your ISP's DNS server used for name resolution across the Internet. |
|
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 |
---|---|
|
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 want to create a new dial-up connection, type TRUE. Otherwise, type FALSE. |
|
If sModemCreatePbkEntry = TRUE, type the phone number used to dial a connection to your ISP. |
|
The name of the account used to authenticate the dial-up connection to your ISP. |
|
The password for the account used to authenticate the dial-up connection to your ISP. |
|
If your ISP assigns a static IP address to your dial-up connection, type TRUE. Otherwise, type FALSE. |
|
If bModemStaticIP = TRUE, type the IP address assigned by your ISP for your dial-up connection. |
|
If bModemStaticIP = TRUE, type the IP address of your ISP's DNS server used for name resolution across the Internet. |
|
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 |
---|---|
|
The name of the network connection as it is displayed in Network Connections in Control Panel. |
|
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. |
|
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. |
|
If bDhcp = FALSE, type the subnet mask for the static IP address assigned to you by your ISP. |
|
If bDhcp = FALSE, type the IP address of the default gateway to your ISP. |
|
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. |
|
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 |
---|---|
|
Type the IP address of the router interface used to connect to your private network. |
|
If the server uses only one network adapter to connect to both your private and public network, type TRUE. Otherwise, type FALSE. |
|
Type the IP address of your ISP's DNS server that is used for name resolution across the Internet. |
|
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. |
|
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 |
---|---|
|
Type the IP address used by the server to send requests to the Internet. |
|
Type the IP address of your ISP's preferred DNS server that is used for name resolution across the Internet. |
|
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 |
---|---|
|
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. |
|
If you do not want to use the firewall on the server to secure your local network, use this value. |
|
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 |
---|---|
|
If you do not want any part of your default Web site accessible to users on the Internet, use this value. |
|
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. |
|
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 |
---|---|
|
If you want to allow users to access their mailboxes from the Internet using a Web browser, type TRUE. Otherwise, type FALSE. |
|
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. |
|
If you want to allow users to access server performance and usage reports, type TRUE. Otherwise, type FALSE. |
|
If you want to allow users to access their mailboxes from a mobile device using Outlook Mobile Access, type TRUE. Otherwise, type FALSE. |
|
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. |
|
If you want to allow users to access the intranet Web site from the Internet, type TRUE. Otherwise, type FALSE. Note
|
|
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.
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""/
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 |
---|---|
|
You must provide a constant value for the certificate that your Web server will use for Secure Sockets Layer (SSL) connections. Possible Values:
|
|
If iCertSelection = CERT_SELECTION_NEW, type the full Internet name of your server. |
|
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 |
---|---|
|
If you want Exchange to handle your Internet e-mail using the SmallBusiness SMTP Connector, use this value. |
|
If you do not want to use Exchange for Internet e-mail, use this value. |
|
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 |
---|---|
|
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". |
|
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 |
---|---|
|
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. |
|
If you want to download e-mail from an SMTP server at your ISP, type TRUE. Otherwise, type FALSE. |
|
Complete this property only if you defined bExchangeReceive = TRUE. Type your dequeue method. Possible Values:
|
|
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 |
---|---|
|
Type the name of the account used to authenticate Exchange to your ISP's e-mail server. |
|
Type the password for the account used to authenticate Exchange to your ISP's e-mail server. |
|
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 |
---|---|
|
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. |
|
Complete this property only if you defined bCustomSchedule = FALSE. Type the interval in hours (0-24) for sending and receiving e-mail. |
|
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
|
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 |
---|---|
|
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.
Zie ook
Concepten
Understanding the Configure E-mail and Internet Connection Wizard
Understanding the Configure E-mail and Internet Connection Wizard script