port-group

Function

The port-group command creates a permanent interface group and displays the interface group view or directly displays the view of a created permanent interface group.

The undo port-group command deletes a permanent interface group.

By default, no permanent interface group is created.

Format

port-group port-group-name

undo port-group port-group-name

Parameters

Parameter	Description	Value
port-group-name	Specifies the name of a permanent interface group.	The value is a string of 1 to 32 characters without spaces. When quotation marks are used around the string, spaces are allowed in the string. When configuring the name of an interface group, the uppercase and lowercase letters in the name must be consistent with what the user input. Interface group names are case-insensitive. For example, ABC and abc specify the same interface group. After ABC is configured for an interface group, the ABC interface group view will be displayed when you configure abc. Do not configure "all" as the name of a permanent interface group. Meanwhile, to avoid a usage conflict between the port-group group-member command and port-group-name, do not specify g, group-member, or first letters of group-member as the name of a permanent interface group.

Parameter

Description

Value

port-group-name

Specifies the name of a permanent interface group.

The value is a string of 1 to 32 characters without spaces.

When quotation marks are used around the string, spaces are allowed in the string.

When configuring the name of an interface group, the uppercase and lowercase letters in the name must be consistent with what the user input.
Interface group names are case-insensitive. For example, ABC and abc specify the same interface group. After ABC is configured for an interface group, the ABC interface group view will be displayed when you configure abc.
Do not configure "all" as the name of a permanent interface group. Meanwhile, to avoid a usage conflict between the port-group group-member command and port-group-name, do not specify g, group-member, or first letters of group-member as the name of a permanent interface group.

Views

System view

Default Level

2: Configuration level

Task Name and Operations

Task Name	Operations
interface-mgr	write

Usage Guidelines

Usage Scenario

A switching device provides multiple interfaces, many of which have the same configuration. To simplify the configuration of interfaces, run the port-group command to create a permanent interface group and add interfaces to the permanent interface group. When you run a command in the interface group view, the system automatically applies the command to all the interfaces in the permanent interface group. In this manner, interfaces in a permanent interface group are configured in a batch.

Follow-up Procedure

Run the group-member command to add one or more interfaces to the permanent interface group.

Precautions

Each VS supports a maximum of 64 permanent interface groups.

Example

# Create a permanent interface group named portgroup1, and add interfaces GE 0/1/9 to GE 0/1/11 to the permanent interface group.

<HUAWEI> system-view
[~HUAWEI] port-group portgroup1
[*HUAWEI-port-group-portgroup1] group-member GigabitEthernet 0/1/9 to GigabitEthernet 0/1/11