Manage User: manage-user

To manage another user, the command must 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 unless you are changing a password with -changePassword.

Syntax

The syntax for this command is:

stcmd{ex} manage-user -s "userName:password@host:port" -logonName userlogonName [-suspend] [ -activate ] [ -forcePasswordChange ] [ -forceLogoff ] [ -changePassword newPassword ]
Parameter
Description
-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 a user can change their own account.

Example

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 specifies the same name as the login user name.