(Sysprep)
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
[params.adapter instance]
The [params.adapter instance] section contains entries for specifying an adapter’s instance on a computer by using either PCI location information or a Plug and Play device ID.
The PCI location information comprises three entries: PCIBusNumber, PCIDeviceNumber, and PCIFunctionNumber. If you are using PCI location information to specify an adapter, you must use all of these entries to ensure that Setup applies all of the networking settings based on the PCI location. However, adding devices after Setup installs the operating system can cause bus numbers to change. As a result, the answer file might not work properly on every destination computer. In addition, if your destination computers have different adapters (that is, adapters with different Plug and Play IDs), you can specify the adapters by using the explicit Plug and Play IDs of each adapter instead of the PCI location information.
Answer File Entries for the [ params.adapter instance ] Section
| Entry | Description |
|---|---|
ConnectionName |
Specifies the name for the network connection associated with the network adapter to install. |
DMA |
Specifies the direct memory access (DMA) channel setting of a network adapter. |
DoNotDetectLegacyCards |
Specifies legacy (non-Plug and Play) adapters that Setup can ignore when trying to detect the network adapters on a computer. |
InfID |
Identifies a network adapter with a value that is the same as the adapter’s Plug and Play ID. |
IOAddr |
Specifies the I/O address (hexadecimal number) of a network adapter. |
IRQ |
Specifies the interrupt number setting of a network adapter. |
MEM |
Specifies the memory base address setting of a network adapter. |
NetCardAddress |
Specifies the media access control address for the network adapter being configured. |
PCIBusNumber |
Indicates the PCI bus on which the network card resides. |
PCIDeviceNumber |
Indicates the PCI device number for the network card and approximately relates to the particular slot number in which the network card resides on the given PCI bus. |
PCIFunctionNumber |
Defines which function on the card provides the networking function. |
ConnectionName
Specifies the name for the network connection associated with the network adapter to install.
Syntax
ConnectionName = network_connection_name
| Value | Description |
|---|---|
network_connection_name |
Network connection name. |
Example
[params.adapter instance]
ConnectionName = "Corporate Network"
Comments
If you do not specify this entry or its value is empty, use the default connection name of “Local Area Connection” for the first enumerated network adapter and “Local Area Connection x” for subsequent adapters where x starts from 2.
DMA
Specifies the direct memory access (DMA) channel setting of a network adapter.
Syntax
DMA = DMA_channel_number
| Value | Description |
|---|---|
DMA_channel_number |
DMA channel number. |
Example
[params.adapter instance]
DMA = 1
Comments
None.
DoNotDetectLegacyCards
Specifies legacy (non-Plug and Play) adapters that Setup can ignore when trying to detect the network adapters on a computer.
Syntax
DoNotDetectLegacyCards = InfID[, InfID, ]
| Value | Description |
|---|---|
InfID |
Inf ID. |
Example
[params.adapter instance]
DoNotDetectLegacyCards = *PNP030b,*PNP8132
Comments
Setup does not detect or install the network adapters specified by this entry.
This entry does not prevent Setup from enumerating and installing Plug and Play adapters.
Note
- The remaining entries in this section are optional and are meaningful only for non-Plug and Play adapters that require you to explicitly specify resources.
InfID
Identifies a network adapter with a value that is the same as the adapter’s Plug and Play ID.
Syntax
InfID = PnP_ID_of_adapter
| Value | Description |
|---|---|
PnP_ID_of_adapter |
Plug and Play ID. |
Example
[params.adapter instance]
InfID = *PNP030b
Comments
If you use the entry InfID = *, Setup matches the first enumerated or detected network adapter on the computer with the settings in this section. Therefore, on a computer with a single network card, you can specify adapter-specific entries without knowing the name or type of the network adapter.
For computers with more than one network adapter, you must specify the correct Plug and Play ID of each adapter. For computers with multiple adapters of the same type (that is, the Plug and Play ID for each is the same), you must specify the NetCardAddress or PCI location information. If you do not specify the NetCardAddress or PCI location, only the first adapter enumerated or detected that matches the InfID receives the answer file entries.
If you specify the NetCardAddress or PCI location, Setup does not use this entry because it is the least specific entry.
IOAddr
Specifies the I/O address (hexadecimal number) of a network adapter.
Syntax
IOAddr = numeric_IO_address
| Value | Description |
|---|---|
numeric_IO_address |
I/O address. |
Example
[params.adapter instance]
IOAddr = 330
Comments
None.
IRQ
Specifies the interrupt number setting of a network adapter.
Syntax
IRQ = IRQ_number
| Value | Description |
|---|---|
IRQ_number |
IRQ number. |
Example
[params.adapter instance]
IRQ = 5
Comments
None.
MEM
Specifies the memory base address setting of a network adapter.
Syntax
MEM = memory_range
| Value | Description |
|---|---|
memory_range |
Memory address. |
Example
[params.adapter instance]
MEM = 0xC123456
Comments
None.
NetCardAddress
Specifies the media access control address for the network adapter being configured.
Syntax
NetCardAddress = network_card_MAC_address
| Value | Description |
|---|---|
network_card_MAC_address |
MAC address. |
Example
[params.adapter instance]
NetCardAddress = 0x123456789AB
Comments
This entry is required when you install multiple network cards of the same type (with the same Plug and Play ID) on a computer and apply nondefault entries to the adapters.
This entry is not required for PCI adapters if you specify the PCI location information by using the PCIBusNumber, PCIDeviceNumber, and PCIFunctionNumber entries.
PCIBusNumber
Indicates the PCI bus on which the network card resides.
Syntax
PCIBusNumber = PCI_bus_number_of_adapter
| Value | Description |
|---|---|
PCI_bus_number_of_adapter |
PCI bus number. |
Example
[params.adapter instance]
PCIBusNumber = 0
PCIDeviceNumber = 11
PCIFunctionNumber = 0
Comments
This entry is one of the three required entries to specify the PCI location information for the network adapter. You must also specify PCIDeviceNumber and PCIFunctionNumber.
You must specify these PCI location entries if:
You do not specify NetCardAddress.
You install multiple network cards of the same type (with the same Plug and Play ID) on a computer.
You need to apply nondefault entries to the adapter.
If you specify NetCardAddress, Setup does not use the PCIBusNumber, PCIDeviceNumber, and PCIFunctionNumber entries because NetCardAddress provides more specific information than the PCI location information.
PCIDeviceNumber
Indicates the PCI device number for the network card and approximately relates to the particular slot number in which the network card resides on the given PCI bus.
Syntax
PCIDeviceNumber = PCI_device_number_of_adapter
| Value | Description |
|---|---|
PCI_device_number_of_adapter |
PCI device number. |
Example
[params.adapter instance]
PCIBusNumber = 0
PCIDeviceNumber = 11
PCIFunctionNumber = 0
Comments
This entry is one of the three required entries to specify the PCI location information for the network adapter. You must also specify PCIBusNumber and PCIFunctionNumber.
You must specify these PCI location entries if:
You do not specify NetCardAddress.
You install multiple network cards of the same type (with the same Plug and Play ID) on a computer.
You need to apply nondefault entries to the adapter.
If you specify NetCardAddress, Setup does not use the PCIBusNumber, PCIDeviceNumber, and PCIFunctionNumber entries because NetCardAddress provides more specific information than these three entries used for the PCI location information.
PCIFunctionNumber
Defines which function on the card provides the networking function.
Syntax
PCIFunctionNumber = PCI_function_number_of_adapter
| Value | Description |
|---|---|
PCI_function_number_of_adapter |
PCI function number. |
Example
[params.adapter instance]
PCIBusNumber = 0
PCIDeviceNumber = 11
PCIFunctionNumber = 0
Comments
This entry is useful if there is a combination modem/network card. The function number begins with 0.
This entry is one of the three required entries to specify the PCI location information for the network adapter. You must also specify PCIBusNumber and PCIDeviceNumber.
You must specify these PCI location entries if:
You do not specify NetCardAddress.
You install multiple network cards of the same type (with the same Plug and Play ID) on a computer.
You need to apply nondefault entries to the adapter.
If you specify NetCardAddress, Setup does not use the PCIBusNumber, PCIDeviceNumber, and PCIFunctionNumber entries because NetCardAddress provides more specific information than the PCI location information.