Determines whether the connected directory server is running and is connected to the network. To use this method, you must be logged on as a member of the MIISOperators security group or the MIISAdmins security group. This method is a synchronous call that the server uses to determine the status of a remote server.

string GetServerStatus( [in]  PartitionGuid


In Language Name Data Type Description



Contains the GUID of the management agent partition of the object. You can set this parameter by getting the PartitionGuid Property of the object from the MIIS_CSObject collection.

Name : GetServerStatus

Return Value


Returns the status of the connected directory server. The return value can be one of the following values or one of the values listed in WMI Provider Return Strings.

Name Description


The connected directory server is running with a secure communication link, so passwords can be securely changed or set.


The connected directory server is running, but the security between the server and the connected directory server is low (40-bit). As a result, passwords cannot be sent. Enable the Secure Sockets Layer (SSL) connections and authentications if you want to send passwords.


The connected directory server is running, but the password synchronization setting for the management agent is not enabled. Enable password synchronization for the management agent.


The connected directory server with Active Directory Application Mode (ADAM) is running, but you cannot set or change passwords because the connection is not secure.


The PartitionGuid parameter is not in a GUID format.


The management agent was unable to log on to the connected directory server using the stored credentials. Verify that the management agent credentials are correct. For more information about configuring Active Directory Domain Services (AD DS) management agent credentials, see "Connect to an Active Directory Forest" in the Microsoft Forefront Identity Manager 2010 (FIM) Help. For more information about configuring credentials for the management agent for Sun ONE Directory Server 4.1x and 5.x (formerly iPlanet Directory Server) and Netscape Directory Server 4.1 and 6.01, see "Connect to a Sun or Netscape directory server" in the FIM Help.


The management agent type does not support password changes.


The partition that corresponds to the PartitionGuid parameter has not been configured. Configure the partition using Synchronization Service Manager. For more information, see "Configure directory partitions" in the FIM Help.


The server could not connect to the connected directory server. Verify that the connected directory server is running and is connected the network.


The PartitionGuid parameter cannot be matched to a partition in the connected directory server that belongs to the management agent. Verify that you are using the correct PartitionGuid parameter for the partition.


The following example shows how to use Microsoft Visual Basic Scripting Edition (VBScript) to get the status of the connected directory server that contains an object that has a specified domain and account.

Visual Basic Script  Copy Code
Option Explicit

On Error Resume Next

Dim Service
Dim CsObjects
Dim CsObject
Dim MAObjects
Dim MAObject

Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObjects = Service.ExecQuery _
			("Select * from MIIS_CSObject where domain='Main' and account='Jeff'")

For Each CsObject in Csobjects
	Set MAObjects = Service.ExecQuery _
	 ("select * from MIIS_ManagementAgent where guid='"& CSObject.MaGuid &"'")
	For Each MAObject in MAObjects
		WScript.Echo "GetServerStatus returns '" + MAObject.GetServerStatus _
		 ( CSObject.PartitionGuid )


Sub ErrorHandler (ErrorMessage)
  WScript.Echo ErrorMessage
End Sub



Forefront Identity Manager Synchronization Service 2010



See Also