Man Linux: Main Page and Category List

NAME

       mapiprofile - administer OpenChange MAPI Profiles databases

SYNOPSIS

       mapiprofile [-?GSncrl] [-?|--help] [--usage] [-L|--ldif PATH] [-G|--getdefault] [-S|--default]
            [-n|--newdb] [-f|--database PATH] [-P|--profile PROFILE] [-I|--address xxx.xxx.xxx.xxx]
            [-M|--workstation WORKSTATION_NAME] [-D|--domain DOMAIN] [-R|--realm REALM]
            [-u|--username USERNAME] [-C|--langcode LANGCODE] [-s|--pattern USERNAME]
            [-p|--password PASSWORD] [--nopass] [-c|--create] [-r|--delete] [-R|--rename STRING]
            [-l|--list] [--listlangs] [--dump] [-a|--attr VALUE] [--dump-data] [-d|--debuglevel LEVEL]
            [--getfqdn]

DESCRIPTION

       mapiprofile  is  a command line tool designed to provide administrative
       support for  OpenChange  MAPI  profiles.  A  profile  in  this  context
       represents a single user’s connection to a server. It can be thought of
       as a user’s  account  information  stored  on  the  client  side.  Most
       OpenChange  utilities make use of the profile information stored in the
       local profile database, often by referring to the name of the  profile.
       In  addition,  because  most  users  only  have a single account, it is
       possible to designate one profile as the default profile. If a  profile
       is not specified, other utilities will use the default profile (if any)
       to establish a connection.

       mapiprofile is designed so it also provides sample code for  developers
       interested   in   adding  OpenChange  MAPI  profile  support  to  their
       applications.

COMMANDS

       --newdb

       -n     Create a new database.

       --create

       -c     Create a new profile in the database.

       --delete

       -r     Delete a profile from the database.

       --rename PROFILE

       -R     Rename a profile in the database

       --default

       -S     Set the default profile in the database.

       --getdefault

       -G     Get the default profile name from the database.

       --dump Display information about a specific  profile  from  information
              stored in the database.

       --list

       -l     List existing profiles in the database.

       --listlangs

       -l     List  the  available languages. These can be used to specify the
              language name (--language) when creating a profile.

OPTIONS

       --database DATABASE

       -f     Path to the profile database. If no path database  is  specified
              then the default one will be used $HOME/.openchange/profiles.ldb

       --ldif LDIF

       -L     Path to the ldif files. If no ldif directory is  specified  then
              the  default  one  set  at  compilation  time will be used. This
              option is only used when creating a new profile database.

       --profile PROFILE

       -p     Set the profile name to use  (e.g.  the  profile  to  create  or
              delete, or to dump information about).

       --address IP_ADDR|FQDN

       -I     Set  the  Exchange  server  IP address or fully qualified domain
              name.

       --workstation WORKSTATION

       -M     Sets the local computer name.

       --domain DOMAIN

       -D     Set the Windows domain name.

       --realm REALM

       -R     Set the Windows realm

       --username

       -u     Set the username to use to log on the Exchange server.

       --password

       -p     Set the password corresponding to the username described  above.

       --langcode

       -C     Specify  the  language  to  use  with  the  account. This can be
              specified as  a  code  (in  hexadecimal)  or  as  a  name.  When
              specifying  the  name, you use the name of the language, and the
              location   (if   any),   separated    by    underscores    (e.g.
              English_United_States).  See  the  --listlangs option for how to
              obtain the full list of languages. The default language code  is
              0x0409, for US English.

       --pattern

       -s     Set a username string pattern mapiprofile should use rather than
              the default username. This option is used  during  mapi  profile
              creation.

       --nopass
              Do not save password in the profile.

       --attr VALUE

       -a     Print an attribute value.

       --dump-data
              Dump the hex data.

       --debuglevel LEVEL

       -d     Set the debug level.

       --getfqdn
              Returns  the  DNS fully qualified domain name of the NSPI server
              matching the legacyDN.

EXAMPLES

       Create a blank MAPI profile database:
       mapiprofile --database=/tmp/profiles2.ldb --ldif=/usr/local/samba/share/setup --newdb

       Create a new profile using NTLMSSP authentication:
       mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel
            --username=jkerihuel --password=secret --language=0x040C
            --address=192.168.194.22 --workstation=LOCALHOST --domain=OPENCHANGE
            --create
       Profile jkerihuel completed and added to database /tmp/profiles.ldb. Note
       that this account will use French.

       Create a new profile using Kerberos authentication:
       mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel
            --username=jkerihuel --password=secret --language=0x040C
            --address=exchange.openchange.local --domain=OPENCHANGE
            --realm=OPENCHANGE.LOCAL --create

       Delete a profile:
       mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --delete
       Profile jkerihuel deleted from database /tmp/profiles.ldb

       List profiles:
       mapiprofile --database=/tmp/profiles.ldb --list
       We have 2 profiles in the database:
               Profile = exchange-2000
               Profile = jkerihuel

       Dump a profile:
       mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --dump
       Profile: jkerihuel
            username       == jkerihuel
            password       == secret
            mailbox        == /o=First Organization/ou=First Administrative Group/cn=Recipients/cn=jkerihuel
            workstation    == LOCALHOST
            domain         == OPENCHANGE
            server         == exchange.openchange.local

       Dump profile attribute:
       mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --attr=HomeMDB
       Profile jkerihuel: HomeMDB = /o=First Organization/ou=First Administrative Group/cn=Configuration/cn=Servers/cn=EXCHANGE2000

AUTHOR

       Julien Kerihuel <j.kerihuel at openchange dot org>

       Brad Hards <bradh at openchange dot org>

SEE ALSO

       The codes for various languages can be found in many places,  including
       the Windows Language Code Identifier (LCID) Reference.