03-Layer 2—LAN Switching Command Reference

HomeSupportResource CenterSwitchesH3C S6300 Switch SeriesH3C S6300 Switch SeriesTechnical DocumentsCommandCommand ReferencesH3C S6300 Switch Series Command References-Release 243x-6W10003-Layer 2—LAN Switching Command Reference
03-Bulk interface commands
Title Size Download
03-Bulk interface commands 48.20 KB

Bulk interface configuration commands

display interface range

Use display interface range to display information about the interface ranges created by using the interface range name command.

Syntax

display interface range [ name name ]

Views

Any view

Predefined user roles

network-admin

network-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 the interface ranges created by using the interface range name command.

Examples

# Display information about all existing interface ranges created by using the interface range name command.

<Sysname> display interface range

Interface range name t2 Ten-GigabitEthernet1/0/1 Ten-GigabitEthernet1/0/2

Interface range name test Ten-GigabitEthernet1/0/11 Ten-GigabitEthernet1/0/12

The output shows the following:

·     Interfaces Ten-GigabitEthernet 1/0/1 and Ten-GigabitEthernet 1/0/2 are added to interface range t2.

·     Interfaces Ten-GigabitEthernet 1/0/11 and Ten-GigabitEthernet 1/0/12 are added to interface range 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

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-number to interface-type interface-number. When you specify the to keyword in interface-type interface-number1 to interface-type interface-number2, the last-tier value of the interface number before to must not be greater than the one after to. The values of the other tiers of the interface number before to must be the same as the one after to.

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.

After a command is executed in interface range view, one of the following situations might occur:

·     The system stays in interface range view and does not display an error message. It means that the execution succeeded on all member interfaces in the interface range.

·     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 the other member interfaces.

·     The system returns to system view. It means that:

¡     The command is supported in both system view and interface view.

¡     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 in system view is not needed, 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 bulk configure interfaces, follow these guidelines:

·     You cannot enter the view of some interfaces by using the interface interface-type interface-number command. 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 Ten-GigabitEthernet 1/0/1 through Ten-GigabitEthernet 1/0/24, and VLAN-interface 2.

<Sysname> system-view

[Sysname] interface range ten-gigabitethernet 1/0/1 to ten-gigabitethernet 1/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

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-number to interface-type interface-number. When you specify the to keyword in interface-type interface-number1 to interface-type interface-number2, the last-tier value of the interface number before to must not be greater than the one after to. The values of the other tiers of the interface number before to must be the same as the one after to.

Usage guidelines

You can use the command to assign a name to an interface range and 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.

After a command is executed in interface range view, one of the following situations might occur:

·     The system stays in interface range view and does not display an error message. It means that the execution succeeded on all member interfaces in the interface range.

·     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 the other member interfaces.

·     The system returns to system view. It means that:

¡     The command is supported in both system view and interface view.

¡     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 in system view is not needed, 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 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 command. 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. As a best practice to guarantee bulk interface configuration performance, configure fewer than 1000 interface range names.

Examples

# Add Ten-GigabitEthernet 1/0/1 through Ten-GigabitEthernet 1/0/12 to interface range myEthPort, and enter the interface range view.

<Sysname> system-view

[Sysname] interface range name myEthPort interface ten-gigabitethernet 1/0/1 to ten-gigabitethernet 1/0/12

[Sysname-if-range-myEthPort]

# Enter the view of interface range myEthPort.

<Sysname> system-view

[Sysname] interface range name myEthPort

[Sysname-if-range-myEthPort]

Related commands

display interface range