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/.openchange/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 calendar
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:
· RightsNone
· RightsReadItems
· RightsCreateItems
· RightsEditOwn
· RightsDeleteOwn
· RightsEditAll
· RightsDeleteAll
· RightsCreateSubfolders
· RightsFolderOwner
· RightsFolderContact
· RoleNone
· RoleReviewer
· RoleContributor
· RoleNoneditingAuthor
· RoleAuthor
· RoleEditor
· RolePublishAuthor
· RolePublishEditor
· RightsAll
· RoleOwner
SEE ALSO
AddUserPermission, ModifyUserPermission, RemoveUserPermission
AUTHOR
Julien Kerihuel <j.kerihuel at openchange dot org>