包定义文件

项目
04/04/2023

适用于: Configuration Manager(current branch)

包定义文件是一些脚本，可帮助你自动创建Configuration Manager中的包和程序。它们提供Configuration Manager创建包和程序所需的所有信息，包源文件的位置除外。

关于包定义文件格式

每个包定义文件都是使用.ini文件格式的 ASCII 或 UTF-8 文本文件。它包含以下部分：

[PDF]

本部分将文件标识为包定义文件。它包含以下信息：

版本：指定文件使用的包定义文件格式的版本。此版本对应于为其编写它的Configuration Manager的版本。此项是必需的。

[包定义]

指定包和程序的属性。它提供以下信息：

名称：包的名称，最多 50 个字符。
版本 (可选) ：包的版本，最多 32 个字符。
图标 (可选) ：包含要用于此包的图标的文件。如果指定，此图标将替换Configuration Manager控制台中的默认包图标。
发布者：包的发布者，最多 32 个字符。
语言：包的语言版本，最多 32 个字符。
注释 (可选) ：有关包的注释，最多 127 个字符。
ContainsNoFiles：此项指示包是否包含任何源文件。
程序：为此包定义的程序。每个程序名称对应于此包定义文件中的 [Program] 节。

示例：

Programs=Typical, Custom, Uninstall
MIFFileName：管理信息格式 (MIF) 包含包状态的文件的名称，最多 50 个字符。
MIFName：MIF 匹配的包的名称，最多 50 个字符。
MIFVersion：MIF 匹配的包的版本号，最多 32 个字符。
MIFPublisher：用于 MIF 匹配的包的软件发布者，最多 32 个字符。

[程序]

在 [包定义] 部分的“ 程序 ”条目中指定的每个程序都包含 一个 [Program] 节。本部分定义每个程序。每个程序部分都提供以下信息：

名称：程序的名称，最多 50 个字符。此项在包中必须是唯一的。
图标 (可选) ：指定包含要用于此程序的图标的文件。此图标替换Configuration Manager控制台中的默认程序图标。将程序部署到集合时，客户端也会显示此图标。
注释 (可选) ：有关程序的注释，最多 127 个字符。
CommandLine：指定程序的命令行，最多 127 个字符。命令相对于包源文件夹。
StartIn：指定程序的工作文件夹，最多 127 个字符。此项可以是客户端计算机上的绝对路径，也可以是相对于包源文件夹的路径。
运行：指定程序运行的程序模式。可以指定“最小化”、“最大化”或“隐藏”。如果未包含此项，则程序在正常模式下运行。
AfterRunning：指定在程序成功完成后发生的任何特殊操作。可用的选项包括 SMSRestart、 ProgramRestart 或 SMSLogoff。如果未包含此项，则程序不会运行特殊操作。
EstimatedDiskSpace：指定软件程序在计算机上运行所需的磁盘空间量。默认值为 Unknown。可以将值设置为大于或等于零的整数。如果指定值，则还要包括值的单位。

示例：

EstimatedDiskSpace=38MB
EstimatedRunTime：指定预计程序在客户端计算机上运行的估计持续时间（以分钟为单位）。默认值为 120。可以将该值设置为大于零或未知的整数。

示例：

EstimatedRunTime=25
SupportedClients：指定运行此程序的处理器和操作系统。用逗号分隔平台。如果未包含此项，则客户端不会检查此程序支持的平台。

SupportedClientMinVersionX、 SupportedClientMaxVersionX：指定 SupportedClients 条目中指定的操作系统版本号的开始到结束范围。

示例：

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 (可选) ：提供客户端计算机的任何其他信息或要求，最多 127 个字符。
CanRunWhen：指定程序在客户端计算机上运行所需的用户状态。可用值为 UserLoggedOn、 NoUserLoggedOn 或 AnyUserStatus。默认值为 UserLoggedOn。
UserInputRequired：指定程序是否需要与用户交互。可用值为 True 或 False。默认值为 True。如果 CanRunWhen 未设置为 UserLoggedOn，则此项设置为 False。
AdminRightsRequired：指定程序是否需要在计算机上运行管理凭据。可用值为 True 或 False。默认值为 False。如果 CanRunWhen 未设置为 UserLoggedOn，则此项设置为 True。
UseInstallAccount：指定程序在客户端计算机上运行时是否使用客户端软件安装帐户。默认情况下，此值为 False。如果将 CanRunWhen 设置为 UserLoggedOn，此值也为 False。
DriveLetterConnection：指定程序是否需要将驱动器号连接到分发点上的包文件。可以指定 True 或 False。默认值为 False，使程序能够使用通用命名约定 (UNC) 连接。当此值设置为 True 时，客户端将使用下一个可用的驱动器号，从 Z：开始并后退。
SpecifyDrive (可选) ：指定程序连接到分发点上的包文件所需的驱动器号。此设置强制对与分发点的客户端连接使用指定的驱动器号。
重新连接DriveAtLogon：指定计算机在用户登录时是否重新连接到分发点。可用值为 True 或 False。默认值为 False。
DependentProgram：在此包中指定必须在当前程序之前运行的程序。此条目使用格式 DependentProgram=<ProgramName>，其中 <ProgramName> 是包定义文件中该程序 的名称 条目。如果没有依赖程序，请将此项留空。

示例：

DependentProgram=Admin
DependentProgram=
分配：指定如何将程序分配给用户。此值可以是：
- FirstUser：只有登录到客户端的第一个用户才能运行程序
- EveryUser：登录的每个用户都运行程序
当 CanRunWhen 未设置为 UserLoggedOn 时，此项将设置为 FirstUser。
已禁用：指定是否可以将此程序部署到客户端。可用值为 True 或 False。默认值为 False。

使用包定义文件

在Configuration Manager控制台中，转到“软件库”工作区，展开“应用程序管理”，然后选择“包”节点。
在功能区的“ 开始 ”选项卡上的“ 创建” 组中，选择“ 从定义创建包”。
在“从定义向导创建包”的“包定义”页上，选择现有的包定义文件。若要打开新的包定义文件，请选择“ 浏览”。指定新的包定义文件后，从“ 包定义 ”列表中选择它。
在“ 源文件” 页上，指定有关包和程序所需的任何源文件的信息。
如果包需要源文件，请在“ 源文件夹” 页上指定站点可从中获取源文件的位置。
完成该向导。

另请参阅

包和程序

通过