openchangepfadmin

Langue: en

Autres versions - même langue

Version: 2007-11-14 (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

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>