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.
Set up a connection to the SMS Provider. For more information, see About the SMS Provider in Configuration Manager.
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.
Populate the IResultObject properties.
Commit the IResultObject to the SMS Provider.
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:
Parameter | Type | Description |
---|---|---|
connection |
Managed: WqlConnectionManager |
A valid connection to the SMS Provider. |
System
System.Collections.Generic
System.ComponentModel
Microsoft.ConfigurationManagement.ManagementProvider
Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine
microsoft.configurationmanagement.managementprovider
adminui.wqlqueryengine
The Configuration Manager exceptions that can be raised are SmsConnectionException and SmsQueryException. These can be caught together with SmsException.
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