The ADS input format returns properties of Active Directory objects.
The ADS input format enumerates the Active Directory objects in
the Active Directory Container whose LDAP path is specified in the
from-entity, eventually recursing
into additional Container objects found during the enumeration.
The information returned for each object depends on the value
specified for the objClass
parameter.
When the objClass parameter is
left unspecified, the ADS input format works in "property mode",
returning a record for each property of each object visited during
the enumeration.
In this case, input records have a fixed number of fields whose
values describe the properties being returned, including a
"PropertyName" field and a "PropertyValue" field containing the
name and the value of the property being processed.
Queries operating in "property mode" can work on Active Directory
objects of different types, and since each input record represents
a single object property, they can only reference a single property
at a time.
For example, the following command returns the values of all the properties named "comment" from all the objects in the specified path:
LogParser "SELECT PropertyValue FROM LDAP://mydomain.mycompany.com WHERE PropertyName = 'comment'" -i:ADSThe output would look like the following example:
PropertyValue ----------------- Builtin Builtin Account Operators Account Operators Administrators Administrators Backup Operators Backup Operators
When the name of an Active Directory object class is specified
for the objClass parameter, the
ADS input format works in "object mode", returning a record for
each object visited during the enumeration that is an instance of
the specified class.
In this case, there is an input record field for each of the
properties of the object being returned.
Queries operating in "object mode" can only work on Active
Directory objects of a single type, and since each input record
represents a single object, they can reference multiple properties
of the same object at the same time.
For example, the following command returns the specified properties from all the objects of type "Computer":
LogParser "SELECT cn, operatingSystem, operatingSystemServicePack FROM LDAP://mydomain.mycompany.com/CN=Computers,DC=mydomain,DC=mycompany,DC=com" -i:ADS -objClass:ComputerThe output would look like the following example:
cn operatingSystem operatingSystemServicePack ------------ ----------------------- -------------------------- SERVER01 Windows XP Professional Service Pack 1 SERVER02 Windows XP Professional Service Pack 2 TESTMACHINE1 Windows Server 2003 - TESTMACHINE2 Windows XP Professional Service Pack 2 TESTMACHINE3 Windows XP Professional Service Pack 1 TESTMACHINE4 Windows 2000 Server Service Pack 4
From-Entity Syntax
Fields
Parameters
Examples
© 2004 Microsoft Corporation. All rights reserved.