interface range name
Use interface range name name interface interface-list to create a named 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 a named 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 specifies a subrange of interfaces in the form of interface-type interface-number1 to interface-type interface-number2. When you specify a subrange of interfaces, the start interface number must be identical to or lower than the end interface number.
Usage guidelines
A named interface range is saved in the running configuration and can be used repeatedly to bulk configure its member interfaces.
In interface range view, only commands supported by the first interface in the specified interface list are available for configuration. To view available commands, enter a question mark (?) in interface range view.
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 one or multiple member interfaces.
If the execution failed on the first member interface, the command is not executed on any member interfaces.
If the execution failed on a non-first member interface, the command takes effect on the remaining 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, you can execute the display this command in interface range view.
To view the member interfaces of a named 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.
Understand that the more interfaces you specify, the longer the command execution time.
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