XCLN: Description of the Profile Descriptor File

This article was previously published under Q148664
This article has been archived. It is offered "as is" and will no longer be updated.
This article describes the format of the Profile Descriptor File (.PRF)that is used with the Automatic Profile Generator (Newprof.exe).

The PRF file contains profile settings that Newprof.exe reads and which arethen added to the newly created profile.

Each of the Microsoft Exchange Clients share point's, contain a templatePRF file, named Template.prf. When the Microsoft Exchange Setup Editor isrun against the client share point, it copies Template.prf to Default.prf.Any user option changes made using the Setup Editor, are then written toDefault.prf. When the client Setup program is run, if the file Default.prfis present in the client installation directory, it is copied to theWindows directory on the client machine and then Newprof.exe is run tocreate a new profile.
More information
The Profile Descriptor File contains information relating to the servicesto be installed in the profile and contains 4 major sections:
  • Section 1: Profile Defaults

  • Section 2: Services in the profile

  • Section 3: Default values for each service

  • Section 4: Mapping for profile properties

Section 1: Profile Defaults

This part of the PRF file contains values that apply to the entire profilespecified below the [General] section

Under the [General] section, the following entries are used.
  • ProfileName=<Name of the Profile>
    This entry specifies the name to be used when creating the profile.

  • DefaultProfile= [Yes/No]
    If the value is set to Yes, then the profile being created will be set as the default profile. By default, this entry is set to Yes.

  • OverwriteProfile= [Yes/No]
    Determines whether the profile being created should overwrite an existing profile with the same name. If the value is set to No, and a profile with the same name, as that specified in the ProfileName entry, does exist, then the profile will not be created. The default value is No.

  • DefaultStore=<Service ID>
    <Service ID> corresponds to a service that is to be used as the default store. The Service ID's are got from the entries listed in the [Service List] section, described below. By default, the value is set to Service2, which corresponds to the Microsoft Exchange Server Service. This is determined by looking at the [Service List] section. In that section look for an entry whose name is Service2. The value of this entry is the actual name of the service.

Section 2: Services in the Profile

This part of the file lists all the services that are to be installed on inthe profile. The names of the Profiles are listed as entries under the[Service List] section. By default the [Service List] section is as below:
  [Service List]  Service1=Microsoft Exchange Client  Service2=Microsoft Exchange Server  Service3=Personal Address Book				

The services listed in this section will be installed only if the settingsassociated with each of these services are valid. If the Automatic ProfileGenerator encounters a problem with one or more of the settings associatedwith a service, it may not install that service in the profile beingcreated.

Section 3: Default Values for each service

This section of the file contains service specific information for theservices listed under the [Service List] section. For each of the serviceslisted under the [Service List] section, there should be a section withthat service name. This section should contain entries for eachconfigurable option for the service.

By default, there are the following sections:
This section contains configurable options for the Microsoft Exchange Client. The different settings available in the Microsoft Exchange Client, are enumerated in Section 4 of the PRF file, which is described below.

This section contains settings for the Microsoft Exchange Server service. The different configurable settings available in the Microsoft Exchange Server service, are enumerated in Section 4 of the PRF file.

This section contains settings for the Microsoft Exchange Personal Address Book service. The different configurable settings available in the Microsoft Exchange Personal Address Book service, are enumerated in Section 4 of the PRF file.

Section 4: Mapping for profile properties

This section of the file contains a listing of all the supported propertiesfor each of the services that Automatic Profile Generator supports.

For each service, there is a section, under Section 4, with the name ofthat service. This section contains all the settings for that service thatthe Profile Generator supports. By default, there are sections for[Microsoft Exchange Client], [Microsoft Exchange Server], [PersonalFolders], [Personal Address Book] and [Microsoft Mail].

For each entry in the [Service List] section, there must be a correspondingsection in Section 4 of the file. So, for example, if under the [ServiceList] section, there is an entry:
   Service1=Microsoft Exchange Client				

There must be a section called [Microsoft Exchange Client] in Section 4 ofthis file. The [Microsoft Exchange Client] section contains descriptions ofall the options that can be set for the Exchange Client. Each descriptioncontains the type of that entry and an internal id number. There is also atext description of the entry which explains the use of that option and thevalues that can be assigned to the option.

NEWPROF.EXE reads Section 4, to determine how to interpret each of theoptions. The textual description of each option is commented out and henceNEWPROF.EXE ignores these lines.

Using the above example, if in the [Service List] section, we have theentry:
   Service1=Microsoft Exchange Client				

There should a section called [Service1] in Section 3 of the file as wellas a section [Microsoft Exchange Client] in Section 4.

For each entry specified in the [Service1] section, there must be acorresponding entry in the [Microsoft Exchange Client] section whichdescribes the type (whether the option is a Boolean variable, integer,...)and an internal id number. If the corresponding entry is not present in the[Microsoft Exchange Client] section, the Automatic Profile Generator(Newprof.exe) will not be able to interpret that option and will display anerror message.

Hence, in order to have Newprof.exe set a particular option for a service,that service id might be listed in the [Service List] section. The optionmust be listed with a valid value in the [Service id] section, whereService id is the entry name corresponding to that service in the [ServiceList] section. There must also be a section corresponding to the ServiceName in Section 4 of the file, and this section should have the descriptioninformation for the option that we need to set.

Article ID: 148664 - Last Review: 10/26/2013 04:02:00 - Revision: 4.0

  • Microsoft Exchange Server 4.0 Standard Edition
  • kbnosurvey kbarchive kbusage KB148664