match

Function

The match command configures a matching rule for a group on the Commander.

The undo match command deletes a matching rule for a group on the Commander.

By default, a group has no matching rule.

Format

match mac-address mac-address [ mac-mask | mac-mask-length ]

match esn esn

match ip-address ip-address [ ip-mask | ip-mask-length ]

match model model

match device-type device-type

undo match mac-address [ mac-address [ mac-mask | mac-mask-length ] ]

undo match esn [ esn ]

undo match ip-address [ ip-address [ ip-mask | ip-mask-length ] ]

undo match model [ model ]

undo match device-type [ device-type ]

Parameters

Parameter	Description	Value
mac-address mac-address	Configures a MAC address-based matching rule. A group can have multiple MAC addresses or MAC address ranges specified. A client matches the group as long as it matches one of MAC addresses.	The value is in the H-H-H format, where each H contains four hexadecimal digits.
mac-mask	Specifies the mask of a MAC address.	The value is in the H-H-H format, where each H contains four hexadecimal digits. By default, the mask is ffff-ffff-ffff.
mac-mask-length	Specifies the mask length of a MAC address.	The value is an integer that ranges from 0 to 48. By default, the mask length is 48.
esn esn	Configures an ESN-based matching rule. A group can have multiple ESNs specified. A client matches the group as long as it matches one of ESNs.	The value is a string of 10 to 32 case-insensitive characters without spaces.
ip-address ip-address	Configures an IP address-based matching rule. A group can have multiple IP addresses or IP address ranges (for example 192.168.110.0) specified. A client matches the group as long as it matches one of IP addresses.	The value is in dotted decimal notation.
ip-mask	Specifies the mask of an IP address.	The value is in dotted decimal notation. By default, the mask is 255.255.255.255.
ip-mask-length	Specifies the mask length of an IP address.	The value is an integer that ranges from 0 to 32. By default, the mask length is 32.
model model	Configures a device model-based matching rule.	The value is a string of 1 to 32 case-insensitive characters without spaces.
device-type device-type	Configures a device type-based matching rule.	The value is a string of 1 to 32 case-insensitive characters without spaces.

Views

Easy-Operation group view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After configuring a customized group on the Commander, configure matching rules for the group. A client can obtain the files specified in a group only when it matches a rule in the group.

Precautions

A matching rule can be configured only in a customized group of the corresponding type. For example, the match mac-address mac-address command can only be used in a MAC address-based customized group.
A MAC address-based, ESN-based, or IP address-based group each supports a maximum of 256 matching rules. The total number of group rules on the device cannot exceed 256.
For groups created based on device models, only one matching rule can be defined for each group. The device model specified in a device model-based group must be the same as the actual device model. Otherwise, clients cannot match the group.
For groups created based on device types, only one matching rule can be defined for each group. The device type specified in a device type-based group must be the same as the actual device type. Otherwise, clients cannot match the group.

Example

# Configure two MAC address-based matching rules in a customized group.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] group custom mac-address test
[HUAWEI-easyoperation-group-custom-test] match mac-address 70F3-950B-1A52
[HUAWEI-easyoperation-group-custom-test] match mac-address 70F3-950B-1B36