About the Package Definition File Format

A package definition file follows the standard .ini file format. It is an ASCII text file that contains the following sections:

[PDF]

This section identifies the file as a package definition file. It contains a single entry:

Version
The version of the package definition file format used by the file. Package definition files that have 2.0 in this entry were written for SMS 2.0; package definition files that have 1.0 in this entry were written for previous versions of SMS and are converted to 2.0 format as part of the import process.

This entry is optional.

[Package Definition]

This section defines the overall properties of the package.

Name
The name of the product, up to 50 characters. This entry is required.
Version
The version of the product, up to 32 characters. This entry is required.
Icon
The file that contains the icon you want to use for the application. If you use this entry, the icon will replace the default package icon in the SMS Administrator console.
Publisher
The publisher of the product, up to 32 characters. This entry is required.
Language
The language version of the product, up to 32 characters.
Comment
An optional comment about the product, up to 127 characters.
ContainsNoFiles
Whether this package contains files that need to be sent to distribution points. You can specify True or False; the default value is False.
Programs
The programs defined for this package. Each program name corresponds to a [program] section in the package definition file. This entry is required.

For example:

Programs=Typical, Custom, Uninstall

MIFFileName
The name of the MIF file that contains the package status, up to 50 characters.
MIFName
The name of the package, up to 50 characters.
MIFVersion
The version number of the package, up to 32 characters.
MIFPublisher
The software publisher of the package, up to 32 characters.

[program]

For each program specified in the Programs entry in the [Package Definition] section, the package definition file must include a section that defines each program. Typical programs for Microsoft applications include Typical, Complete, Laptop, and Uninstall programs.

Name
The name of the program, up to 50 characters. This entry is required and must be unique within a package. The program name is used when defining advertisements. On client computers, the name of the program is shown in Advertised Programs Monitor in Control Panel.
Icon
The file that contains the icon that you want to use for the program. If you use this entry, the new icon will replace the default program icon in the SMS Administrator console and will be displayed on client computers when the program is advertised.
Comment
Optional text about the program, such as a description, up to 127 characters.
Command Line
The command line for the program, up to 127 characters. The command is relative to the package source directory. This entry is required.
StartIn
The working directory for the program, up to 127 characters. This entry can be an absolute path on the client computer, or a path relative to the package source directory.
Run
The program mode. You can specify Minimized, Maximized, or Hidden.

If this entry is missing or left empty, the program will run in Normal mode.

AfterRunning
A special action that occurs after the program is completed successfully. You can specify SMSRestart, ProgramRestart, or SMSLogoff.

If this entry is missing, the program will not run a special action.

EstimatedDiskSpace
The amount of disk space the software will require when it is installed on the client computer. Specify a number ending in KB, MB, or GB (or you can specify Unknown).

For example:

EstimatedDiskSpace=38MB

EstimatedRunTime
The number of minutes required to run the program on the client computer (or you can specify Unknown).

For example:

EstimatedRunTime=25

EnableRunTimeMonitoring
Whether SMS monitors the run time of the program and warns the user if the program is taking longer to run than the estimated time. You can specify True or False; the default value is False. If you specify True, SMS warns the user if the program is still running 15 minutes after the estimated time.
SupportedClients
The processors and operating systems on which this program will run. Each platform must be separated by a comma. You can specify Win 16, Win 9x, Win NT(i386), Win NT(alpha), or Macintosh (for SMS 1.2 sites in the hierarchy).

If this entry is missing from the package definition file, supported platform checking will be disabled for this program.

SupportedClientMinVersionX, SupportedClientMaxVersionX
The beginning and ending range for version numbers for the operating systems specified in the SupportedClients entry. You can specify numbers between 0.0.0.0 and 9.9.9.9.

For example:

SupportedClients=Win NT(i386)
NT(i386)MinVersion1=3.51.0000.0
NT(i386)MaxVersion1=3.51.1057.1
NT(i386)MinVersion2=3.51.1057.3
NT(i386)MaxVersion2=4.99.9999.99

AdditionalProgramRequirements
Optional text that can include any other information for client computers, up to 127 characters.
CanRunWhen
Whether the program requires that a user be logged on to the client computer. You can specify UserLoggedOn, NoUserLoggedOn, or AnyUserStatus; the default value is UserLoggedOn.
UserInputRequired
Whether the program requires interaction with the user to be completed. You can specify True or False; the default value is True.

Note    This entry is set to False if CanRunWhen is not set to UserLoggedOn.

AdminRightsRequired
Whether the program requires administrative privileges on the computer in order to run. You can specify True or False; the default value is False.

Note    This entry is set to True if CanRunWhen is not set to UserLoggedOn.

UseInstallAccount
Whether the program uses the Windows NT client software installation account when running on Windows NT clients. By default, this value is False.

Note    This entry is set to False if CanRunWhen is set to UserLoggedOn.

DriveLetterConnection
Whether the program requires a drive letter connection to the package files on the distribution point. You can specify True or False. The default value is False, which allows the program to use a universal naming convention (UNC) connection. When this value is set to True, the next available drive letter will be used (starting with Z: and proceeding backward).
SpecifyDrive
The specific drive letter that the program requires to connect to the package files on the distribution point. Using this entry forces the use of the specified drive letter for client connections to distribution points.
ReconnectDriveAtLogon
Whether the computer reconnects to the distribution point when the user logs on. You can specify True or False; the default value is False.
DependentProgram
A program (in this package) that must run before the current program. This entry uses the following format:

DependentProgram=ProgramName

If there is no dependent program, leave this entry empty.

Each of the following is a valid entry:

DependentProgram=Admin
DependentProgram=

Assignment
How the program is assigned to users. This value can be FirstUser (so that only the first user who logs on runs the program) or EveryUser (so that every user who logs on to the client runs the program).

Note    When CanRunWhen is not set to UserLoggedOn, this entry is set to FirstUser.

Disabled
Whether this program can be advertised to clients. You can specify True or False; the default value is False.
RemoveProgram
Indicates that SMS will remove this program from client computers when it is no longer advertised to those clients. This option is mainly useful for shared network applications and is available only to programs that register with Add/Remove Programs in Control Panel, so that you can remove shortcuts from the Start menu on the client and other software-specific files from the client's hard disk.

To use this option, you must specify a value for UninstallKey.

UninstallKey
The name of the uninstall registry key the program creates in the HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\ CurrentVersion\Uninstall registry key. After all advertisements for the program are revoked from the client, SMS looks up the program's uninstall command line in the UninstallString or QuietUninstallString property in this registry key. You can use up to 127 characters.

Related Topics

Topic Link

The Create Package from Definition Wizard

Topic Link

About Version 1.x Package Definition File Conversion

Topic Link

Packages Overview