The SMS_DistributionPoint Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that represents a location from which package source files are distributed to clients.
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.
Class SMS_DistributionPoint : SMS_BaseClass { Boolean BitsEnabled; Boolean IsPeerDP; Boolean IsProtected; UInt8 ISVData[]; UInt32 ISVDataSize; DateTime LastRefreshTime; String PackageID; Boolean RefreshNow; String ResourceType; String ServerNALPath; String SiteCode; String SiteName; String SourceSite; UInt32 Status; }; |
Methods
The SMS_DistributionPoint class does not define any methods.
Properties
- BitsEnabled
- Data type: BooleanAccess type: Read-onlyQualifiers: [read]true if the distribution point is BITS-enabled. The default value is false.
- IsPeerDP
- Data type: BooleanAccess type: Read-onlyQualifiers: [read]true if the distribution point is a branch distribution point. The default value is false.
- IsProtected
- Data type: BooleanAccess type: Read-onlyQualifiers: [read]true if the site system distribution point is protected. The default value is false.
- ISVData
- Data type: UInt8 ArrayAccess type: Read/WriteQualifiers: [ResID(1010), ResDLL("SMS_RSTT.dll"), large, lazy]Values allowing a single ISV to store data relating to the SMS_Program Server WMI Class object associated with the package. See the Remarks section later in this topic.
- ISVDataSize
- Data type: UInt32Access type: Read/WriteQualifiers: [lazy, ResID(1009), ResDLL("SMS_RSTT.dll")]The size of the data indicated by ISVData. The default value is 0.
- LastRefreshTime
- Data type: DateTimeAccess type: Read/WriteQualifiers: [ResID(1006),ResDLL("SMS_RSTT.dll")]Date and time when the package was last updated on the distribution server. The default value is "19900101000000.000000+***".
- PackageID
- Data type: StringAccess type: Read/WriteQualifiers: [key, ResID(1001), ResDLL("SMS_RSTT.dll")]ID for the package to reside on the distribution server. The default value is "".
- RefreshNow
- Data type: BooleanAccess type: Read/WriteQualifiers: [ResID(1007),ResDLL("SMS_RSTT.dll")]true to signal Configuration Manager to update the package on the distribution point. The update is distribution point-specific and is equivalent to the Refresh Distribution Point action in the Configuration Manager console. This package update copies the latest content from the source of the package to a specific distribution point, so that the distribution point has the latest version. The source version of the package is not incremented, and the package content is not replicated to child sites. The default value is false.
- ResourceType
- Data type: StringAccess type: Read-onlyQualifiers: [read]The resource type of the distribution point. The default value is "".
- ServerNALPath
- Data type: StringAccess type: Read/WriteQualifiers: [key, ResID(1002), ResDLL("SMS_RSTT.dll")]Network abstraction layer (NAL) path to the distribution point server. The default value is "". See the Remarks section later in this topic.
- SiteCode
- Data type: StringAccess type: Read/WriteQualifiers: [key, SizeLimit("3"), ResID(1003), ResDLL("SMS_RSTT.dll")]Site code of the site where the package originates. The default value is "".The value furnished for this property must match the value of ServerNALPath. Your application retrieves the value from SMS_SystemResourceList Server WMI Class. See the Remarks section later in this topic.
- SiteName
- Data type: StringAccess type: Read/WriteQualifiers: [ResID(1004), ResDLL("SMS_RSTT.dll")]Friendly name of the site where the package originates. The default value is "".
- SourceSite
- Data type: StringAccess type: Read/WriteQualifiers: [SizeLimit("3"), ResID(1005), ResDLL("SMS_RSTT.dll")]Site code of the site where the package originates. The default value is "".
- Status
- Data type: UInt32Access type: Read-onlyQualifiers:
[read, enumeration, ResID(1008), ResDLL("SMS_RSTT.dll")]Current
status of the package on the distribution point. Possible values
are listed below. For more information, see the Remarks section
later in this topic.
0
NONE
1
UPDATED
2
ADDED
3
DELETED
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 distribution point is always associated with a particular package, and a package can have several distribution points.
Your application cannot change the PackageID property after the distribution point is created. To associate the distribution point with a different package, the application must delete the SMS_DistributionPoint object and create a new instance with a new PackageID value.
The SMS_SystemResourceList Server WMI Class class contains a list of the available distribution points and their NAL paths. Your application should select the NALPath property of SMS_SystemResourceList that corresponds to a RoleName property setting of "SMS Distribution Point".
When your application deletes an instance of SMS_DistributionPoint, the instance is not totally deleted until its related components are deleted. Instead, Configuration Manager sets the Status property to 3 (delete) to inform the application that the distribution point is marked for deletion. To ensure that a query does not retrieve distribution points that have been deleted (marked for deletion), your application should add this case to its WHERE clause.
There are no restrictions or defined formats for the data indicated by ISVData. However, it is important that after ISV ownership of this property has been established, it should not be overwritten. Therefore, the application should first read the existing data in this property. If the data does not belong to the caller, it should not be modified. Any ISV or application using this property should include an identifier in the data so that the ownership can be easily established.
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
Reference
SMS_SystemResourceList Server WMI ClassOther Resources
Software Distribution Server WMI ClassesSend comments about this topic to Microsoft.