You can create or import a Microsoft System Center 2012 Configuration Manager package and program by using one of the following procedures in this topic:
- How to Create
a Package and Program by using the Create Package and Program
Wizard
- How to Create a
Package and Program from a Package Definition File
- How to Import a
Package and Program
How to Create a Package and Program by using the Create Package and Program Wizard
You can create a new package and program by using the Create Package and Program Wizard. To do so, use the following procedure.
To create a package and program
-
In the Configuration Manager console, click Software Library.
-
In the Software Library workspace, expand Application Management, and then click Packages.
-
In the Home tab, in the Create group, click Create Package.
-
On the Package page of the Create Package and Program Wizard, specify the following information:
- Name: Specify a name for the package
with a maximum of 50 characters.
- Description: Optionally specify a
description for this package with a maximum of 128 characters.
- Manufacturer: Optionally specify a
manufacturer name to help you identify the package in the
Configuration Manager console. This name can be a maximum of 32
characters.
- Language: Optionally specify the
language version of the package with a maximum of 32
characters.
- Version: Optionally specify a version
number for the package with a maximum of 32 characters.
- This package contains source files -
This setting indicates whether the package requires source files to
be present on client devices. By default, this check box is cleared
and Configuration Manager does not use distribution points for the
package. When this check box is selected, distribution points are
used.
- Source folder: If the package contains
source files, click Browse to open the Set Source
Folder dialog box and specify the location of the source files
for the package.
Note The computer account of the site server must have read access permissions to the source folder that you specify.
- Name: Specify a name for the package
with a maximum of 50 characters.
-
On the Program Type page of the Create Package and Program Wizard, select the type of program to create, and then click Next. You can create a program for a computer or device, or you can skip this step and create a program later.
Important You can only create packages and programs for devices running Windows CE. Note To create a new program for an existing package, select the package, and then, in the Home tab, in the Package group, click Create Program to open the Create Program Wizard. -
Use one of the following procedures to create a standard program or a device program.
To create a standard program
-
On the Program Type page of the Create Package and Program Wizard, select Standard Program, and then click Next.
-
On the Standard Program page of the Wizard, specify the following information:
- Name: Specify a name for the program
with a maximum of 50 characters.
Note The program name must be unique within a package. After you create a program, you cannot modify its name. - Command Line: Enter the command line
to be used to start this program, or click Browse to browse
to the file location.
If a specified file name does not have an extension specified, Configuration Manager attempts to use .com, .exe, and .bat as possible extensions.
When the program is run on a client, Configuration Manager first searches for the command-line file name within the package, searches next in the local Windows folder, and then searches in local %path%. If the file cannot be found, the program fails.
- Startup folder: Optionally use this
field to specify the folder from which the program runs, up to 127
characters. This folder can be an absolute path on the client or a
path relative to the distribution point folder that contains the
package.
- Run: Specifies the mode in which the
program will run on client computers. Select one of the
following:
- Normal - The program runs in the
normal mode based on system and program defaults. This is the
default mode.
- Minimized – The program runs minimized
on client devices. Users might see installation activity in the
notification area or taskbar.
- Maximized – The program runs maximized
on client devices. Users will see all installation activity.
- Hidden – The program runs hidden on
client devices. Users will not see any installation activity.
- Normal - The program runs in the
normal mode based on system and program defaults. This is the
default mode.
- Program can run: Specify whether the
program can run only when a user is logged on, run only when no
user is logged on, or run regardless of whether a user is logged on
to the client computer.
- Run mode: Specify whether the program
will run with administrative permissions or with the permissions of
the currently logged on user.
- Allow users to view and interact with the
program installation - Use this setting, if available, to
specify whether to allow users to interact with the program
installation. This check box is available only when Only when no
user is logged on or Whether or not a user is logged on
is selected for Program can run and Run with
administrative rights is selected for Run mode.
- Drive mode: Specify information about
how this program will runs on the network. Choose one of the
following:
- Runs with UNC name - Indicates that
the program runs with a Universal Naming Convention (UNC) name.
This is the default setting.
- Requires drive letter - Indicates that
the program requires a drive letter to fully qualify its location.
For this setting, Configuration Manager can use any available drive
letter on the client.
- Requires specific drive letter (example:
Z:) - Indicates that the program requires a specific drive
letter that you specify to fully qualify its location. If the
specified drive letter is already used on a client, the program
does not run.
- Runs with UNC name - Indicates that
the program runs with a Universal Naming Convention (UNC) name.
This is the default setting.
- Reconnect to distribution point at log
on - Use this check box to indicate whether the client computer
reconnects to the distribution point when the user logs on. By
default, this check box is cleared.
- Name: Specify a name for the program
with a maximum of 50 characters.
-
On the Requirements page of the Create Package and Program Wizard, specify the following information:
- Run another program first – You can
use this setting to identify a package and program that will be run
before this package and program will be run.
- Platform requirements – Select This
program can run on any platform or select This program can
run only on specified platforms and then choose the operating
systems that clients must be running to be able to install the
package and program.
- Estimated disk space: Specify the
amount of disk space that the software program requires to be able
to run on the computer. This can be specified as Unknown
(the default setting) or as a whole number greater than or equal to
zero. If a value is specified, units for the value must also be
specified.
- Maximum allowed run time (minutes):
Specify the maximum time that the program is expected to run on the
client computer. This can be specified as Unknown (the
default setting) or as a whole number greater than zero.
By default, this value is set to 120 minutes.
Important If you are using maintenance windows for the collection on which this program is run, a conflict may occur if the Maximum allowed run time is longer than the scheduled maintenance window. However, if the maximum run time is set to Unknown, the program will start to run during the maintenance window and will continue to run as needed after the maintenance window is closed. If the user sets the maximum run time to a specific period that exceeds the length of any available maintenance window, then the program will not be run.
Note If the maximum run time (whether set by the user or as the default value) is exceeded, Configuration Manager will stop the program if run with administrative rights is selected and Allow users to view and interact with the program installation is not selected.
- Run another program first – You can
use this setting to identify a package and program that will be run
before this package and program will be run.
-
Click Next and continue to To complete the Create Package and Program Wizard.
To create a device program
-
On the Program Type page of the Create Package and Program Wizard, select Program for device, and then click Next.
-
On the Program for Device page of the Wizard, specify the following information:
- Name: Specify a name for the program
with a maximum of 50 characters.
Note The program name must be unique within a package. After you create a program, you cannot modify its name. - Comment: Optionally, specify a comment
for this device program with a maximum of 127 characters.
- Download folder: Specify the name of
the folder on the Windows CE device in which the package source
files will be stored. The default value is \Temp\.
- Command Line: Enter the command line
to use to start this program, or click Browse to browse to
the file location.
- Run command line in download folder –
Select this option to run the program from the previously specified
download folder.
- Run command line from this folder –
Select this option to specify a different folder from which to run
the program.
- Name: Specify a name for the program
with a maximum of 50 characters.
-
On the Requirements page of the Wizard, specify the following information:
- Estimated disk space: Specify the
amount of disk space required for the software. This will be
displayed to users of mobile devices before they install the
program.
- Download program: Specify information
regarding when this program can be downloaded to mobile devices.
You can specify As soon as possible, Only over a fast
network, or Only when the device is docked.
- Additional requirements: Specify any
additional requirements for this program. These will be displayed
to users before they install the software. For example, you could
notify users that they need to close all other applications before
running the program.
- Estimated disk space: Specify the
amount of disk space required for the software. This will be
displayed to users of mobile devices before they install the
program.
-
Click Next.
To complete the Create Package and Program Wizard
-
On the Summary page of the Wizard, review the actions that will be taken, then complete the Wizard.
-
Optionally, verify that the new package and program is displayed in the Packages node of the Software Library workspace.
How to Create a Package and Program from a Package Definition File
Use the following procedure to create a package and program from a package definition file. For more information about package definition files, see About the Package Definition File Format in this topic.
To import a package and program from a definition file
-
In the Configuration Manager console, click Software Library.
-
In the Software Library workspace, expand Application Management, and then click Packages.
-
In the Home tab, in the Create group, click Create Package from Definition.
-
On the Package Definition page of the Create Package from Definition Wizard, choose an existing package definition file, or click Browse to open a new package definition file. After you have specified a new package definition file, select it from the Package definition list, and then click Next.
-
On the Source Files page of the Wizard, specify information about any required source files for the package and program, and then click Next.
-
If the package requires source files, on the Source Folder page of the Wizard, specify the location from which the source files are to be obtained, and then click Next.
-
On the Summary page of the Wizard, review the actions that will be taken and then complete the Wizard. The new package and program is displayed in the Packages node of the Software Library workspace.
About the Package Definition File Format
Package definition files are scripts that you can use to help automate package and program creation with Configuration Manager. They provide all of the information that Configuration Manager needs in order to create a package and program, except for the location of package source files. Each package definition file is an ASCII or UTF-8 text file following the .ini file format and containing the following described sections:
[PDF]
This section identifies the file as a package definition file. It contains the following information:
- Version: This specifies the version of
the package definition file format that is used by the file. This
corresponds to the version of System Management Server (SMS) or
Configuration Manager for which it was written. This entry is
required.
[Package Definition]
This section of the package definition file specifies the properties of the package and program. It provides the following information:
- Name: The name of the package, up
to 50 characters. This entry is required.
- Version: The version of the package,
up to 32 characters. This entry is optional.
- Icon: Optionally, the file containing
the icon to use for this package. If specified, this icon will
replace the default package icon in the Configuration Manager
console.
- Publisher: The publisher of the
package, up to 32 characters. This entry is required.
- Language: The language version of the
package, up to 32 characters. This entry is required.
- Comment: An optional comment about the
package, up to 127 characters.
- ContainsNoFiles: This entry indicates
whether or not a source is associated with the package.
- Programs: The programs defined for
this package. Each program name corresponds to a [Program]
section in this package definition file. This entry is
required.
Example:
Programs=Typical, Custom, Uninstall
- MIFFileName: The name of the
Management Information Format (MIF) file that contains the package
status, up to 50 characters.
- MIFName: The name of the package (for
MIF matching), up to 50 characters.
- MIFVersion: The version number of the
package (for MIF matching), up to 32 characters.
- MIFPublisher: The software publisher
of the package (for MIF matching), 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 [Program] section that defines that program. Each Program section provides the following information:
- Name: The name of the program, up
to 50 characters. This entry must be unique within a package.
This name is used when defining advertisements. On client
computers, the name of the program is shown in Run Advertised
Programs in Control Panel. This entry is required.
- Icon: Optionally specifies the file
containing the icon to use for this program. If specified, this
icon will replace the default program icon in the Configuration
Manager console and will be displayed on client computers when the
program is advertised.
- Comment: An optional comment about the
program, up to 127 characters.
- CommandLine: Specifies the command
line for the program, up to 127 characters. The command is
relative to the package source folder. This entry is required.
- StartIn: Specifies the working folder
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 folder. This entry is required.
- Run: Specifies the program mode in
which the program will run. You can specify Minimized,
Maximized, or Hidden. If this entry is not included,
the program will run in normal mode.
- AfterRunning: Specifies any special
action that occurs after the program is successfully completed.
Options available are SMSRestart, ProgramRestart, or
SMSLogoff. If this entry is not included, the program will
not run a special action.
- EstimatedDiskSpace: Specifies the
amount of disk space that the software program requires to be able
run on the computer. This can be specified as Unknown (the
default setting) or as a whole number greater than or equal to
zero. If a value is specified, the units for the value must also be
specified.
Example:
EstimatedDiskSpace=38MB
- EstimatedRunTime: Specifies the
estimated duration (in minutes) that the program is expected to run
on the client computer. This can be specified as Unknown
(the default setting) or as a whole number greater than zero.
Example:
EstimatedRunTime=25
- SupportedClients: Specifies the
processors and operating systems on which this program will run.
The specified platforms must be separated by commas. If this entry
is not included, supported platform checking will be disabled for
this program.
- SupportedClientMinVersionX,
SupportedClientMaxVersionX: Specifies the
beginning-to-ending range for version numbers for the operating
systems specified in the SupportedClients entry.
Example:
Copy Code SupportedClients=Win NT (I386),Win NT (IA64),Win NT (x64) Win NT (I386) MinVersion1=5.00.2195.4 Win NT (I386) MaxVersion1=5.00.2195.4 Win NT (I386) MinVersion2=5.10.2600.2 Win NT (I386) MaxVersion2=5.10.2600.2 Win NT (I386) MinVersion3=5.20.0000.0 Win NT (I386) MaxVersion3=5.20.9999.9999 Win NT (I386) MinVersion4=5.20.3790.0 Win NT (I386) MaxVersion4=5.20.3790.2 Win NT (I386) MinVersion5=6.00.0000.0 Win NT (I386) MaxVersion5=6.00.9999.9999 Win NT (IA64) MinVersion1=5.20.0000.0 Win NT (IA64) MaxVersion1=5.20.9999.9999 Win NT (x64) MinVersion1=5.20.0000.0 Win NT (x64) MaxVersion1=5.20.9999.9999 Win NT (x64) MinVersion2=5.20.3790.0 Win NT (x64) MaxVersion2=5.20.9999.9999 Win NT (x64) MinVersion3=5.20.3790.0 Win NT (x64) MaxVersion3=5.20.3790.2 Win NT (x64) MinVersion4=6.00.0000.0 Win NT (x64) MaxVersion4=6.00.9999.9999
- AdditionalProgramRequirements:
Optionally provide any other information or requirements for client
computers, up to 127 characters.
- CanRunWhen: Specifies the user status
that the program requires to be able run on the client computer.
Available values are UserLoggedOn, NoUserLoggedOn, or
AnyUserStatus. The default value is UserLoggedOn.
- UserInputRequired: Specifies whether
the program requires interaction with the user. Available values
are True or False. The default value is True.
This entry is set to False if CanRunWhen is not set
to UserLoggedOn.
- AdminRightsRequired: Specifies whether
the program requires administrative credentials on the computer to
be able to run. Available values are True or False.
The default value is False. This entry is set to True
if CanRunWhen is not set to UserLoggedOn.
- UseInstallAccount: Specifies whether
the program uses the Client Software Installation Account when it
runs on client computers. By default, this value is False.
This value is also False if CanRunWhen is set to
UserLoggedOn.
- DriveLetterConnection: Specifies
whether the program requires a drive letter connection to the
package files that are located 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: Optionally, specifies a
drive letter that the program requires to connect to the package
files on the distribution point. This specification forces the use
of the specified drive letter for client connections to
distribution points.
- ReconnectDriveAtLogon: Specifies
whether the computer reconnects to the distribution point when the
user logs on. Available values are True or False. The
default value is False.
- DependentProgram: Specifies a program
in this package that must run before the current program. This
entry uses the format
DependentProgram=<ProgramName>, where
<ProgramName> is the Name entry for that
program in the package definition file. If there are no dependent
programs, leave this entry empty.
Example:
DependentProgram=Admin
DependentProgram=
- Assignment: Specifies how the program
is assigned to users. This value can be: FirstUser, only the
first user who logs on runs the program; or EveryUser, every
user who logs on to the client runs the program. When
CanRunWhen is not set to UserLoggedOn, this entry is
set to FirstUser.
- Disabled: Specifies whether this
program can be advertised to clients. Available values are
True or False. The default value is False.
How to Import a Package and Program
To import a package and program
-
In the Configuration Manager console, click Software Library.
-
In the Software Library workspace, expand Application Management, and then click Packages.
-
In the Home tab, in the Create group, Click Import.
-
On the General page of the Import Package Wizard, specify or browse to the compressed (.zip) file that contains the package and program to import, and then click Next.
-
On the File Content page of the Wizard, review the items that will be imported, and then click Next. You can click View Failure to examine the details of items that cannot be imported. If the package you are trying to import already exists, you can choose to either ignore the duplicate package or overwrite the original package.
-
On the Summary page of the Wizard, review the actions that will be taken and then complete the Wizard. The new package and program is displayed in the Packages node of the Software Library workspace.
See Also
For additional information, see Information and Support for Configuration Manager.
To contact the documentation team, email SMSdocs@microsoft.com.