Create Group (Active Directory) activity

An activity that creates a new group in Active Directory.


Create Group  activity

Configure the Create Group activity

To configure the Create Group activity, do the procedure in this topic.

Good to Know

How to Start

  1. Open Process Builder.

    For information about how to open this screen, refer to Process Builder.


    Open Process Builder
  2. In the Process Builder, in the Activity Library, open the Active Directory tab.

    Open Active Directory tab
  3. On the Active Directory tab, drag the Create Group activity onto your process.

    Drag Create Group activity

General Configuration

Specifies the basic settings for the Create Group activity.

Figure: General Configuration screen

General Configuration screen

Fields

Field Name Definition

Display Name

Function:
Specifies the activity name that shows in your process.
Accepted Values:
One line of text that can have spaces.
Default Value:
None
Accepts Process Data Variables:
No
Example:
This is a common configuration field that is used in many examples. Refer to:
  • Examples - Step-by-step use case examples, information about what types of examples are provided in the AgilePoint NX Product Documentation, and other resources where you can find more examples.

Description

Function:
Specifies an optional text description for your activity.
Accepted Values:
More than one line of text.
Default Value:
None
Accepts Process Data Variables:
No

Create Group Configuration

Specifies the information to create a group in Active Directory.

Figure: Create Group Configuration screen

Create Group Configuration screen

Fields

Field Name Definition

Active Directory

Function:
Specifies the access token that connects to your Active Directory.
Accepted Values:
A list of access tokens configured for your environment.
Default Value:
None
Accepts Process Data Variables:
No

Create Add Token icon

Opens this Screen:
Access Token for Active Directory.
Function of this Screen:
Configure an access token to connect to Active Directory.

Group Name

Function:
Specifies the name of your group.
Accepted Values:
One line of text that can have spaces.

Within the domain, you can not have more than one instance of the same group. Once the group is added, it can not be changed.

Default Value:
None
Accepts Process Data Variables:
Yes

Group Name (Pre-Windows 2000)

Function:
Specifies the log name of the account. This field can be modified after it has been created.
Accepted Values:
A group name.
Default Value:
None
Accepts Process Data Variables:
Yes

Email ID

Function:
Specifies the e-mail address of the group.
Accepted Values:
A text string in email address format.
Default Value:
None
Accepts Process Data Variables:
Yes

Group Scope

Function:
Specifies where the group exists in Active Directory.
Accepted Values:
  • Domain Local - Can have accounts, global groups, and universal groups from any domain and domain local groups within the same domain.
  • Global - Can have global groups and accounts from the same domain.
  • Universal - Can have accounts, global groups, and universal groups from any domain.
Default Value:
Global
Accepts Process Data Variables:
No

Group Type

Function:
Specifies the group type in Active Directory.
Accepted Values:
  • Security - Lets you assign access to resources on your network.
  • Distribution - Lets you send e-mails to collections of users with e-mail applications, such as Exchange.
Default Value:
Security
Accepts Process Data Variables:
No