Skip to main content
A newer release of this product is available.

vserver group-mapping modify

Suggest changes

Modify a group mapping's pattern, replacement pattern, or both

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.


The vserver group-mapping modify command modifies the pattern, the replacement pattern, or both of a specified group mapping.

You can specify patterns as POSIX regular expressions. For information about regular expressions, see the UNIX reference page for regex(7) .

Each Vserver can have up to 1024 group mappings in each direction.

The vserver group-mapping modify command is not supported on Vservers with FlexVol volumes.

Note If you are using the CLI, you must delimit all regular expressions with double quotation marks ("). For instance, to enter the regular expression (.) in the CLI, type "(.)" at the command prompt. To add a "?" to the expression, press ESC followed by the "?".


-vserver <vserver name> - Vserver

This parameter specifies the Vserver on which you want to modify the group mapping.

-direction {krb-unix|win-unix|unix-win} - Name Mapping Direction

This parameter specifies the direction of the group mapping. Possible values are krb-unix for a Kerberos-to-UNIX group mapping, win-unix for a Windows-to-UNIX group mapping, and unix-win for a UNIX-to-Windows group mapping.

-position <integer> - Position

This parameter specifies the group mapping's position in the priority list. A position is specified as a positive integer. Each mapping direction (Kerberos-to-UNIX, Windows-to-UNIX, and UNIX-to-Windows) has its own priority list.

[-pattern <text>] - Pattern

This parameter specifies the pattern you want to match. Refer to the command description section for details. The pattern can be up to 256 characters in length.

[-replacement <text>] - Replacement

This parameter specifies the replacement pattern. The replacement pattern can be up to 256 characters in length.


The following example modifies the group mapping on the Vserver named vs1 and direction win-unix, at position 3. The pattern to be matched is changed to "EXAMPLE\(.+)".

cluster1::> vserver group-mapping modify -vserver vs1 -direction win-unix -position 3 -pattern "EXAMPLE\\(.+)"