The following example shows how to assign a distribution point to a package by using the SMS_DistributionPoint Server WMI Class class and class properties in Microsoft System Center Configuration Manager 2007.

You only need to assign a distribution point to a package if the package contains source files. The package is not advertised until the program source files have been propagated to a distribution point share. You can use the default distribution point share, or you can specify a share to use. You can also specify more than one distribution point to use to distribute your package source files, although the following example does not demonstrate that.

Note
To identify branch distribution points, check the IsPeerDP property of the specific SMS_DistributionPoint class instance. If the IsPeerDP property is true, then the distribution point is a branch distribution point.

To list distribution points for a site

  1. Set up a connection to the SMS Provider. For more information, see About the SMS Provider in Configuration Manager.

  2. Run a query, which populates a variable with a collection of distribution point objects.

  3. Enumerate through the collection of and list the distribution points returned by the query.

Example

The following example method lists distribution points for a site.

For information about calling the sample code, see Calling Configuration Manager Code Snippets.

Visual Basic Script  Copy Code 
Sub ListDistributionPointsForSite(connection, siteCode)

	' This query selects all distribution points for a site based on the provided site code.
	Query = "SELECT * FROM SMS_SystemResourceList WHERE RoleName='SMS Distribution Point' AND SiteCode='" & siteCode & "'"

	' Run query, which populates listOfResources with a collection of objects.
	Set ListOfResources = connection.ExecQuery(query, , wbemFlagForwardOnly Or wbemFlagReturnImmediately)

	' Output header for list of distribution points.
	Wscript.Echo "List of distribution points for site: " & siteCode
	Wscript.Echo "--------------------------------------------"



	' Enumerate through the collection of objects returned by the query.
	For Each resource In listOfResources
		' Output the server name for each distribution point.
		Wscript.Echo resource.ServerName
	Next

End Sub
C#  Copy Code 
public void ListDistributionPointsForSite(WqlConnectionManager connection, string siteCode)
{
	try
	{
		// This query selects all distribution points for a site based on the provided site code.
		string query = "SELECT * FROM SMS_SystemResourceList WHERE RoleName='SMS Distribution Point' AND SiteCode='" + siteCode + "'";

		// Run query, which populates 'listOfResources' with a collection of objects. 
		IResultObject listOfResources = connection.QueryProcessor.ExecuteQuery(query);

		// Output header for list of distribution points.
		Console.WriteLine("List of distribution points for site: " + siteCode);
		Console.WriteLine("--------------------------------------------");

		// Enumerate through the collection of objects returned by the query.
		foreach (IResultObject resource in listOfResources)
		{
			// Output the server name for each distribution point.
			Console.WriteLine(resource["ServerName"].StringValue);
	}
}
	catch (SmsException ex)
	{
		Console.WriteLine("Failed to list distribution points. Error: " + ex.Message);
		throw;
}
}

The example method has the following parameters:

Parameter Type Description

connection

swebemServices

  • Managed: WqlConnectionManager

  • VBScript: SWbemServices

A valid connection to the SMS Provider.

siteCode

  • Managed: String

  • VBScript: String

The site code for the site that supports the distribution points.

Compiling the Code

The C# example requires:

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

adminui.wqlqueryengine

microsoft.configurationmanagement.managementprovider

Robust Programming

For more information about error handling, see About Configuration Manager Errors.

Security

For more information about securing Configuration Manager applications, see Securing Configuration Manager Applications.

See Also

Send comments about this topic to Microsoft.