SMS_Program Server WMI Class

  • Article

Applies To: 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

The SMS_Program Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents a program or command to run when software is distributed to a client computer.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.

Class SMS_Program : SMS_BaseClass
{
     UInt32 ActionInProgress;
     String ApplicationHierarchy;
     String CommandLine;
     String Comment;
     String DependentProgram;
     String Description;
     UInt32 DeviceFlags;
     String DiskSpaceReq;
     String DriveLetter;
     UInt32 Duration;
     UInt8 ExtendedData[];
     UInt32 ExtendedDataSize;
     UInt8 Icon[];
     UInt32 IconSize;
     UInt8 ISVData[];
     UInt32 ISVDataSize;
     String PackageID;
    UInt32 ProgramFlags;
     String ProgramName;
     String RemovalKey;
     String Requirements;
     SMS_OS_Details SupportedOperatingSystems[];
     String WorkingDirectory;
};

Methods

The SMS_Program class does not define any methods.

Properties

  • ActionInProgress
    Data type: UInt32

    Access type: Read-only

    Qualifiers: [read, enumeration, ResID(733), ResDLL("SMS_RSTT.dll"), ResIDValueLookup("ActionInProgress")]

    Current action being performed on the package that is associated with the program by Configuration Manager. Possible values are:

    Value Description

    0

    NONE

    1

    UPDATE

    2

    ADD

    3

    DELETE

    Use this property in a WHERE clause to filter out programs that have been marked for deletion but have not yet been deleted. For more information, see the Remarks section later in this topic.

  • ApplicationHierarchy
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(911), ResDLL("SMS_RSTT.dll")]

    The application hierarchy for the program. The default value is "".

  • CommandLine
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(904), ResDLL("SMS_RSTT.dll")]

    The command line that runs when the program is started. The default value is "".

  • Comment
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(905), ResDLL("SMS_RSTT.dll")]

    Comment that describes the program in the Configuration Manager console. The default value is "".

  • DependentProgram
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(907), ResDLL("SMS_RSTT.dll")]

    A formatted text string defining any program that should be run prior to running this program. The format is defined as <PackageID>;;<ProgramName>. If the program is in the same package, the calling application can simply specify ;;<ProgramName>. The default value is "".

    The dependency is maintained only for the first time that the program runs. After the program has run, the dependency is ignored. For example, you cannot create a recurring scheduled job for which the dependency is maintained for each program run.

  • Description
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(903), ResDLL("SMS_RSTT.dll")]

    Not used.

  • DeviceFlags
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [ResID(918), ResDLL("SMS_RSTT.dll")]

    Flags describing the device associated with the program. Possible values are:

    Hex (Bit) Description

    0x01000000 (24)

    Always assign program to the client.

    0x02000000 (25)

    Assign only if the device is currently connected to a high-bandwidth connection (default above 60 KBps).

    0x04000000 (26)

    Assign only if the device is docked, that is, it is attached to a desktop that is using ActiveSync.

  • DiskSpaceReq
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(915),ResDLL("SMS_RSTT.dll")]

    Approximate disk space that the program requires. The format is "<size> <KB|MB|GB>". The default value is "".

    This information is used in the Configuration Manager console and the advertisement to provide alerts about program disk space requirements. The user can then decide to accept the advertisement or perform some disk management task first.

  • DriveLetter
    Data type: String

    Access type: Read/Write

    Qualifiers: [SizeLimit("1"), Range("a-z"), ResID(908), ResDLL("SMS_RSTT.dll")]

    Drive letter (one character in the range a-z) that the program maps to and runs from. The default value is "".

  • Duration
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [ResID(916), ResDLL("SMS_RSTT.dll")]

    The approximate duration, in minutes, of program execution on the client computer. Specify this value as a whole number greater than or equal to 0 (default) or as Unknown (not recommended). If the property is set to Unknown, Configuration Manager sets the maximum allowed run time as 720 minutes (12 hours). For additional information, see the Remarks section later in this topic.

    Note

    On client computers, the specified value for published programs appears in Run Advertised Programs in Control Panel.

  • ExtendedData
    Data type: UInt8 Array

    Access type: Read/Write

    Qualifiers: [ResID(919), ResDLL("SMS_RSTT.dll"), large, lazy]

    The XML blob for image deployment.

  • ExtendedDataSize
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [lazy, ResID(920), ResDLL("SMS_RSTT.dll")]

    The extended data size, in bytes. The default value is 0.

  • Icon
    Data type: UInt8 Array

    Access type: Read/Write

    Qualifiers: [ResID(913), ResDLL("SMS_RSTT.dll"), large]

    Icon information associated with the program icon, as displayed in the Configuration Manager console.

  • IconSize
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [lazy, ResID(912), ResDLL("SMS_RSTT.dll")]

    Size, in bytes, of the program icon. Set this property to 0 to clear the icon.

  • ISVData
    Data type: UInt8 Array

    Access type: Read/Write

    Qualifiers: [ResID(923), ResDLL("SMS_RSTT.dll"), large, lazy]

    Information that allows a single ISV to store data relating to an SMS_Program object.

    There are no restrictions or defined formats for the ISV data. However, it is important to not overwrite the property after the ISV ownership has been established. Your application should read the existing data in this property first. If the data does not belong to the application, it should not be modified. You should include an identifier in the data for the program so that ownership can be established easily.

  • ISVDataSize
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [lazy, ResID(924), ResDLL("SMS_RSTT.dll")]

    The size, in bytes, of the data stored in ISVData. The default value is 0.

  • MSIFilePath
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(922), ResDLL("SMS_RSTT.dll")]

    The file path of the Windows Installer package with which the program is associated. The default value is "".

  • MSIProductID
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(921), ResDLL("SMS_RSTT.dll")]

    The product ID of the Windows Installer package with which the program is associated. The default value is "".

  • PackageID
    Data type: String

    Access type: Read/Write

    Qualifiers: [key, Not_null, ResID(902), ResDLL("SMS_RSTT.dll")]

    ID of an existing package with which to associate the program. For more information, see the Remarks section later in this topic.

  • ProgramFlags
    Data type: UInt32

    Access type: Read/Write

    Qualifiers: [bits, ResID(914), ResDLL("SMS_RSTT.dll") ]

    Flags identifying the installation characteristics of the program. Possible values are listed below. The default values are EVERYUSER, USEUNCPATH, USERCONTEXT, and UNATTENDED

    Note

    When using SMS_Program programmatically, ensure that no conflicting values are selected. For example, NOUSERLOGGEDIN and USERCONTEXT should not be used together.

    Possible values are:

    Hex (Bit) Description

    0x00000001 (0)

    AUTHORIZED_DYNAMIC_INSTALL. The program is authorized for dynamic install.

    0x00000002 (1)

    USECUSTOMPROGRESSMSG. The task sequence shows a custom progress user interface message.

    0x00000010 (4)

    DEFAULT_PROGRAM. This is a default program

    0x00000020 (5)

    DISABLEMOMALERTONRUNNING. Disables MOM alerts while the program runs.

    0x00000040 (6)

    MOMALERTONFAIL. Generates MOM alert if the program fails.

    0x00000080 (7)

    RUN_DEPENDANT_ALWAYS. If set, this program's immediate dependent should always be run.

    0x00000100 (8)

    WINDOWS_CE. Indicates a device program. If set, the program is not offered to desktop clients.

    0x00000200 (9)

    This value is not used.

    0x00000400 (10)

    COUNTDOWN. The countdown dialog is not displayed.

    0x00000800 (11)

    FORCERERUN. This value is not used.

    0x00001000 (12)

    DISABLED. The program is disabled.

    0x00002000 (13)

    UNATTENDED. The program requires no user interaction.

    0x00004000 (14)

    USERCONTEXT. The program can run only when a user is logged on.

    0x00008000 (15)

    ADMINRIGHTS. The program must be run as the local Administrator account.

    0x00010000 (16)

    EVERYUSER. The program must be run by every user for whom it is valid. Valid only for mandatory jobs.

    0x00020000 (17)

    NOUSERLOGGEDIN. The program is run only when no user is logged on.

    0x00040000 (18)

    OKTOQUIT. The program will restart the computer.

    0x00080000 (19)

    OKTOREBOOT. Configuration Manager restarts the computer when the program has finished running successfully.

    0x00100000 (20)

    USEUNCPATH. Use a UNC path (no drive letter) to access the distribution point.

    0x00200000 (21)

    PERSISTCONNECTION. Persists the connection to the drive specified in the DriveLetter property. The USEUNCPATH bit flag must not be set.

    0x00400000 (22)

    RUNMINIMIZED. Run the program as a minimized window.

    0x00800000 (23)

    RUNMAXIMIZED. Run the program as a maximized window.

    0x01000000 (24)

    HIDEWINDOW. Hide the program window.

    0x02000000 (25)

    OKTOLOGOFF. Logoff user when program completes successfully.

    0x04000000 (26)

    RUNACCOUNT. This value is not used.

    0x08000000 (27)

    ANY_PLATFORM. Override check for platform support.

    0x10000000 (28)

    STILL_RUNNING. This value is not used.

    0x20000000 (29)

    SUPPORT_UNINSTALL. Run uninstall from the registry key when the advertisement expires.

    0x40000000 (30)

    The platform is not supported.

    0x80000000 (31)

    SHOW_IN_ARP. This value is not used.

  • ProgramName
    Data type: String

    Access type: Read/Write

    Qualifiers: [key, Not_null, ResID(901), ResDLL("SMS_RSTT.dll")]

    Unique name that represents this program.

  • RemovalKey
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(917), ResDLL("SMS_RSTT.dll")]

    Registry key that identifies the uninstall script for the program. The script must reside in the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall registry path. The default value is "".

  • Requirements
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(906), ResDLL("SMS_RSTT.dll")]

    Description of any additional requirements of the program. The default value is "".

  • SupportedOperatingSystems
    Data type: SMS_OS_Details Array

    Access type: Read/Write

    Qualifiers: [lazy, ResID(910), ResDLL("SMS_RSTT.dll")]

    SMS_OS_Details Server WMI Class objects representing the operating systems on which the program can run.

    If you do not specify ANY_PLATFORM in the ProgramFlags property, you must specify one or more supported operating systems. SMS_SupportedPlatforms Server WMI Class defines the list of platforms that Configuration Manager supports.

  • WorkingDirectory
    Data type: String

    Access type: Read/Write

    Qualifiers: [ResID(909),ResDLL("SMS_RSTT.dll")]

    The location from which the program runs. The default value is "".

    The working directory can be an absolute path on the client or a path relative to the distribution point folder that contains the package. If a working directory is not specified, Configuration Manager uses the default distribution point folder.

