Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide

commadmin group modify

The commadmin group modify command changes the attributes of a single group that already exists in the Access Manager. To change the attributes of multiple groups, use the -i option.

A mailing list is one type of group. When a message is sent to the group address, Access Manager sends the message to all members in the group.

Syntax

commadmin group modify -D login -G groupname -n domain -w password
   [-A [+|-]attributename:value] [-d domain] [-f [action]ldap-filter] [-h] [-?]
   [-i inputfile] [-m [+|-]internal-member] [-p AM port] [-s] [-v] [-V] [-X AM host]
   [-S mail [-o owner] [-E email] [-H mailhost] [-M external-member] [-r moderator]]

Options

The following are mandatory options:

Option  

Description  

-D login

The user ID of the user with permission to execute this command. 

-G groupname

The name of the group to be modified. For example, mktg-list.

-n domain

The domain of the user specified by the -D option.

-w password

The password of the user specified by the -D option.

The following are non-mandatory options:

Option  

Description  

-A [+ | -]attributename:value

An attribute to modify. The attributename is defined in the LDAP schema and value replaces any and all current values for this attribute in the directory. Repeat this option to modify multiple attributes at the same time, or to specify multiple values for the same attribute.

A “+” before the attributename indicates adding the value to the current list of attributes. A “-” indicates removing the value. If the “-” is used, it must be preceded by two backslashes or enclosed in quotes if the command is specified on the command line. If the option is provided within an input file, one backslash must precede the “-” sign.

-d domain

The domain of the group. If -d is not specified, the domain specified by the -n option is used.

- f [action] ldap-filter

Indicates whether a ldap filter is added to or removed from the group 

A “+” before the ldap-filter indicates that it is to be added to the existing filters. A “-” indicates removing the existing filter. Type -f-* to remove all the filters. If the “-” is used, it must be preceded by two backslashes or enclosed in quotes if the command is specified on the command line.

If action is not specified, by default the filter is added provided it is not already present. Otherwise an error message is displayed.

-h, -?

Prints command usage syntax. 

-i inputfile

Reads the command information from a file instead of the command line. 

-m [action] internal -member

Indicates whether to add or remove an internal member. 

The value of internal-member is either a mail address or user ID.

An action value of:

+ adds the member to an existing list of internal members. 

- removes the member from an existing list of internal members. If the “-” is used, it must be preceded by two backslashes or enclosed in quotes if the command is specified on the command line. 

-m-* removes all the internal members.

-p AM port

Specifies an alternate TCP port where the Access Manager is listening. If not specified, the default AM port is used, or Port 80 is used if no default was configured at install time.

-s

Use SSL (Secure Socket Layer) to connect to the Access Manager. 

-v

Enable debugging output. 

-V

Prints information about the utility and its version. 

-X AM host

Specifies the host on which the Access Manager is running. If not specified, the default AM host is used, or the localhost if no default was configured at install time.

-S mail

Adds mail service to the group during modification after validating whether the mail service already exists. If the service exists an error message is displayed. 

The only valid value for -S is mail.

The following options are only allowed if the -S mail option is specified:

 

-o owner

The group owner’s email address. An owner is the individual responsible for the distribution list. 

An owner can add or delete distribution list members. 

-E email

The email address of the group. 

-H mailhost

The group’s mail host. The default is the local mail host. 

-M external -member

Adds an external member. 

The value of external-member is the user mail address.

-r moderator

The moderator’s user ID. Type the email address if the moderator is in a different domain. 

The -S mail option must be specified with this option.

Example

To remove an internal member (jsmith) from the group testgroup within the domain varrius.com:


commadmin group modify -D chris -d varrius.com -G testgroup -n sesta.com \
-w bolton -m \\-jsmith