Update User: update-user

Use the update-user command to update a user properties on the StarTeam Server.

Either -logonname or -userid are required to identify the user. All other parameters are optional.

If specified, the new property will be applied to the user.

Only users with administrative privileges can run this command on behalf of any user.

Syntax

The syntax for this command is:

stcmd{Ex} update-user –s “username:password@host:port” –logonname “logon name” | -userid “userid”
[–password “password”] [-name “user full name” ] 
[-phone “phone number”] [-email “email address”] [-address “postal address”]
[-voicemail “voice mail number”] [-pager “pager number”] [-fax “fax number”][-distinguishedname “distinguished name”] 
[-directoryservicevalidation] [-fixedlicense] [-territory “territory name or territory enum code”]

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.

-logon name
Name used for logging in to the Server.
-userid
Unique integer user ID of the user on the StarTeam Server.
-password
User's new password.
-name
User's full name.
-phone
User's phone number.
-email
User's email address.
-address
User's postal address.
-voicemail
User's voicemail number.
-pager
User's pager number.
-fax
User's fax number.
-distinguishedname
User's directory service distinguished name
-directoryservicevalidation
If specified, turns on directory service validation.
-fixedlicense
If specified, sets the user to inherit a fixed license.
-territory
If specified, then a case insensitive territory name or enum code must be specified as the value. Enums may be added to or removed from the User Geographic Territory Enumerated Property type using the add-enum command.