03-Interface

HomeSupportResource CenterH3C Access Controllers Command References(E5208P03 E5215P01 R5215P01)-6W10203-Interface
01-Bulk interface commands
Title Size Download
01-Bulk interface commands 69.57 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 all existing interface ranges.

Examples

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

<Sysname> display interface range

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

Interface range name test gigabitethernet 1/0/11 gigabitethernet 1/0/12

The output shows the following:

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

·     Interfaces GigabitEthernet 1/0/11 and GigabitEthernet 1/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

Parameters

interface-list: Specifies a space-separated list of up to five 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 device or card. 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 the commands supported by the first interface in the interface range, enter the interface range view and enter a question mark (?) at the interface range prompt.

After a command is executed in interface range view, 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 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.

When you bulk configure interfaces, follow these guidelines:

·     Before you configure an interface as the first interface in an interface range, make sure you can enter the view of the interface by using the interface interface-type { interface-number | interface-number.subnumber } command.

·     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 1/0/1 through GigabitEthernet 1/0/4.

<Sysname> system-view

[Sysname] interface range gigabitethernet 1/0/1 to gigabitethernet 1/0/4

[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 five 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 device or card. 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 interface range prompt.

After a command is executed in interface range view, 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 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:

·     Before you configure an interface as the first interface in an interface range, make sure you can enter the view of the interface by using the interface interface-type { interface-number | interface-number.subnumber } command.

·     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 GigabitEthernet 1/0/1 through GigabitEthernet 1/0/12 to interface range named myEthPort, and enter the interface range view.

<Sysname> system-view

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