关于包定义文件格式

应用到: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

包定义文件是一些可用于帮助使用 Configuration Manager 2007 自动创建包的脚本。它们提供了 Configuration Manager 2007 分发特定类型的文件所需的基本信息(包源文件的位置除外)。每个包定义文件都是采用标准 .ini 文件格式且包含以下各部分的 ASCII 文本文件:

  • [PDF]

  • [Package Definition]

  • [Program]

[PDF]

此部分将文件标识为包定义文件并包含以下信息:

  • 版本:指定文件所用的包定义文件格式的版本,符合它们所写入的 System Management Server (SMS) 或 Configuration Manager 的版本。此项是必需的。

[Package Definition]

包定义文件的此部分指定了包的总体属性并提供以下信息:

  • 名称:包的名称,最多 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]

对于在 [Package Definition] 部分的 Programs 项中指定的每个程序,包定义文件必须包含定义该程序的部分。对于该包中包含的所有程序,文件必须包含 [Program] 部分。本节内容提供以下信息:

  • 名称:程序的名称,最多 50 个字符。此项在包中必须是唯一的,并且在定义播发时使用。在客户端计算机上,程序的名称显示在控制面板的“运行播发程序”中。此项是必需的。

  • 图标:指定包含要用于此程序的图标的文件。如果使用此项,则新图标将替换 Configuration Manager 控制台中的默认程序图标,并且在播发程序时该图标将显示在客户端计算机上。此项是可选的。

  • 备注:关于程序的可选注释,最多 127 个字符。

  • CommandLine:指定程序的命令行,最多 127 个字符。命令与包源文件夹有关。此项是必需的。

  • StartIn:程序的工作文件夹,最多 127 个字符。此项可以是客户端计算机上的绝对路径,也可以是包源文件夹的相对路径。此项是必需的。

  • Run:指定程序运行将使用的程序模式。可以指定 MinimizedMaximizedHidden。如果不包括此项,则程序将以正常模式运行。

  • AfterRunning:指定成功完成程序后发生的特殊操作。可用的选项有 SMSRestartProgramRestartSMSLogoff。如果不包括此项,程序将不会运行特殊操作。

  • EstimatedDiskSpace:指定软件程序在计算机上运行所需的磁盘空间量。这可以指定为“未知”(默认设置)或者大于或等于零的整数。如果指定了值,则也必须指定值的单位。

    例如:

    EstimatedDiskSpace=38MB

  • EstimatedRunTime:指定预计程序在客户端计算机上运行的估计时间(以分钟计)。这可以指定为“未知”(默认设置)或者大于零的整数。

    例如:

    EstimatedRunTime=25

  • SupportedClients:指定将在其上运行该程序的处理器和操作系统。每个平台之间必须用逗号分隔开。如果包定义文件中不包括此项,将禁用该程序的支持的平台检查。

  • SupportedClientMinVersionXSupportedClientMaxVersionX:指定在 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:指定在客户端计算机运行程序所需的用户状态。可用的值有 UserLoggedOnNoUserLoggedOnAnyUserStatus。默认值为 UserLoggedOn

  • UserInputRequired:指定程序是否需要与用户交互才能完成运行。可用的值是 TrueFalse。默认值为 True。如果 CanRunWhen 未设置为 UserLoggedOn,则此项将会设置为 False

  • AdminRightsRequired:指定程序是否需要此计算机的管理凭据才能运行。可用的值是 TrueFalse。默认值为 False。如果 CanRunWhen 未设置为 UserLoggedOn,则此项将会设置为 True

  • UseInstallAccount:指定程序在客户端计算机上运行时是否使用客户端软件安装帐户。默认情况下,该值为 False。如果将 CanRunWhen 设置为 UserLoggedOn,则该值也为 False

  • DriveLetterConnection:指定程序是否需要将驱动器号与分发点上的包文件建立连接。可以指定 TrueFalse。默认值为 False,这允许程序将使用通用命名约定 (UNC) 连接。如果将该值设置为 True,将使用下一个可用的驱动器号(以 Z:开头,按顺序向后)。

  • SpecifyDrive:指定程序连接到分发点上的包文件时所需的驱动器号。使用此项可以将指定的驱动器号强制用于与分发点的客户端连接。此项是可选的。

  • ReconnectDriveAtLogon:指定用户登录时,计算机是否重新连接到分发点。可用的值是 TrueFalse。默认值为 False

  • DependentProgram:指定必须在当前程序之前运行的程序(在此包中)。此项使用格式 DependentProgram=<ProgramName>,其中 <ProgramName> 是包定义文件中该程序的 Name 项。如果没有从属程序,则将此项留空。

    例如:

    DependentProgram=Admin
    DependentProgram=

  • Assignment:将程序分配给用户的方式。该值可以为 FirstUser(只有登录的第一个用户才能运行该程序)或 EveryUser(登录到客户端的所有用户都可以运行该程序)。如果 CanRunWhen 未设置为 UserLoggedOn,则此项将会设置为 FirstUser

  • Disabled:指定是否可将该程序播发给客户端。可用的值是 TrueFalse。默认值为 False

另请参阅

任务

如何从包定义文件中创建包

概念

关于包
关于程序

有关其他信息,请参阅 Configuration Manager 2007 Information and Support
要与文档团队联系,请将电子邮件发送至 SMSdocs@microsoft.com。