OPENCHANGEPFADMIN(1)					     OpenChange Users' Manual					      OPENCHANGEPFADMIN(1)

NAME

       openchangepfadmin - Exchange users and Public Folder administration tool

SYNOPSIS

       openchangepfadmin [-?] [-?|--help] [--usage] [-f|--database PATH] [-p|--profile PROFILE]
	   [-P|--password PASSWORD] [--apassword=PASSWORD] [--adesc=DESCRIPTION] [--acomment=COMMENT]
	   [--afullname=NAME] [--list] [--mkdir] [--rmdir] [--comment=COMMENT] [--dirclass=CLASS]
	   [--adduser=USERNAME] [--rmuser=USERNAME] [--addright=RIGHT] [--rmright] [--modright=RIGHT]
	   [--debuglevel=LEVEL] [--dump-data] [--folder=FOLDER] [--username=USERNAME]

DESCRIPTION

       openchangepfadmin  is a administrative command line tool designed to facilitate user management related operations (create, delete, modify)
       on a remote Exchange server and manage public folder store and permissions.

COMMANDS

       --adduser=USERNAME
	      Create a Exchange user with the username specified by USERNAME

       --rmuser=USERNAME
	      Delete the Exchange user account specified by USERNAME

       --list List Public Folder hierarchy (IPM_SUBTREE)

       --mkdir
	      Create a folder in the Public Folder store

       --rmdir
	      Delete a folder in the Public Folder store

       --addright=RIGHT
	      Add permission and roles for a user on a Public Folder directory.

       --modright=RIGHT
	      Modify permissions and roles for a user on a Public Folder directory

       --rmright
	      Delete permissions and roles for a specific user

OPTIONS

       --database=DATABASE

       -f     Set the MAPI profile database. If no database is specified, then openchangeclient  tries	to  load  the  default	one:  $HOME/.open-
	      change/profiles.ldb

       --profile=PROFILE

       -p     Set  the	profile to use. If a profile is not specified, and one of the profiles has been set as the default in the profile database
	      (for example, using mapiprofile -S), then that default profile will be used.

       --password

       -P     Set the password for the profile to use. This can be omitted if the password is stored in the profile.

       --apassword=PASSWORD
	      Define the password to set for the user specified with --adduser. If no password is  explicitely	supplied,  openchangepfadmin  will
	      arbitrary set a random one.

       --adesc=DESCRIPTION
	      This command can only be used with --adduser and specifies a description for this account

       --acomment=COMMENT
	      This command can only be used with --adduser and specifies a comment for this account.

       --afullname=NAME
	      This command can only be used with --adduser and specifies the user full name for this account.

       --comment=COMMENT
	      This command can only be used with --mkdir and specifies a comment for the folder.

       --dirclass=CLASS
	      This  command  can  only	be used with --mkdir and specifies the container class of the directory we want to create. Possible values
	      are: IPF.Appointment, IPF.Contact, IPF.Journal, IPF.Note, IPF.StickyNote, IPF.Task, IPF.Post

       --folder=FOLDER
	      This command can only be used with --addright, --modright and --rmright. Specify the folder where permissions and roles have  to	be
	      changed.

       --username=USERNAME
	      This  command  can  only	be  used with --addright, --modright and --rmright. Specify the username we want to change permissions and
	      roles for.

       --dump-data
	      Dump the hex data. This is only required for debugging or educational purposes.

       --debuglevel LEVEL

       -d     Set the debug level.

EXAMPLES

       Creating user
       openchangepfadmin --adduser=linuxowner --apassword=linuxowner   
			   --adesc="Linux Owner Test account"	       
		     --afullname="Linux Owner"
	   mapiadmin_user_add	    : MAPI_E_SUCCESS (0x0)
       username: linuxowner
       password: linuxowner

       Creates a user account with username and password set to linuxowner.

       Deleting user:
       openchangepfadmin --rmuser=linuxowner
	   mapiadmin_user_del	    : MAPI_E_SUCCESS (0x0)

       Create Public Folder:
       openchangepfadmin --mkdir --folder=public_events --dirclass=IPF.Appointment

       Creates a folder in the Public Folder store named public_events with a container class set to Appointment. This folder will display  calen-
       dar items.

       Delete Public Folder:
       openchangepfadmin --rmdir --folder=public_events

       List Public Folder hierarchy:
       openchangepfadmin --list

       Add Permission:
       openchangepfadmin --username=linuxowner --folder=public_events 
			   --addright=RoleOwner
       Permission RoleOwner added for linuxowner on folder public_events

       Modify Permission
       openchangepfadmin --username=Anonymous --folder=public_events 
		     --modright=RoleNone
       Permission changed to RoleNone for Anonymous on folder appointment

       Note that you can only change permissions for a user already listed in the ACL table.

NOTE

       Permissions and Roles possible values are:

       o RightsNone

       o RightsReadItems

       o RightsCreateItems

       o RightsEditOwn

       o RightsDeleteOwn

       o RightsEditAll

       o RightsDeleteAll

       o RightsCreateSubfolders

       o RightsFolderOwner

       o RightsFolderContact

       o RoleNone

       o RoleReviewer

       o RoleContributor

       o RoleNoneditingAuthor

       o RoleAuthor

       o RoleEditor

       o RolePublishAuthor

       o RolePublishEditor

       o RightsAll

       o RoleOwner

SEE ALSO

       AddUserPermission, ModifyUserPermission, RemoveUserPermission

AUTHOR

       Julien Kerihuel <j.kerihuel at openchange dot org>

OpenChange libmapi 0.8						    2007-11-14						      OPENCHANGEPFADMIN(1)