How to Create a Configuration Manager Object by Using Managed Code

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

To create a Configuration Manager 2007 object by using the managed SMS Provider, use WqlConnectionManager.CreateInstance method. The CreateInstance method takes the required object type as a string parameter and returns an IResultObject object that is used to populate the new object. The IResultObject.Put method must be called to submit the object to the SMS Provider.

To create a Configuration Manager object

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

2. Using the WqlConnectionManager connection object you obtain in step one, call CreateInstance to create the required the WMI object, and receive its IResultObject object instance.

3. Populate the IResultObject properties.

4. Commit the IResultObject to the SMS Provider.

Example

The following example demonstrates how to create and then populate a new Configuration Manager package (SMS_Package).

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

public void CreatePackage(WqlConnectionManager connection)
{
    try
    {
        IResultObject package = connection.CreateInstance("SMS_Package");
        package["Name"].StringValue = "Test Package";
        package["Description"].StringValue = "A test package";
        package["PkgSourcePath"].StringValue = @"c:\Package Source";

        package.Put();
    }

    catch (SmsException ex)
    {
        Console.WriteLine("Failed to create package. Error: " + ex.Message);
        throw;
    }
}

This example method has the following parameters:

Compiling the Code

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robust Programming

The Configuration Manager exceptions that can be raised are SmsConnectionException and SmsQueryException. These can be caught together with SmsException.

See Also

Concepts

About Configuration Manager Objects
Configuration Manager Lazy Properties
How to Call a Configuration Manager Object Class Method by Using Managed Code
How to Connect to an SMS Provider in Configuration Manager by Using Managed Code
How to Modify a Configuration Manager Object by Using Managed Code
How to Perform an Asynchronous Configuration Manager Query by Using Managed Code
How to Perform a Synchronous Configuration Manager Query by Using Managed Code
How to Read a Configuration Manager Object by Using Managed Code
How to Read Lazy Properties by Using Managed Code
How to Use Configuration Manager Objects with Managed Code