h1. {anchor:ACFFI} commadmin group delete
The {{commadmin group delete}} command marks a single group as deleted. To mark multiple groups as deleted, use the {{-i}} option.
To disable a group’s usage of services such as Calendar Server or Messaging Server use the {{-S}} option. Here {{S}} is in uppercase.
{info:title=Note}
In order to permanently remove a group, you must run the following command: {{commadmin domain purge}}. For details, see [commadmin domain purge].
{info}
h2. {anchor:ACFFJ} Syntax
{panel}
{{commadmin group delete –D _login_ –G _groupname_ –n _domain_ –w _password_ [–d _domain_]}}
{{ [–h] [–?] [–i _inputfile_] [–p _AM port_] [–s] [–S _service_] [–v] [–V] [–X _AM host_]}}
{panel}
h2. {anchor:ACFFK} Options
The following are mandatory options:
||Option ||Description ||
|{{-D}} _login_|The user ID of the user who has permission to execute this command.|
|{{-G}} _groupname_|The name of the group to be marked as deleted. 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 ||
|{{-d}} _domain_|The domain of the group. If {{-d}} is not specified, the domain specified by the {{-n}} option is used.|
|{{-h}}, {{–?}}|Prints command usage syntax.|
| {{-i}} _inputfile_ | Reads the command information from a file instead of the command line.\\
\\An option value specified in the input file overrides any value for the same option set in the command line.|
|{{-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.|
|{{-S}} _service_|Modifies the value of the specified service status attribute value to ”deleted’.\\
\\The services listed with the {{-S}} option are separated by a comma. The valid _service_ values are {{mail}} and {{cal}}_._ These values are case-insensitive.|
|{{-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.|
h2. {anchor:ACFFL} Examples
The following example marks the group {{testgroup@varrius.com}} as deleted:
{panel}
{{commadmin group delete –D chris –n sesta.com –w bolton –G testgroup \}}
{{–d varrius.com}}
{panel}
The following example marks the mail service for {{testgroup@varrius.com}} as deleted:
{panel}
{{commadmin group delete –D chris –n sesta.com –w bolton –G testgroup \}}
{{–d varrius.com –S mail}}
{panel}
The {{commadmin group delete}} command marks a single group as deleted. To mark multiple groups as deleted, use the {{-i}} option.
To disable a group’s usage of services such as Calendar Server or Messaging Server use the {{-S}} option. Here {{S}} is in uppercase.
{info:title=Note}
In order to permanently remove a group, you must run the following command: {{commadmin domain purge}}. For details, see [commadmin domain purge].
{info}
h2. {anchor:ACFFJ} Syntax
{panel}
{{commadmin group delete –D _login_ –G _groupname_ –n _domain_ –w _password_ [–d _domain_]}}
{{ [–h] [–?] [–i _inputfile_] [–p _AM port_] [–s] [–S _service_] [–v] [–V] [–X _AM host_]}}
{panel}
h2. {anchor:ACFFK} Options
The following are mandatory options:
||Option ||Description ||
|{{-D}} _login_|The user ID of the user who has permission to execute this command.|
|{{-G}} _groupname_|The name of the group to be marked as deleted. 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 ||
|{{-d}} _domain_|The domain of the group. If {{-d}} is not specified, the domain specified by the {{-n}} option is used.|
|{{-h}}, {{–?}}|Prints command usage syntax.|
| {{-i}} _inputfile_ | Reads the command information from a file instead of the command line.\\
\\An option value specified in the input file overrides any value for the same option set in the command line.|
|{{-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.|
|{{-S}} _service_|Modifies the value of the specified service status attribute value to ”deleted’.\\
\\The services listed with the {{-S}} option are separated by a comma. The valid _service_ values are {{mail}} and {{cal}}_._ These values are case-insensitive.|
|{{-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.|
h2. {anchor:ACFFL} Examples
The following example marks the group {{testgroup@varrius.com}} as deleted:
{panel}
{{commadmin group delete –D chris –n sesta.com –w bolton –G testgroup \}}
{{–d varrius.com}}
{panel}
The following example marks the mail service for {{testgroup@varrius.com}} as deleted:
{panel}
{{commadmin group delete –D chris –n sesta.com –w bolton –G testgroup \}}
{{–d varrius.com –S mail}}
{panel}