[WindowsFirewall.<program_name>] (Unattend.txt)

[WindowsFirewall.program_name]

Answer File = Unattend.txt and Winbom.ini; WinbomType = Factory

Windows Firewall is On by default. In this mode, Windows Firewall drops all unsolicited, incoming traffic, except traffic that matches enabled entries in the Windows Firewall Exceptions list. Some application programs require dynamic ports to be opened in order to function properly. You can change the default settings in Windows Firewall to allow incoming traffic for certain programs by adding each program to the Windows Firewall Exceptions list.

Only programs that require unsolicited, incoming traffic should be added to the Windows Firewall Exceptions list. There is no benefit to adding programs that use only outgoing connections to the Windows Firewall Exceptions list.

The [WindowsFirewall.<program_name>] section is a user-defined section that can be used to add programs to the Windows Firewall Exceptions list. You may add as many programs as necessary. Each program_name must be unique. You must add the [WindowsFirewall.<program_name>] to the [WindowsFirewall.<profile_name>] section. Use the [WindowsFirewall.<program_name>] section with the following sections in your answer file to change the default settings in Windows Firewall.

Entry	Description
Program	Specifies the path of a program to be added to the Windows Firewall Exceptions list. This is a required entry.
Name	Specifies the name of a program to be added to the Windows Firewall Exceptions list. This is a required entry.
Mode	Specifies whether to enable or disable an entry in the Windows Firewall Exceptions list.
Scope	Defines the set of limits on which computers (IP addresses) are allowed to send traffic through the specified exception (program, service). The Mode must be set to 1 (on).
Addresses	Specifies the addresses for an entry in the Windows Firewall Exceptions list.

Sample

This sample demonstrates one use of the [WindowsFirewall.program_name] section of Unattend.txt.

[WindowsFirewall.RemoteAssistance]
Program = %WINDIR%\System32\Sessmgr.exe
Name = Remote Assistance
Mode = 1
Scope = 2
Addresses = 192.168.0.5,LocalSubnet

Program

Specifies the program's image path. This is the fully qualified path for the file to be added to Windows Firewall's default Exceptions lists. It may include environmental variables, such as %ProgramFiles%.

Syntax	Program = path
Value	path_name
Example	Program = %WINDIR%\system32\sessmgr.exe
Comments	This is a required entry.

icon Return to top

Name

Specifies the name that is used to represent the entry for Windows Firewall in the Windows Firewall applet in Control Panel.

Syntax	Name = program_name
Value	program_name
Example	Name = MSN Messenger v6.1
Comments	This is a required entry.

icon Return to top

Mode

Specifies whether an entry added to the Windows Firewall default Exceptions list is either enabled or disabled.

Syntax	Mode = 0 \| 1
Values	1 Enables an entry in the Windows Firewall Exceptions list. Ports are dynamically opened in Windows Firewall for the program. 0 Disables an entry in the Windows Firewall Exceptions list. Ports are not dynamically opened in Windows Firewall for the program.
Default	1
Example	Mode = 1
Comments	This is a required entry.

icon Return to top

Scope

Defines the set of limits on which computers (IP addresses) are allowed to send traffic through the specified exception (program, service). The Mode must be set to 1 (on).

Syntax	Scope = 0 \| 1 \| 2
Values	0 Enables unsolicited, incoming traffic with no limitations. Any computer can send traffic through this exception. 1 Enables unsolicited, incoming traffic that matches the exception from any computer on the same local subnet as the network connection on which the traffic was received through Windows Firewall, while dropping unsolicited, incoming traffic from all other computers. 2 Defines a custom scope, which is a collection of IP addresses and subnets. Unsolicited, incoming traffic that matches the exception and originates from a computer in the defined collection is enabled through Windows Firewall.
Default Value	0
Example	Scope = 192.168.0.5,LocalSubnet
Comments	When enabling Remote Assistance, opening a port, or enabling a program, the set of IP addresses from which the unsolicited, incoming traffic is enabled can be defined using this entry.

icon Return to top

Addresses

Specifies the IP addresses in the Scope entry.

Syntax	Addresses = IP_addresses
Values	IP_addresses
Example	Addresses = 192.168.0.5,LocalSubnet
Comments	This entry is ignored unless the Scope entry is set to 2.

icon Return to top