MIIS_CSObject Class

  • Article

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.

Syntax


class MIIS_CSObject
{
  String Account;
  String UnconfirmedExportHologram;
  String Dn;
  String Domain;
  String EscrowedExportHologram;
  String FullyQualifiedDomainName;
  String Guid;
  String Hologram;
  String MaGuid;
  String MaName;
  String MvGuid;
  String ObjectType;
  String PartitionGuid;
  String PasswordChangeHistory;
  String PartitionName;
  String PendingImportHologram;
  String PartitionDisplayName;
  String UnappliedExportHologram;
  String UserPrincipalName;
};

Methods

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.

Properties

The MIIS_CSObject class defines the following properties.

  • Account
    Data type: String
    Access type: Read-only

    Gets the security account manager (SAM) account name for the user.

  • Dn
    Data type: String
    Access type: Read-only

    Gets the distinguished name of the connector space object.

  • Domain
    Data type: String
    Access type: Read-only

    Gets the domain name of the connector space object.

  • EscrowedExportHologram
    Data type: String
    Access type: Read-only

    Gets an XML representation of what the connector space object properties will be if all the exports in progress are applied to the object.

  • FullyQualifiedDomainName
    Data type: String
    Access type: Read-only

    Gets the domain name of the connector space object in domain name system (DNS) format.

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

    Gets the GUID that is used to identify the connector space object in the SQL Server 2000 database.

  • Hologram
    Data type: String
    Access type: Read-only

    Gets an XML representation of the connector space object that has been synchronized to a metaverse object.

  • MaGuid
    Data type: String
    Access type: Read-only

    Gets the GUID of the management agent for the connector space object.

  • MaName
    Data type: String
    Access type: Read-only

    Gets the name of the management agent for the connector space object.

  • MvGuid
    Data type: String
    Access type: Read-only

    Gets the GUID of the metaverse object that is joined to the connector space object.

  • ObjectType
    Data type: String
    Access type: Read-only

    Gets the name of the primary object type of the connector space object.

  • PartitionDisplayName
    Data type: String
    Access type: Read-only

    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.

  • PartitionGuid
    Data type: String
    Access type: Read-only

    Gets the GUID of the management agent partition with the connector space object.

  • PartitionName
    Data type: String
    Access type: Read-only

    Gets the display name of the management agent partition with the connector space object.

  • PasswordChangeHistory
    Data type: String
    Access type: Read-only

    Gets the log in an XML format of the calls to the MIIS_CSObject.ChangePassword and MIIS_CSObject.SetPassword methods.

  • PendingImportHologram
    Data type: String
    Access type: Read-only

    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.

  • UnappliedExportHologram
    Data type: String
    Access type: Read-only

    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.

  • UnconfirmedExportHologram
    Data type: String
    Access type: Read-only

    Gets an XML representation of the latest view of an object in the connected directory.

  • UserPrincipalName
    Data type: String
    Access type: Read-only

    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.

Remarks

The class supports the following, restricted set of queries:

  • Search for a connector space object with a specified GUID.
  • Search for a connector space object joined to a metaverse object with a specified metaverse GUID.
  • Search for a connector space object with a specified domain and account name in Active Directory, a global address list, or a Windows NT domain.
  • Search for a connector space object with a specified domain and user principal name in Active Directory, a global address list, or a Windows NT domain.

Starting with Microsoft Identity Integration Server 2003 Service Pack 1 (SP1), 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:

  • DC=c"om
  • DC=c\om
  • DC=c\,om
  • DC=c'om

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.

Examples

The following example Visual Basic Scripting Edition (VBScript) example shows how to get a connector space object with a specified GUID.

Option Explicit

Const PktPrivacy = 6    ' Authentication level 

Dim Service
Dim CsObject
Dim CsObjects

Set Service = GetObject("winmgmts:{authenticationLevel=PktPrivacy}!root\MicrosoftIdentityIntegrationServer")
Set CsObject = Service.ExecQuery("Select * from MIIS_CSObject where Guid='{5B3B52B7-5881-4780-9D46-72696AAC4A8B}'")

For each CsObject in CsObjects
WScript.Echo "Guid:                    " + CSObject.Guid
WScript.Echo "Domain:                  " + CSObject.Domain
Next

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

Const PktPrivacy = 6    ' Authentication level 

Dim Service
Dim CsObjects
Dim CsObject
Dim hr_mvguid

Set Service = GetObject("winmgmts:{authenticationLevel=PktPrivacy}!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

Const PktPrivacy = 6    ' Authentication level 

Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:{authenticationLevel=PktPrivacy}!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

Const PktPrivacy = 6    ' Authentication level 

Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:{authenticationLevel=PktPrivacy}!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 SP1.


Const PktPrivacy = 6    ' Authentication level 

Dim Service
Dim CsObjects
Set Service = GetObject("winmgmts:{authenticationLevel=PktPrivacy}!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}'")

Requirements

Product ILM 2007 FP1
MOF Mmswmi.mof
Namespace MicrosoftIdentityIntegrationServer

Send comments about this topic to Microsoft

Build date: 2/16/2009