asadmin-update-file-user(1AS)					   User Commands				     asadmin-update-file-user(1AS)

NAME

       asadmin-update-file-user, update-file-user - updates a current file user as specified

SYNOPSIS

       update-file-user  --user  admin_user  [--password  admin_password] [--host localhost] [--port 4848] [--secure|-s] [--passwordfile filename]
       [--terse=false] [--echo=false] [--interactive=true] [--userpassword user_password] [--groups  user_groups:[user_groups]*]  [--authrealmname
       auth_realm_name] user_name

DESCRIPTION

       Updates	an  existing  entry  in keyfile by the specified user_name, user_password and groups. Multiple groups can be entered by separating
       them, with a colon, ":". If the auth_realm_name is not specified, an entry is created in the default keyfile. If auth_realm_name is  speci-
       fied, an entry is created in the keyfile where the auth-realm name in the domain.xml file points to.

       This command is supported in remote mode only.

OPTIONS

       --user		       authorized domain application server administrative username.

       --password	       password to administer the domain application server.

       --host		       machine name where the domain application server is running.

       --port		       port number of the domain application server listening for administration requests.

       --secure 	       if true, uses SSL/TLS to communicate with the domain application server.

       --passwordfile	       file containing the domain application server password.

       --terse		       indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
			       formatted data for consumption by a script. Default is false.

       --echo		       setting to true will echo the command line statement on the standard output. Default is false.

       --interactive	       if set to true (default), only the required password options are prompted.

       --userpassword	       password for the file user.

       --groups 	       group where the file user belongs to.

       --authrealmname	       name, in the domain.xml file, where you have different stores for file auth realm.

OPERANDS

       user_name	       name of file user.

EXAMPLES

       Example 1: Using the update-file-user command

       asadmin> update-file-user --user admin1 --password adminadmin1
       --host pigeon --port 5001 --userpassword sample_password
       --groups staff:manager:engineer --authrealmname auth-realm1 sample_user
       Command update-file-user executed successfully

       Where: the sample_user is the file user updated with the updated user password and groups.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-file-user(1AS), asadmin-list-file-users(1AS), asadmin-create-file-user(1AS), asadmin-list-file-groups(1AS)

J2EE 1.4 SDK							    March 2004					     asadmin-update-file-user(1AS)