| Microsoft Identity Integration Server 2003 Developer Reference |
The MIIS_CSObject class represents an instance of each connector space object in the server. To use this class, you must be logged on as a member of the MIISPasswordSet security group or the MIISBrowse security group.
The following syntax is simplified from MOF code and includes all inherited properties.
class MIIS_CSObject
{
String Account;
String Dn;
String Domain;
String EscrowedExportHologram;
String FullyQualifiedDomainName;
String Guid;
String Hologram;
String MaGuid;
String MaName;
String MvGuid;
String ObjectType;
String PartitionDisplayName;
String PartitionGuid;
String PartitionName;
String PasswordChangeHistory;
String PendingImportHologram;
String UnappliedExportHologram;
String UnconfirmedExportHologram;
String UserPrincipalName;
};
The MIIS_CSObject class defines the following methods.
| Method | Description |
|---|---|
| ChangePassword | Changes the password on a connector space object to a new password. |
| SetPassword | Sets the password on a connector space object to a new password. |
The MIIS_CSObject class has the following properties.
Gets the security account manager (SAM) account name for the user.
Gets the distinguished name of the connector space object.
Gets the domain name of the connector space object.
Gets an XML representation of what the connector space object properties will be if all the exports in progress are applied to the object.
Gets the domain name of the connector space object in domain name system (DNS) format.
Gets the GUID that is used to identify the connector space object in the SQL Server 2000 database.
Gets an XML representation of the connector space object that has been synchronized to a metaverse object.
Gets the GUID of the management agent for the connector space object.
Gets the name of the management agent for the connector space object.
Gets the GUID of the metaverse object that is joined to the connector space object.
Gets the name of the primary object type of the connector space object.
Gets an alternate display name of the management agent partition with the connector space object. This alternate display name is used by password management applications.
Gets the GUID of the management agent partition with the connector space object.
Gets the display name of the management agent partition with the connector space object.
Gets the log in an XML format of the calls to the MIIS_CSObject.ChangePassword and MIIS_CSObject.SetPassword methods.
Gets an XML representation of the connector space object in the connected directory that has been imported into the server from a full or delta import run profile.
Gets an XML representation of the properties of a connector space object if all the exports from the metaverse are successfully applied to the object.
Gets an XML representation of the latest view of an object in the connected directory.
Gets the UserPrincipalName property of the connector space object. This property is populated only through the Active Directory and global address list (GAL) synchronization management agent.
The class supports the following, restricted set of queries:
Starting with Microsoft Identity Integration Server 2003 Service Pack 1, this class also supports searching for a connector space object with a specified distinguished name and management agent GUID. For directory-based management agents, you can search by distinguished name. For management agent types that do not have a distinguished name (for example, a database or non-hierarchical file-based management agent), you can search by anchor attribute because, in the MIIS, the anchor attribute is treated as a distinguished name.
Since WMI contains some special characters, they have to be escaped before they are passed into the function. The special characters for WMI include quotation marks ("), commas (,), backslashes (\), and apostrophes ('). Commas, backslashes, and apostrophes have to be preceded by a backslash . Quotation marks have to preceded by another set of quotation marks. For example, to search for the following objects:
The following WMI code has to be written:
Set CsObjects = Service.ExecQuery ("Select * from
MIIS_CSObject where DN = 'DC=c""om' and MaGuid ='{AD76535A-2523-4EB2-9C2B-4C0E02E9CF95}' ")
Set CsObjects = Service.ExecQuery ("Select * from
MIIS_CSObject where DN = 'DC=c\\om' and MaGuid ='{AD76535A-2523-4EB2-9C2B-4C0E02E9CF95}' ")
Set CsObjects = Service.ExecQuery ("Select * from
MIIS_CSObject where DN = 'DC=c\\,om' and MaGuid ='{AD76535A-2523-4EB2-9C2B-4C0E02E9CF95}' ")
Set CsObjects = Service.ExecQuery ("Select * from
MIIS_CSObject where DN = 'DC=c\'om' and MaGuid ='{AD76535A-2523-4EB2-9C2B-4C0E02E9CF95}' ")
The class supports the OR operator in these searches. If the query does not contain a WHERE clause, the search fails.
The following example Visual Basic Scripting Edition (VBScript) example shows how to get a connector space object with a specified GUID.
Option Explicit
Dim Service
Dim CsObject
Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObject = Service.Get("MIIS_CSObject.Guid='{707E0C18-5712-42A8-A8E7-19CBE8565388}'")
The following VBScript example shows how to find all connector
space objects that are joined to a metaverse object with a
specified GUID.
Option Explicit
Dim Service
Dim CsObjects
Dim CsObject
Dim hr_mvguid
Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObjects = Service.ExecQuery _
("Select * from MIIS_CSObject where domain='Fabrikam' and account='HRAccount'")
For Each CSObject in CSObjects
If (CSObject.MaName = "Fabrikam HR MA") Then
hr_mvguid = CSObject.mvguid
End if
Next
Set CsObjects = Service.ExecQuery _
("Select * from MIIS_CSObject where mvguid = hr_mvguid")
The following VBScript example shows how to retrieve all connector
space objects with a specified domain and SAM account name.
Option Explicit
Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObjects = Service.ExecQuery _
("Select * from MIIS_CSObject where domain='Fabrikam' and account='HRAccount'")
The following VBScript example shows how to retrieve all connector
space objects with a specified domain and user principal name.
Option Explicit
Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObjects = Service.ExecQuery _
("Select * from MIIS_CSObject where domain='Fabrikam' and userPrincipalName='Jeff'")
The following VBScript example shows how to retrieve all connector
space objects with a specified distinguished name and management
agent GUID. This search query can only be run on Microsoft Identity
Integration Server 2003 Service Pack 1.
Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:root\MicrosoftIdentityIntegrationServer")
Set CsObjects = Service.ExecQuery _
("Select * from MIIS_CSObject where DN='CN=jeffsmith,DC=Fabrikam,DC=com' and MaGuid='{AD76535A-2523-4EB2-9C2B-4C0E02E9CF95}'")
Server: Requires Microsoft Identity Integration
Server 2003.
Header: Declared in mmswmi.mof.