Using the PFAdmin Tools

You can use the following command-line syntax format when running PFAdmin:

PFADMIN [Switches] Profile SETACL Folder|ALL User Rights [User Rights]... [YES|NO]
PFADMIN [Switches] Profile REHOME Folder|ALL [Site\]Server [YES|NO]
PFADMIN [Switches] Profile SETREPLICAS Folder Option Server(s)
PFADMIN [Switches] Profile LISTACL Folder|ALL [YES|NO]
PFADMIN [Switches] Profile LISTREPLICAS Folder|ALL [YES|NO]
PFADMIN [Switches] Profile MESSAGETYPES Folder|ALL [FULL|I=IniFile] [O=CsvFile]

Following is a list of the command-line switches available in PFAdmin:

/En = eventlog logging level (default = 3)
/Cn = console logging level (default = 4)
/Dn = debug file logging level (default = 5)
/Ln = logging level (console, debug, and EventLog)
where 0=NONE, 1=STATUS, 2=ERROR, 3=WARNING, 4=INFO, 5=DEBUG

Logging Level Defaults

Logging levels range from 0 to 5, with Level 5 being the highest level.

Level 3 — Output to the EventLog.
Level 4 — Output to stdout.
Level 5 — Output to the log file.

PFAdmin and Message Types

PFAdmin can search a specified folder tree, examine the message type of every message, and then write a .csv file that contains one line for each folder examined.

To search a specified folder tree and write a .csv file

At the command prompt, type:
>pfadmin ? messagetypes):

Sample .csf File Format and Syntax

The PFAdmin tool enables you to configure the IPM types you want to monitor. The message types are provided within the Default.ini file. A single level of subtypes is allowed. Messages that fall within a subtype are counted in both the subtype and its parent type.

Following is a sample .csv file format listing. The numbers in this example were chosen arbitrarily:

FOLDER,ITEMS,IPM_Type1,IPM_Type2, IPM_Type3,…
Folder One,99,16,3,967,...
Folder One\Subfolder A,16,0,2,222,...
TOTALS,9999,111,44,888...

ITEMS represents the total number of messages in the folder (note that only HOMED messages are counted if this option is enabled). The remaining fields represent the number of messages for each message type found in the folder. Note that PFAdmin does not examine attachments and objects within these messages.

For the default and I=IniFile option, a message type is considered to match a default (or .ini-specified) type if the left-most characters match. Any additional characters are ignored. All other message types are combined into the All Other category. For the Full option, all characters are used to match message types and all types found are reported.

Help Syntax

To get Help when using PFAdmin

At the command prompt, type:

pfadmin ?

For additional Help, type any of the following commands:

PFADMIN ? SETACL
PFADMIN ? REHOME
PFADMIN ? SETREPLICAS
PFADMIN ? LISTACL
PFADMIN ? LISTREPLICAS
PFADMIN ? MESSAGETYPES

Notes On Using the PFAdmin Tools

All entries are case-insensitive.
You must use quotation marks when typing names containing blanks and use backslashes when typing subfolder names, starting with the top-level folder under All Public Folders.
You can specify user rights by typing either a full name or character(s). You can combine rights by using the '|' symbol [for example, read | write (blanks optional)] or joining characters into a single word (for example, RW).
You can also use "Default" as the user name to set the default permissions.

Examples of Command-Line Syntax

Following are examples of typical syntax usage for the PFAdmin Tools:

>pfadmin <profile> setacl all "pf global admin" owner "pf lead" o
>pfadmin <profile> setacl "Readme FAQ\Exchange Discussion" UserName r
>pfadmin <profile> setacl all default read