sta-mac

Function

The sta-mac command adds the MAC addresses of a STA to the blacklist or whitelist.

The undo sta-mac command deletes a specified STA MAC address or all STA MAC addresses from the blacklist or whitelist.

By default, the MAC address of a STA is not added to the blacklist or whitelist.

Format

sta-mac mac-address [ description description ]

undo sta-mac { mac-address | all }

Parameters

Parameter	Description	Value
mac-address	Adds a MAC address to the blacklist or whitelist.	The value is in H-H-H format. An H is a hexadecimal number of 4 digits.
description	Adds MAC address description to a blacklist or whitelist.	The value is a string of 1 to 80 case-insensitive characters that can include Chinese or Chinese+English characters. NOTE: You can only use a command editor of the UTF-8 encoding format to edit Chinese characters.
all	Deletes all MAC addresses from the blacklist or whitelist.	-

Views

STA blacklist profile view, STA whitelist profile view

Default Level

2: Configuration level

Usage Guidelines

If the blacklist function is enabled, all STAs in the blacklist cannot connect to the WLAN.

If the whitelist function is enabled, only STAs in the whitelist can connect to the WLAN.

MAC addresses and OUIs share specifications in the whitelist. A maximum of 3276 MAC addresses or OUIs can be added to a STA whitelist.

A maximum of 3276 STA MAC addresses can be added to a STA blacklist profile.

If a STA is added to the blacklist, the system automatically disconnects the STA.

STAs that have gone online before a whitelist is configured are not forced to go offline even if they are not on the whitelist.

Example

# Add the MAC address 2C27-D720-746B of a STA to the blacklist profile sta-blacklist-profile1.

<HUAWEI> system-view
[HUAWEI] wlan
[HUAWEI-wlan-view] sta-blacklist-profile name sta-blacklist-profile1
[HUAWEI-wlan-blacklist-prof-sta-blacklist-profile1] sta-mac 2C27-D720-746B