How to Initiate the Software Updates Evaluation Cycle

You initiate a software updates evaluation cycle, in Microsoft System Center Configuration Manager 2007, by creating an instance of the CPAppletMgr Client COM Automation Class, identifying the client action, and running the client action by using the PerformAction method.

To initiate a software updates evaluation cycle

Create a CPAppletMgr instance by using the CPAppletMgr COM class.
Get the available client actions.
Enumerate through the client actions until a match is found (in this case, Software Updates Assignments Evaluation Cycle).
Run the client action by using the PerformAction method.

Example

The following example method shows how to initiate a software updates evaluation cycle by using the CPAppletMgr COM class.

For information about calling the sample code, see How to Call Configuration Manager COM Automation Objects

Visual Basic Script	Copy Code
Sub InitiateSoftwareUpdatesEvaluationCycle() ' Set the required variables. actionNameToRun = "Software Updates Assignments Evaluation Cycle" ' Create a CPAppletMgr instance. Dim oCPAppletMgr Set oCPAppletMgr = CreateObject("CPApplet.CPAppletMgr") ' Get the available ClientActions object. Dim oClientActions Set oClientActions = oCPAppletMgr.GetClientActions() ' Loop through the available client actions. Run the matching client action when it is found. Dim oClientAction For Each oClientAction In oClientActions If oClientAction.Name = actionNameToRun Then oClientAction.PerformAction End If Next wscript.echo "Ran: " & actionNameToRun End Sub

Visual Basic Script

Copy Code

Sub InitiateSoftwareUpdatesEvaluationCycle()

	' Set the required variables. 
	actionNameToRun = "Software Updates Assignments Evaluation Cycle"

	' Create a CPAppletMgr instance.
	Dim oCPAppletMgr
	Set oCPAppletMgr = CreateObject("CPApplet.CPAppletMgr")

	' Get the available ClientActions object.
	Dim oClientActions
	Set oClientActions = oCPAppletMgr.GetClientActions()

	' Loop through the available client actions. Run the matching client action when it is found.
	Dim oClientAction
	For Each oClientAction In oClientActions
		If oClientAction.Name = actionNameToRun Then
			oClientAction.PerformAction  
		End If
	Next

	wscript.echo "Ran: " & actionNameToRun

End Sub

C#	Copy Code
public void InitiateSoftwareUpdatesEvaluationCycle() { try { // Set the required variables. string actionNameToRun = "Software Updates Assignments Evaluation Cycle"; // Create the CPAppletMgr instance. CPAPPLETLib.CPAppletMgr ControlPanelAppletManager = new CPAPPLETLib.CPAppletMgr(); // Loop through the available client actions. Run the matching client action when it is found. foreach (CPAPPLETLib.ClientAction possibleClientAction in ControlPanelAppletManager.GetClientActions()) { if (possibleClientAction.Name == actionNameToRun) { possibleClientAction.PerformAction(); Console.WriteLine("Ran: " + possibleClientAction.Name); } } } catch (COMException ex) { Console.WriteLine("Failed to create collection. Error: " + ex.Message); throw; } }

Copy Code

public void InitiateSoftwareUpdatesEvaluationCycle()
{
	try
	{
		// Set the required variables.
		string actionNameToRun = "Software Updates Assignments Evaluation Cycle";

		// Create the CPAppletMgr instance.
		CPAPPLETLib.CPAppletMgr ControlPanelAppletManager = new CPAPPLETLib.CPAppletMgr();

		// Loop through the available client actions. Run the matching client action when it is found.
		foreach (CPAPPLETLib.ClientAction possibleClientAction in ControlPanelAppletManager.GetClientActions())
		{
			if (possibleClientAction.Name == actionNameToRun)
			{
				possibleClientAction.PerformAction();
				Console.WriteLine("Ran: " + possibleClientAction.Name);
		}
	}
}

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

}

Compiling the Code

This C# example requires:

Namespaces

System

System.Runtime.InteropServices

CPAPPLETLib COM Automation Library

COM Automation

The reference that is needed for early binding is CPApplet 1.0 Type Library. This creates a type library reference named CPAppletLib. The early binding object name for the Control Panel Manager is CPAppletMgr.

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.