Bulk interface configuration commands 1

display interface range· 1

interface range· 1

interface range name· 3

 

display interface range

Use display interface range to display information about the specified interface range or all existing interface ranges.

Syntax

display interface range [ name name ]

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-operator

Parameters

name name: Specifies an interface range by its name, a case-sensitive string of 1 to 32 characters. If you do not specify an interface range name, the command displays information about all existing interface ranges.

Examples

# Display information about all existing interface ranges.

<Sysname> display interface range

Interface range name t2 GigabitEthernet3/0/1 GigabitEthernet3/0/2

Interface range name test GigabitEthernet3/0/11 GigabitEthernet3/0/12

The output shows the following:

·     Interfaces GigabitEthernet 3/0/1 and GigabitEthernet 3/0/2 are added to interface range named t2.

·     Interfaces GigabitEthernet 3/0/11 and GigabitEthernet 3/0/12 are added to interface range named test.

Related commands

interface range name

interface range

Use interface range to create an interface range and enter the interface range view.

Syntax

interface range interface-list

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

interface-list: Specifies a space-separated list of up to 24 interface items. Each item specifies an interface by its type and number or a range of interfaces in the form of interface-type interface-number1 to interface-type interface-number2. When you specify the to keyword, the interfaces before and after the to keyword must be on the same interface card or subcard. The last-tier value of interface-number1 must not be greater than interface-number2. The values of the other tiers of interface-number1 must be the same as interface-number2.

Usage guidelines

Use the command to enter interface range view to bulk configure multiple interfaces with the same feature instead of configuring them one by one. For example, run the shutdown command in interface range view to shut down a range of interfaces.

In interface range view, only the commands supported by the first interface are available. The first interface is specified with the interface range command. To view these commands in the interface range, enter the interface range view, and then enter ? at the prompt.

When a command is executed in interface range view, the system tries to execute the command on all member interfaces in the interface range. One of the following situations might occur:

·     The system displays an error message and stays in interface range view. It means that the execution failed on member interfaces in the interface range.

¡     If the execution failed on the first member interface in the interface range, the command is not executed on any member interfaces.

¡     If the execution failed on non-first member interfaces, the command takes effect on member interfaces except the member interfaces where the execution failed.

·     The system returns to system view. It means the command is supported in both system view and interface view. If the execution failed on a member interface in interface range view and succeeded in system view, the command is not executed on the subsequent member interfaces.

You can use the display this command to verify the configuration in interface view of each member interface. In addition, if the configuration is not needed in system view, use the undo form of the command to remove the configuration.

To verify the configuration of the first interface in the interface range, execute the display this command in interface range view.

When you bulk configure interfaces, follow these guidelines:

·     You cannot enter the view of some interfaces by using the interface interface-type { interface-number | interface-number.subnumber } command (for example, BRI 1/1/1:1). Do not configure any of these interfaces as the first interface in the interface range.

·     Do not assign both an aggregate interface and any of its member interfaces to an interface range. Some commands, after being executed on both an aggregate interface and its member interfaces, can break up the aggregation.

·     No limit is set on the maximum number of interfaces in an interface range. The more interfaces in an interface range, the longer the command execution time.

Examples

# Shut down interfaces GigabitEthernet 3/0/1 through GigabitEthernet 3/0/24 and VLAN-interface 2.

<Sysname> system-view

[Sysname] interface range GigabitEthernet 3/0/1 to GigabitEthernet 3/0/24 vlan-interface 2

[Sysname-if-range] shutdown

interface range name

Use interface range name name interface interface-list to create an interface range, configure a name for the interface range, and enter the interface range view.

Use interface range name name without the interface keyword to enter the view of an interface range with the specified name.

Use undo interface range name to delete the interface range with the specified name.

Syntax

interface range name name [ interface interface-list ]

undo interface range name name

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

name: Specifies an interface range name, a case-sensitive string of 1 to 32 characters.

interface-list: Specifies a space-separated list of up to 24 interface items. Each item specifies an interface by its type and number or a range of interfaces in the form of interface-type interface-number1 to interface-type interface-number2. When you specify the to keyword, the interfaces before and after the to keyword must be on the same interface card or subcard. The last-tier value of interface-number1 must not be greater than interface-number2. The values of the other tiers of interface-number1 must be the same as interface-number2.

Usage guidelines

You can use the command to assign a name to an interface range. Then, you can specify this name rather than the interface range to enter the interface range view.

In interface range view, only the commands supported by the first interface are available. The first interface is specified with the interface range command. To view the commands supported by the first interface in the interface range, enter the interface range view and enter a question mark (?) at the command line interface prompt.

When a command is executed in interface range view, the system tries to execute the command on all member interfaces in the interface range. One of the following situations might occur:

·     The system displays an error message and stays in interface range view. It means that the execution failed on member interfaces in the interface range.

¡     If the execution failed on the first member interface in the interface range, the command is not executed on any member interfaces.

¡     If the execution failed on non-first member interfaces, the command takes effect on member interfaces except the member interfaces where the execution failed.

·     The system returns to system view. It means the command is supported in both system view and interface view. If the execution failed on a member interface in interface range view and succeeded in system view, the command is not executed on the subsequent member interfaces.

You can use the display this command to verify the configuration in interface view of each member interface. In addition, if the configuration is not needed in system view, use the undo form of the command to remove the configuration.

To verify the configuration of the first interface in the interface range, execute the display this command in interface range view.

To view the member interfaces of an interface range, use the display current-configuration | include "interface range" command.

When you bulk configure interfaces, follow these guidelines:

·     You cannot enter the view of some interfaces by using the interface interface-type { interface-number | interface-number.subnumber } command (for example, BRI 1/1/1:1). Do not configure any of these interfaces as the first interface in the interface range.

·     Do not assign both an aggregate interface and any of its member interfaces to an interface range. Some commands, after being executed on both an aggregate interface and its member interfaces, can break up the aggregation.

·     No limit is set on the maximum number of interfaces in an interface range. The more interfaces in an interface range, the longer the command execution time.

·     The maximum number of interface range names is limited only by the system resources. To guarantee bulk interface configuration performance, H3C recommends that you configure fewer than 1000 interface range names.

Examples

# Add GigabitEthernet 3/0/1 through GigabitEthernet 3/0/12 to interface range named myEthPort, and enter interface range view.

<Sysname> system-view

[Sysname] interface range name myEthPort interface GigabitEthernet 3/0/1 to GigabitEthernet 3/0/12

[Sysname-if-range-myEthPort]

# Enter the view of interface range named myEthPort.

<Sysname> system-view

[Sysname] interface range name myEthPort

[Sysname-if-range-myEthPort]

Related commands

display interface range