This topic has not yet been rated - Rate this topic

MIIS_ManagementAgent Class

Visual Studio 2010

The MIIS_ManagementAgent class represents a management agent within a WMI script. To use this class, you must be logged on as a member of the MIISOperators security group or the MIISAdmins security group.

The following syntax is simplified from MOF code and includes all inherited properties.

Syntax

Copy



class MIIS_ManagementAgent
{
  String Name;
  String Guid;
  String Type;
};

Methods

The MIIS_ManagementAgent class defines the following methods.

Method	Description
Execute	Executes the specified run profile of the management agent.
Stop	Stops the management agent specified in the Get method. This call is synchronous and blocks any other calls to the specified management agent until this method is completed.
GetServerStatus	Determines if the connected directory server is running and connected to the network.
NumCSObjects	Returns the total number of connector, disconnector, and placeholder objects in this management agent.
NumTotalConnectors	Returns the number of all connector and explicit objects in this management agent.
NumTotalDisconnectors	Returns the total number of disconnector, explicit disconnector, and filtered disconnector objects in this management agent.
NumPlaceHolders	Returns the number of placeholder objects in this management agent.
NumConnectors	Returns the number of connector objects that are under this management agent. The return value does not include explicit connector objects.
NumExplicitConnectors	Returns the number of explicit connector objects in this management agent. The return value does not include connector objects.
NumDisconnectors	Returns the number of disconnector objects in this management agent. The return value does not include explicit disconnector or filtered disconnector objects.
NumExplicitDisconnectors	Returns the number of explicit disconnector objects in this management agent. This return value does not include disconnector or filtered disconnector objects.
NumFilteredDisconnectors	Returns the number of filtered disconnector objects in this management agent. The return value does not include disconnector or explicit disconnector objects.
NumImportAdd	Returns the number of connector space objects that are candidates for joining or projecting to the metaverse.
NumImportUpdate	Returns the number of connector or explicit connector objects that contain attribute changes to be applied to the joined metaverse object.
NumImportDelete	Returns the number of connector or explicit connector objects that will be deleted from the connector space.
NumImportNoChange	Returns the number of connector or explicit connector objects that have no pending changes.
NumExportAdd	Returns the number of connector space objects that will be added to the connected directory on the next export.
NumExportUpdate	Returns the number of objects that will be updated in the connected directory on the next export.
NumExportDelete	Returns the number of objects that will be deleted from the connected directory on the next export.
RunDetails	Returns the details of the last management agent run in an XML format. For more information about the run details XML schema, see <run-history>.
RunEndTime	Returns the date and time, in Coordinated Universal Time (UTC), when the management agent ended a run. The method returns a value only if the management agent is idle. For the local time the management agent ended the run, convert the return value to local time.
RunProfile	Returns the name of the run profile that was used in the current or previous management agent run.
RunNumber	Returns the number of times the management agent was run.
RunStartTime	Returns the date and time, in Coordinated Universal Time (UTC), when the management agent started a run. The method returns a value only if the management agent is idle. For the local time the management agent ended the run, convert the return value to local time.
RunStatus	Returns the status of the last management agent run.
SuppressFullSyncWarning	Suppresses the full sync warning on this management agent for the most recent update.

Properties

The MIIS_ManagementAgent class defines the following properties.

Guid

Data type: String
Access type: Read-only

Gets the globally unique identifier of the management agent.

Name

Data type: String
Access type: Read-only
Qualifiers: Key

Gets the name of the management agent.

Type

Data type: String
Access type: Read-only

Gets the management agent type.

Requirements

Product	ILM 2007 FP1
MOF	Mmswmi.mof
Namespace	MicrosoftIdentityIntegrationServer

Send comments about this topic to Microsoft

Build date: 2/16/2009

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ

Using WMI to re-sync FIM Sync to FIM Service

There's a method missing here - should also contain 'ResyncSyncConfigObjects()'.
This method comes in handy when the FIM Service is out of sync with the FIM Sync Engine. The Sync engine client (miisclient.exe) tries to update the ma-data and mv-data objects in the FIM Service whenever the FIM Sync configuration changes. If that update fails for whatever reason (timeout, FIM Service is down, etc) then you can call this method to force the sync.

After calling the method you should see requests in the FIM Service request history such as:

Create ma-data '<MA NAME>' Request
Delete ma-data '<MA NAME>' Request
Create ma-data 'Metaverse Configuration Object' Request
...

If you do NOT see those requests in the request history, then chances are your FIM MA account is pooched.

### Get the FIM MA
$fimMa = Get-WmiObject -Class MIIS_ManagementAgent -Namespace root/MicrosoftIdentityIntegrationServer -Filter ("Type='Forefront Identity Management (FIM)'")

### Call the WMI method to ReSync the Config Objects from miiserver.exe to microsoft.resourcemanagement.service.exe$fimMa.ResyncSyncConfigObjects()
$fimMa.ResyncSyncConfigObjects()

History

1/19/2011
Craig Martin