port-group

Function

The port-group command creates a permanent port group and displays the permanent port group view.

The undo port-group command deletes permanent port groups.

By default, no permanent port group is configured.

Format

port-group port-group-name

undo port-group { all | port-group-name }

Parameters

Parameter	Description	Value
port-group-name	Specifies the name of a permanent interface group. The value cannot conflict with the group-member keyword. For example, the name cannot be g, gr, or group-m.	The value is a string of 1 to 32 case-insensitive characters without spaces. When double quotation marks are used around the string, spaces are allowed in the string. NOTE: A permanent port group cannot be named all. 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.
all	Deletes all port groups.	-

Views

System view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If you need to perform the same operations on multiple Ethernet interfaces, configuring each interface one by one easily causes incorrect configurations and is labor-intensive.

The port group function easily solves the problem. You can add all the Ethernet interfaces to the same port group. After you run a configuration command once in the port group view, the configuration takes effect on all the Ethernet interfaces in the port group, reducing the configuration workload.

Two types of port groups are available:

Temporary port group: To temporarily deliver a configuration to multiple interfaces, you can create a temporary port group. After you deliver the configuration and exit from the port group view, the system automatically deletes the temporary port group.
Permanent port group: To deliver configurations to interfaces multiple times, you can create a permanent port group. After you exit from the port group view, the port group and member interfaces in the group still exist, facilitating subsequent batch configuration for the member interfaces. To delete a permanent port group, run the undo port-group { all | port-group-name } command.

Follow-up Procedure

Run the group-member command to add Ethernet interfaces to the created permanent port group.

Precautions

The system supports a maximum of 32 permanent port groups and each port group supports a maximum of 48 member interfaces.

Example

# Create port group portgroup1 and enter the port group view.

<HUAWEI> system-view
[HUAWEI] port-group portgroup1
[HUAWEI-port-group-portgroup1]