Administering Users with the manage-user command


The command must typically be run by an administrator, and must specify the logon name
of the user being managed.
Note: It is not possible to manage your own account with this command except when you are changing your own password with -changePassword.

The syntax for this command is:
stcmd{ex} manage-user -s "userName:password@host:port" -logonName
userlogonName [-suspend] [ -activate ] [ -forcePasswordChange ] [ -forceLogoff ] [ -changePassword newPassword ]

-s Identifies the StarTeam Server. The full syntax is:    -s "userName:password@host:portNumber"
For example: -s "JMarsh:password@orion:49201"
If the user name is omitted, the current user name is used. The user name in the example is “JMarsh”.
If the password is omitted, the user is prompted to enter the password. The
password in the example is “password”. If the host name is omitted, the
default is localhost. The host name in the example is “orion”.
The port number is required. The default port number, 49201, is used in the example.
-logonName Designates the user you want to manage. -logonName is required for all uses of this command. Type the users logon name.
-suspend Suspends the designated user account.
-activate Activates the designated user account.
-forcePasswordChange Forces a password change for the designated user account.
-forceLogoff Forces the designated user to logoff.

-changePassword newPassword   Changes the designated users password to the specified new password.
This is the only parameter where any user can change his/her own account.

The following examples can be used by and administrator to manage another user account:
manage-user –s “Administrator:password@host:port” -logonName “joeuser” –suspend
manage-user –s “Administrator:password@host:port” -logonName “joeuser” –activate
manage-user –s “Administrator:password@host:port” -logonName “joeuser” –forceLogoff
manage-user –s “Administrator:password@host:port” -logonName “joeuser” –changePassword “joepassword”

A non-administrative user can also run this command, but only to change his/her own password as follows:
manage-user –s “joeuser:password@host:port” -logonName joeuser – changePassword “mynewpassword”
Note: In this case, -logonName must specify the same name as the login user name.


How To-Best Practice
Comment List