ExchMbx Usage

exchmbx /?

ExchMbx V01.04.00cpp Joe Richards (joe@joeware.net) April 2006

Usage:
 ExchMbx [switches]

  Switches: (designated by - or /)
   -h host    Host to use, use default LDAP server
   -b basedn  DN to do the work on. If basedn is not specified
              the program will read from stdin anything piped to it
              or if you want you can type the DNs there followed by
              a ctrl-z to terminate the pipe.
   -elapsed   Display elapsed time in seconds
   -cr MDB    Create Mailbox in MDB  - See Format Below for that value
   -move MDB  Move Mailbox to MDB  - See Format Below for that value
   -xag       Use this with move for Cross-AG moves, requires E2K3 SP2
   -me x      MailEnable object. If necessary x is targetaddress.
   -clear     Clear all email attribs.
   -upd       Update, use on existing objects for quota and AL mods
   -safety x  How many objects before safety kicks in. Default 10
   -delim x   X specifies delimiter for MDB format. Default :
   -fdelim x  X specified delimiter for file format. Default [TAB]
   -unsafe    Don't have a safety, modify objects no matter how many.
   -upto x    Process DNs until x successes have occurred.
   -cont      Continue with objects even if errors.
   -hfal      Hide from address lists.
   -uhfal     Unhide from address lists.
   -keepmail  When used with -me uses existing mail attribute for targetAddress.
   -quota x:y:z Set Quota, x=Warn MB, y=Stop Send MB, z=Stop Receive MB.
                   Use :: to set quota to system default.
   -internetencoding   This is the encoding type for mailenabled objects.


  MDB format
       Format:  (HomeMDBURL|Server:Storage Group:DataBase)

    This value can be specified either as a complete HomeMDB URL value
    or if you don't know it or don't want to look it up you can specify
    the server, storage group, and data base and the tool will look up
    the proper HomeMDB URL for you.


  Internet Encoding Format
    Mail enabled objects can either follow the Internet Mail Service
    settings for how mail is encoded for transfer out of the Exchange
    system or you can specify specific values. This switch lets you
    change that setting. The default value written to the mail enabled
    objects is 1310720 which is 'Use Internet Mail Service' settings.
    See KB281740 for more info on the settings, here are some alternate
    values at the time of this writing:
          393216 MIME with Plain Text
          917504 MIME with HTML
         1441792 MIME with Plain Text & HTML
         2228224 Plain Text / uuencode
          131072 Plain Text / uuencode with Binhex


  Notes:
    This tool could be considered dangerous, it can quickly make some
    serious changes to your directory and really mess up email.
    I take no responsibility for you dorking up your email system.
    The safety option will bail the whole operation if there
    are more objects to work on than specified with the -safety option.

    This tool is exceptionally powerful when used in conjunction with
    a command line LDAP query tool such as my own adfind with the -dsq
    switch or dsquery from Microsoft.

    If you get an error updating an object, no modification is made
    to the specific object.

    When doing multi-DN modifications, the errorlevel will be set to the
    last error encountered. So if you go through 8 DNs and hit 3 errors,
    only the last will be passed back to you via %errorlevel%.

    Be very very careful of clear option. You can literally clear all mail
    objects in your forest with that command in a relatively simple way.


    This program has the ability to read the DN to modify from STDIN for
    instance you could take the output from program 1 and send it into this
    program like:
       someprogram | exchmbx -move server1:sg1:db1 -upto 100
    which would take the output from someprogram and then use that for the
    the DN list for exchmbx. So for instance say I wanted to move all
    mailboxes of users in a specific OU to another Exchange Server or another
    database I could do so by combining an LDAP search from ADFIND or
    dsquery with exchmbx...

    You can also have a list of DNs in a text file and pipe in from there
    like this:
       exchmbx -move srv1:sg1:db3 < file.txt
    In addition you can add override info to the piped in information
    as well... Say you want to move all users except a couple of them
    to one place you have the command above but then on the lines holding
    DNs you wanted moved to another location you add that information.

    Basically it is all in the format of the input. If you are just sending
    in DNs the format should be:
       "cn=something,ou=something,dc=domain,dc=com"
    and should have the quotes around the DN. If you want to add override
    information simply follow the DN with TAB character and a quoted string
    with the override info like so:
       "cn=something,ou=something,dc=domain,dc=com"
       "cn=something2,ou=something,dc=domain,dc=com"
       "cn=something3,ou=something,dc=domain,dc=com"    "srv2:sg1:db3"
    which when combined with the command:
       exchmbx -move srv1:sg1:db1 < file.txt
    would result in something3 going to srv2:sg1:db3 and the other objects
    going to srv1:sg1:db1

    This override functionality works for -cr, -move, -me options.


  Ex1:
    ExchMbx -b cn=joe,dc=joe,dc=net -cr srv1:sg1:db2
      Create mailbox for joe in Server srv1, storage group sg1, database db2.

  Ex2:
    ExchMbx -b cn=joe,dc=joe,dc=net -move srv1:sg1:db2
      Ditto ex1 but move.

  Ex3:
    ExchMbx -b cn=joe,dc=joe,dc=net -move CN=DB1,CN=SG1,CN=InformationStore,CN=2K3EXC01...
      Ditto ex1 but move to specified URL (URL chopped short).

  Ex4:
    ExchMbx -b cn=joe,cn=users,dc=joe,dc=net -clear
      Clear Exchange attrs for joe, will delete mailbox or
      clean email addresses of mailenabled objects.

  Ex5:
    ExchMbx -b cn=gr1,cn=users,dc=joe,dc=net -me
      Mail Enable group gr1

  Ex6:
    ExchMbx -b cn=con1,cn=users,dc=joe,dc=net -me joe@joeware.net
      Mail Enable contact con1 with email address joe@joeware.net

  Ex8:
    adfind -b ou=new,dc=joe,dc=net -f "&(objectcategory=person)(objectclass=user)" -dsq |exchmbx -upto 100 -cre s1:sg1:db1
      Mailbox enable the first 100 users of the OU called new.




 This software is Freeware. Use it as you wish at your own risk.
 If you have improvement ideas, bugs, or just wish to say Hi, I
 receive email 24x7 and read it in a semi-regular timeframe.
 You can usually find me at joe@joeware.net