Query connector status

Question

Hi folks,
Can anyone tell me how to query the status of a connector via either Powershell or SDK?
I can find pretty much everything except for:
a)Start time
b)Finish time
c) is running?
Many thanks
Steve

Answer 1

You're looking for a connector's "SyncStatus" object.
SyncStatus objects are related to each connector. They keep track of start/end times and current status.
The class name is "Microsoft.SystemCenter.LinkingFramework.SyncStatus"
The relationship class between the connector object and the sync status object is "Microsoft.SystemCenter.LinkingFramework.DataSourceHostSyncStatus"
Here's a quick line of C# to get the sync status object related to your connector:
//Connect to your management group
EnterpriseManagementGroup emg = new EnterpriseManagementGroup("myGroup");//Get the relationship we'll need
ManagementPackRelationship relDataSourceHostSyncStatus = emg.EntityTypes.GetRelationshipClass(new Guid("1548950D-6CEA-D9C1-11EC-53701FBCBBEC")); //Microsoft.SystemCenter.LinkingFramework.DataSourceHostSyncStatus
//Get your connector from the connector framework. Your Id is a Guid (you may have to look it up in the MT_Connector table in SQL, unless you already know it)
EnterpriseManagementConnector emcMyConnector = emg.ConnectorFramework.GetConnector(new Guid("<my connector's Id>"));
//Get all related sync status objects via the DataSourceHostsSyncStatus relationship
IList<EnterpriseManagementObject> lstSyncStatus = emg.EntityObjects.GetRelatedObjects<EnterpriseManagementObject>(emcMyConnector.ConnectorObject.Id, relDataSourceHostSyncStatus, TraversalDepth.OneLevel, ObjectQueryOptions.Default);
//Get the sync status object from the returned list..there should only be one sync status object per connector.
EnterpriseManagementObject emoSyncStatus = null;
foreach(EnterpriseManagementObject emo in lstSyncStatus)
emoSyncStatus = emo;
After you have your sync status object, you can see the "LastRunStartTime", "LastRunFinishTime", "SyncPercent", and "Status". Status is an enumeration with values like "Running, finishedsuccess, neverrun, unknown,
funishedwitherror, and runningwitherror"
Example:
ManagementPackClass mpcSyncStatus = emg.EntityTypes.GetClass(new Guid("2D4AFD51-D2FF-92C6-266F-2B6060000DAE")); //Microsoft.SystemCenter.LinkingFramework.SyncStatus
Console.Writeline(emoSyncStatus[mpcSyncStatus,"LastRunStartTime"].Value.ToString());
Console.Writeline(emoSyncStatus[mpcSyncStatus,"LastRunFinishTime"].Value.ToString());
Console.Writeline(emoSyncStatus[mpcSyncStatus,"Status"].Value.ToString());
Console.Writeline(emoSyncStatus[mpcSyncStatus,"SyncPercent"].Value.ToString());
Note that the .Value.ToString() calls will fail if Value is null..always check to see if the value has something in it :)