Remarks

There are no special class qualifiers for this class. For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.

A program is always associated with a parent package and typically represents the installation program for the package. Note that more than one program can be associated with the same package. The application uses the PackageID property to make this association. Your application cannot change this property after the SMS_Program object is created. To associate the program with a different package, the application must delete the object and create a new object with a new PackageID value.

When your application deletes an SMS_Program object, it is not deleted until its related components, such as its advertisements, are deleted. Instead, Configuration Manager sets the ActionInProgress property to DELETE (3) to mark the program for deletion. To ensure that a query does not retrieve programs that have been marked for deletion, add this case to the WHERE clause.

Important

If you are using maintenance windows for the collection on which the program is run, a conflict can occur if the value of the Duration property is longer than the scheduled maintenance window. If this property is set to Unknown, the program starts during the maintenance window, but continues to run until it completes or fails after the maintenance window is closed.

It is recommended that you not set the Duration property to Unknown because this property is used for the following two important purposes:

  • To monitor the results of the program.

  • To determine if the program will be launched when maintenance windows have been defined on the client computers.

If your application sets the Duration property but program run time exceeds this duration, then Configuration Manager stops monitoring the program but doesn't terminate the program. This allows Configuration Manager to continue with other software distribution functions, such as running other advertised programs. The manager does not:

  • Stop the program.

  • Free any drives that have been mapped for the advertised program.

  • Free any network connections made for the advertised program.

  • Free operating system resources used by Configuration Manager when advertised programs are running.

For additional information, see About Software Distribution Maintenance Windows and About the Program Run Scenario Using Maintenance Windows.

Requirements

Runtime Requirements

For more information, see Configuration Manager Server Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Server Development Requirements.

See Also

Tasks

How to Create a Package
How to Create a Program

Concepts

Software Distribution Server WMI Classes
SMS_Package Server WMI Class