Skip to main content

AD: Get Computers

Description

Use the step to provide the list of all active directory computers on a specified path for the hierarchical scope specified.

important

This is a row generating step and hence has to be the first step in a workflow.

Configurations

Field nameDescription
Step nameSpecify a unique name for the step.
CONNECTION tab:Connection fields
Server NameSpecify the Hostname or Server Name or Fully Qualified Domain Name or IP address of machine where Active Directory is hosted.
The field is mandatory.
PortThe port number for Active Directory should be provided. If port number is not provided, internally default port for Active Directory is used that is, 389.
Port should be an integer.
UsernameProvide User Logon Name (e.g. sbrown, scott.brown etc.) or User Principal Name (e.g. sbrown@autoedge.com) of an Active Directory account to authenticate.
This field is mandatory.
PasswordSpecify the password for the username above. Password field appears as Text box and accepts static values or variables.
The data type is string. The field is mandatory.
Button: Test ConnectionVerifies whether the connection is available or not.
For the purpose of verification fields coming from previous steps are not allowed. Static values and environment variables are allowed.
INPUT tab:Input fields
PathProvide path of Active Directory usually Distinguished Name (DN) (e.g. OU=Temp, DC=autoedge, DC=com or) or Canonical Name (e.g. e.g. automationedge.com/Temp) for which we want to get all the Computers.
The Data type is String. This field is mandatory.
Search ScopeMouse hover on this element to see the allowed values ‘Base’, ‘OneLevel’, ‘SubTree’, OR ‘0’, ‘1’, ‘2’.
The Data type is String. This field is mandatory.
Specifies the scope of an Active Directory search. The acceptable values for this parameter are as follows:
  • Base or 0: Base or 0 searches only the current path or object.
  • OneLevel or 1: OneLevel or 1 searches the immediate children of that path or object.
  • SubTree or 2: Subtree or 2 searches the current path or object and all children of that path or object.
OUTPUT tab:Output fields
ComputersSpecify an output field to hold the Computer Name on the successful plugin execution. The default value for this field is “Computers”.
Distinguished NameSpecify an output field to hold the Distinguished Name of a computer on the successful plugin execution. The default value for this field is “DistinguishedName”.