ap-regroup

Function

The ap-regroup command changes the group that an AP joins.

Format

ap-regroup { ap-name ap-name | ap-id ap-id } new-group new-group-name

Parameters

Parameter	Description	Value
ap-name ap-name	Specifies an AP name.	The AP name must exist.
ap-id ap-id	Specifies an AP ID.	The AP ID must exist. The value is a string of 1 to 255 characters. When multiple APs are selected, use commas (,) to separate AP IDs or use hyphens (-) to indicate continuous AP IDs. For example, 5,8,10-13,20 indicates the list of APs with IDs 5, 8, 10, 11, 12, 13, and 20.
new-group new-group-name	Specifies the name of the new group to which the AP is added.	The AP group must exist.

Parameter

Description

Value

ap-name ap-name

Specifies an AP name.

The AP name must exist.

ap-id ap-id

Specifies an AP ID.

The AP ID must exist.

The value is a string of 1 to 255 characters. When multiple APs are selected, use commas (,) to separate AP IDs or use hyphens (-) to indicate continuous AP IDs. For example, 5,8,10-13,20 indicates the list of APs with IDs 5, 8, 10, 11, 12, 13, and 20.

new-group new-group-name

Specifies the name of the new group to which the AP is added.

The AP group must exist.

Views

WLAN view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

If the current AP group is not applicable to an AP or the AP is added to an incorrect group, you can run this command to delete the AP from the current AP group and add the AP to a new AP group.

Prerequisites

The AP group has been created using the ap-group command.

Configuration Impact

Changing the group of an AP will restart the AP and interrupt services. Exercise caution when you run the command.

Example

# Change the group that an AP joins to the AP group group1.

<HUAWEI> system-view
[HUAWEI] wlan 
[HUAWEI-wlan-view] ap-group name group1
[HUAWEI-wlan-ap-group-group1] quit
[HUAWEI-wlan-view] ap-regroup ap-name 1047-80b1-56a0 new-group group1
Warning: This operation may cause AP reset. If the country code changes, it will clear channel, power and antenna gain configuration s of the radio, Whether to continue? [Y/N]:y