These task sequence variables govern the operation of the task sequence action. Variables marked as input variables are read or used by the task sequence action. In most cases, input variables correspond to task sequence action fields in the task sequence editor and can be set via that user interface. Alternatively, input variables can be set at runtime from per-collection or per-computer variables, via the Set Task Sequence Variable action or via the TSEnvironment COM object. Variables marked as output variables are written or set by the task sequence action to be read by later actions in the task sequence.

Apply Network Settings Task Sequence Action

Action Variable Name Description

OSDAdapter

(input)

This task sequence variable is an array variable. Each element in the array represents the settings for a single network adapter on the computer. The settings defined for each adapter can be accessed by combining the array variable name with the zero-based network adapter index and the property name.

Note
If multiple network adapters will be configured with this task sequence action, the properties for the second network adapter can be defined by using their index in the variable name; for example, OSDAdapter1EnableDHCP, OSDAdapter1IPAddressList, OSDAdapter1DNSDomain, OSDAdapter1WINSServerList, OSDAdapter1EnableWINS, and so on.

For example, the following variable names can be used to define the properties for the first network adapter that will be configured by this task sequence action:

  • OSDAdapter0EnableDHCP – true to enable Dynamic Host Configuration Protocol (DHCP) for the adapter.

  • OSDAdapter0IPAddressList – Comma-delimited list of IP addresses for the adapter. This property is ignored unless EnableDHCP is set to false.

  • OSDAdapter0SubnetMask – Comma-delimited list of subnet masks. This property is ignored unless EnableDHCP is set to false.

  • OSDAdapter0SubnetMask – Comma-delimited list of subnet masks. This property is ignored unless EnableDHCP is set to false.

  • OSDAdapter0Gateways – Comma-delimited list of IP gateway addresses. This property is ignored unless EnableDHCP is set to false.

  • OSDAdapter0DNSDomain - Domain Name System (DNS) domain for the adapter.

  • OSDAdapter0DNSServerList – Comma-delimited list of DNS servers for the adapter.

  • OSDAdapter0EnableDNSRegistrationtrue to register the IP address for the adapter in DNS.

  • OSDAdapter0EnableFullDNSRegistrationtrue to register the IP address for the adapter in DNS under the full DNS name for the computer.

  • OSDAdapter0EnableIPProtocolFilteringtrue to enable IP protocol filtering on the adapter.

  • OSDAdapter0IPProtocolFilterList – Comma-delimited list of protocols allowed to run over IP. This property is ignored if EnableIPProtocolFiltering is set to false.

  • OSDAdapter0EnableTCPFilteringtrue to enable TCP port filtering for the adapter.

  • OSDAdapter0TCPFilterPortList – Comma-delimited list of ports to be granted access permissions for TCP. This property is ignored if EnableTCPFiltering is set to false.

  • OSDAdapter0TcpipNetbiosOptions – Options for NetBIOS over TCP/IP. Possible values are as follows:

    • 0 Use NetBIOS settings from DHCP server.

    • 1 Enable NetBIOS over TCP/IP.

    • 2 Disable NetBIOS over TCP/IP.

    OSDAdapter0EnableWINStrue to use WINS for name resolution.

  • OSDAdapter0WINSServerList – Comma-delimited list of WINS server IP addresses. This property is ignored unless EnableWINS is set to true.

  • OSDAdapter0MacAddress – Media access controller (MAC) address used to match settings to physical network adapter.

  • OSDAdapter0Name – Name of the network connection as it appears in the network connections control panel program. The name is between 0 and 255 characters in length.

  • OSDAdapter0Index – Index of the network adapter settings in the array of settings.

OSDAdapterCount

(input)

Specifies the number of network adapters installed on the target computer.

OSDDNSDomain

(input)

Specifies the primary DNS server that will be used by the target computer.

OSDDomainName

(input)

Specifies the name of the Windows domain that the target computer should join. The specified value must be a valid Active Directory Domain Services domain name.

OSDDomainOUName

(input)

Specifies the RFC 1779 format name of the organizational unit (OU) that the target computer should join. If specified, the value must contain the full path.

Example:

LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com

OSDEnableTCPIPFiltering

(input)

Specifies whether TCP/IP filtering should be enabled.

Valid values:

"true"

"false" (default)

OSDJoinAccount

(input)

Specifies the network account that should be used to add the target computer to a Windows domain.

OSDJoinPassword

(input)

Specifies the network password that should be used to add the target computer to a Windows domain.

OSDNetworkJoinType

(input)

Specifies the type of network that the target computer should join as part of the operating system deployment.

"0" indicates that the target computer should join a Windows domain. "1" specifies that the computer should join a workgroup.

Valid values:

"0"

"1"

OSDDNSSuffixSearchOrder

(input)

Specifies the DNS search order for the target computer.

OSDWorkgroupName

(input)

Specifies the name of the workgroup that the target computer should join.

You must specify either this value or the OSDDomainName value. The workgroup name can be a maximum of 32 characters.

Example:

"Accounting"

See Also