ActiveDirectoryDiscoveryType Complex Type

  • Article

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

In Configuration Manager 2007, the ActiveDirectoryDiscoveryType complex type defines the type representing data that is required to retrieve properties from Active Directory.

<xs:complexType name="ActiveDirectoryDiscoveryType">
    <xs:complexContent>
        <xs:extension
            base="DiscoverySourceType"
        >
            <xs:sequence>
                <xs:element name="LdapPrefix"
                    type="LdapPrefixType"
                 />
                <xs:element name="DnName"
                    type="DnNameType"
                 />
                <xs:element name="Filter"
                    type="LdapFilterType"
                 />
                <xs:element name="Attribute"
                    type="NonEmptyStringType"
                 />
            </xs:sequence>
            <xs:attribute name="Depth"
                type="SearchDepthType"
                use="optional"
             />
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

Child Elements

Element Type Description

Attribute

NonEmptyStringType

The name of the directory object property whose value must be retrieved and assigned to the parent setting.

This is a string name that describes the property. The property name is case insensitive.

DnName

DnNameType

The distinguished name (DN) of the directory object/container that will form the base of the discovery. This is distinguished name syntax as described in Search Filter Syntax (https://go.microsoft.com/fwlink/?LinkId=110496).

The string can use environment variables.

Filter

LdapFilterType

The Lightweight Directory Access Protocol (LDAP) filter to apply to the search.

This is distinguished name syntax as described in Search Filter Syntax (https://go.microsoft.com/fwlink/?LinkId=110496).

The string can use environment variables.

LdapPrefix

LdapPrefixType

The prefix to apply to the given distinguished name. This prefix is prepended to the value in the DnName element to form the base object of the search.

This is of the form: LDAP:// , GC://, LDAP://<hostname> or GC://<hostname>.

This string can use environment variables.

Attributes

Name Type Description

Depth

SearchDepthType

The search scope to use:

"Base" is just the exact object that is defined by the given DN. This is the default if no filter is specified.

"OneLevel" means to just match against the immediate child directory objects under this one. This requires that the Filter element be specified. Failure to do so results in an error at runtime.

"Subtree" means to match against the whole directory tree under this object. This requires that the Filter element be specified. Failure to do so results in an error at runtime.

See Also

Concepts

Authoring Desired Configuration Management Configuration Baselines and Configuration Items