SMS_Package Server WMI Class
Updated: October 28, 2009
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_Package Windows Management Instrumentation (WMI) class is an SMS Provider server class that contains information about Configuration Manager packages.
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.
Class SMS_Package : SMS_PackageBaseclass
{
UInt32 ActionInProgress;
String Description;
UInt8 ExtendedData[];
UInt32 ExtendedDataSize;
UInt32 ForcedDisconnectDelay;
Boolean ForcedDisconnectEnabled;
UInt32 ForcedDisconnectNumRetries;
UInt8 Icon[];
UInt32 IconSize;
Boolean IgnoreAddressSchedule;
UInt8 ISVData[];
UInt32 ISVDataSize;
String Language;
DateTime LastRefreshTime;
String Manufacturer;
String MIFFilename;
String MIFName;
String MIFPublisher;
String MIFVersion;
String Name;
String PackageID;
UInt32 PackageType;
UInt32 PkgFlags;
UInt32 PkgSourceFlag;
String PkgSourcePath;
String PreferredAddressType;
UInt32 Priority;
Boolean RefreshPkgSourceFlag;
Object RefreshSchedule[];
String ShareName;
UInt32 ShareType;
DateTime SourceDate;
String SourceSite;
UInt32 SourceVersion;
String StoredPkgPath;
UInt32 StoredPkgVersion;
String Version;
};
The following table lists the methods in the SMS_Package class.
| Method | Description |
|---|---|
|
Adds a package change notification. |
|
|
Adds the distribution points for the package. |
|
|
Determines if any other package is using the same custom share name. |
|
|
Determines whether the specified source name is used by another package. |
|
|
Refreshes the package source at all distribution points, when the package properties have not changed. |
|
|
Sets the code of the source site for the package. |
|
|
Sets the source site to the current site, unlocking the package. |
- ActionInProgress
- Data type: UInt32 Access type: Read-only Qualifiers: [read, ResID(733), ResDLL("SMS_RSTT.dll"), ResIDValueLookup("ActionInProgress")] See SMS_PackageBaseclass Server WMI Class.
- AlternateContentProviders
- Data type: String Access type: Read/Write Qualifiers: [ResID(739), ResDLL("SMS_RSTT.dll"), large, lazy] See SMS_PackageBaseclass Server WMI Class.
- Description
- Data type: String Access type: Read/Write Qualifiers: [ResID(706), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ExtendedData
- Data type: UInt8 Array Access type: Read/Write Qualifiers: [ResID(735), ResDLL("SMS_RSTT.dll"), large, lazy] See SMS_PackageBaseclass Server WMI Class.
- ExtendedDataSize
- Data type: UInt32 Access type: Read/Write Qualifiers: [lazy, ResID(736), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ForcedDisconnectDelay
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(719), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ForcedDisconnectEnabled
- Data type: Boolean Access type: Read/Write Qualifiers: [ResID(717), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ForcedDisconnectNumRetries
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(718), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Icon
- Data type: UInt8 Array Access type: Read/Write Qualifiers: [ResID(724), ResDLL("SMS_RSTT.dll"), large] See SMS_PackageBaseclass Server WMI Class.
- IconSize
- Data type: UInt32 Access type: Read/Write Qualifiers: [lazy, ResID(723), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- IgnoreAddressSchedule
- Data type: Boolean Access type: Read/Write Qualifiers: [ResID(722), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ISVData
- Data type: UInt8 Array Access type: Read/Write Qualifiers: [ResID(737), ResDLL("SMS_RSTT.dll"), large, lazy] See SMS_PackageBaseclass Server WMI Class.
- ISVDataSize
- Data type: UInt32 Access type: Read/Write Qualifiers: [lazy, ResID(738), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Language
- Data type: String Access type: Read/Write Qualifiers: [ResID(704), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- LastRefreshTime
- Data type: DateTime Access type: Read-only Qualifiers: [read, ResID(726), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Manufacturer
- Data type: String Access type: Read/Write Qualifiers: [ResID(705), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- MIFFilename
- Data type: String Access type: Read/Write Qualifiers: [ResID(729), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- MIFName
- Data type: String Access type: Read/Write Qualifiers: [ResID(731), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- MIFPublisher
- Data type: String Access type: Read/Write Qualifiers: [ResID(730), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- MIFVersion
- Data type: String Access type: Read/Write Qualifiers: [ResID(732), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Name
- Data type: String Access type: Read/Write Qualifiers: [ResID(702), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- PackageID
- Data type: String Access type: [key, ResID(701), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- PackageType
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(734), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- PkgFlags
- Data type: UInt32 Access type: Read/Write Qualifiers: [bits, ResID(728), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- PkgSourceFlag
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(707), ResDLL("SMS_RSTT.dll"), ResIDValueLookup("PkgSourceFlag")] See SMS_PackageBaseclass Server WMI Class.
- PkgSourcePath
- Data type: String Access type: Read/Write Qualifiers: [ResID(708), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- PreferredAddressType
- Data type: String Access type: Read/Write Qualifiers: [ResID(721), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Priority
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(720), ResDLL("SMS_RSTT.dll"), ResIDValueLookup("Priority")] See SMS_PackageBaseclass Server WMI Class.
- RefreshPkgSourceFlag
- Data type: Boolean Access type: Read/Write Qualifiers: [lazy, ResID(709), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- RefreshSchedule
- Data type: SMS_ScheduleToken Array Access type: [max(15), lazy, ResID(725), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ShareName
- Data type: String Access type: Read/Write Qualifiers: [ResID(715), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- ShareType
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(714), ResDLL("SMS_RSTT.dll"), ResIDValueLookup("ShareType")] See SMS_PackageBaseclass Server WMI Class.
- SourceDate
- Data type: DateTime Access type: Read-only Qualifiers: [read, ResID(713), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- SourceSite
- Data type: String Access type: Read-only Qualifiers: [read, ResID(716), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- SourceVersion
- Data type: UInt32 Access type: Read-only Qualifiers: [read, ResID(712), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- StoredPkgPath
- Data type: String Access type: Read/Write Qualifiers: [ResID(710), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- StoredPkgVersion
- Data type: UInt32 Access type: Read/Write Qualifiers: [ResID(711), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
- Version
- Data type: String Access type: Read/Write Qualifiers: [ResID(703), ResDLL("SMS_RSTT.dll")] See SMS_PackageBaseclass Server WMI Class.
Class qualifiers for this class include:
-
Secured
For more information about both the class qualifiers and the property qualifiers included in the Properties section, see Configuration Manager Class and Property Qualifiers.
Configuration Manager 2007 uses packages to distribute software to clients. Every package must contain at least one program (SMS_Program Server WMI Class), identifying what actions should occur on the client when the package is received. You can also identify whether the program provides an install status Management Information Format (MIF) file to report status or just uses an exit code.
When your application deletes an SMS_Package object, it is not fully deleted until deletion of its related items, for example, programs, source files, distribution points, and advertisements. Instead, Configuration Manager sets the ActionInProgress property to DELETE to mark the package for deletion. In SMS 2.0, to ensure that a query does not retrieve packages that have been marked for deletion, add this case to the WHERE clause. In SMS 2003, the WHERE clause is not required, because packages that are marked for deletion are not retrieved by a query. Use a status MIF file to generate detailed status reporting. To generate a status MIF file, your application must call the InstallStatusMIF Function function. For more information, Status MIF Functions.
The values that your application provides when creating a package are entirely dependent on the programs that the package contains. For example, if the package contains a simple program that does not use source files and does not generate a status MIF file, the application can create a package that merely contains a value for the Name property.
Changing the ShareName or the PkgSourcePath property causes the Distribution Manager to delete and recreate the package on all distribution points of the current site. In addition, when PkgSourcePath is updated, the package is recompressed, if PkgSourceFlag has the STORAGE_COMPRESS bit set, and sent to all child sites that have a distribution point defined for the package. Because this can be an expensive process, your application should be efficient when updating these fields.
Note |
|---|
| Your application can also use the GetPDFData Method in Class SMS_PDF_Package to generate an SMS_Package object. |
Runtime Requirements
For more information, see Configuration Manager Server Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Server Development Requirements.
Note