commadmin user delete

{anchor:acfgp}
h1. commadmin user delete

{anchor:gadst}

h2. To remove a user

The following steps summarize how to remove a user from the directory. For more information, see [Removing Users, Groups, and Services from a Domain].

*1. Mark the user as deleted by running the {{commadmin user delete}} command.*

*2. Remove resources from the user.*

A resource can be a mailbox or a calendar.

For mail services, the program is called {{msuserpurge}}. Refer to the _Sun Java System Messaging Server Administration Reference_ for information about the {{msuserpurge}} utility.

{anchor:acfgq}

h2. Syntax

{noformat}
commadmin user delete -D <login> -n <domain> -l <login name> -w <password> [-d <domain>]
[-h] [-?] [-i <inputfile>] [-p <AM port>] [-s] [-S <service>] [-v] [-V] [-X <AM host>]
{noformat}

{anchor:acfgr}

h2. Options

The following options are mandatory:

||Option ||Description ||
|{{-D}} _login_ |The user ID of the user with the permission to execute this command. |
|{{-n}} _domain_ |The domain of the user specified with the {{-D}} option. |
|{{-w}} _password_ |The password of the user specified with the {{-D}} option. |
|{{-l}} _userid_ |The user ID of the user to be deleted. |


The following options are non-mandatory:

||Option ||Description ||
|{{-d}} _domain_ |Domain of the user. If {{-d}} is not specified, the domain specified by {{-n}} is used. |
|{{-h}}, {{&ndash;?}} |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 directory. |
|{{-S}} _service_ |Specifies the services to be removed from the user. The user remains active, but only the specified services are deactivated. If {{-S}} is not specified, then the user is deleted.\\
_service_ can have the value of a single service or multiple services. The valid _service_ values are {{mail}}, {{cal}}, and {{im}}. These values are case-insensitive.\\
The list of services is separated by the comma (,) delimiter.\\
For example:\\
{{-S mail,cal,im}} |
|{{-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. |

{anchor:acfgs}

h2. Example

To mark an existing user as deleted:

{code}
commadmin user delete -D chris -n sesta.com -w bolton -l smith
{code}

To delete the mail services only from user {{smith}}:

{code}
commadmin user delete -D chris -n sesta.com -w bolton -l smith -S mail
{code}