Use the Add-ADGroup cmdlet to migrate data from the source technology group into an Active Directory directory service group.

Add-ADGroup -TransporterObject <IAlienDataObject> [-Confirm [<SwitchParameter>]] [-GlobalCatalog <String>] [-PrimaryDirectory <String>] [-Quiet <SwitchParameter>] [-TargetOU <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter

Required

Type

Description

TransporterObject

Required

Microsoft.Exchange.Transporter.IAlienDataObject

The TransporterObject parameter is the receptacle for iAlienDataObjects of type directory.group from the pipeline.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You do not have to specify a value with the Confirm parameter.

DomainController

Optional

System.String

The DomainController parameter specifies the Active Directory domain controller Global Catalog to connect to.

If a value is not specified, a referral will occur to obtain a valid Global Catalog.

GlobalCatalog

Optional

System.String

The GlobalCatalog parameter identifies the Active Directory server.

PrimaryDirectory

Optional

System.String

The PrimaryDirectory parameter specifies the mode of injection. "Source" replaces the target group membership with the source membership list. "Target" checks each group to see if it exists, and leaves it in place if it already exists. "Merge" adds all of the source list members to the target list membership.

Note: Proxy addresses are always merged.

Quiet

Optional

System.Management.Automation.SwitchParameter

The Quiet parameter suppresses feedback during task actions.

TargetOU

Optional

System.String

The TargetOU parameter specifies the organizational unit for group creation. The existence of this parameter implies that new group creation should occur.

If not specified, the cmdlet will not create new groups when one does not already exist.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter.

Detailed Description

The Add-ADGroup cmdlet adds data from the source technology group to Active Directory groups.

To run the Add-ADGroup cmdlet, the account used to run the command requires Read and Write access to Active Directory. In addition, the account you use must be delegated the Account Operator role for applicable Active Directory containers.

For related information, see Mail Migration Prerequisites.

Input Types

Directory.group

Return Types

None

Example

This command adds new groups returned by Get-DominoGroup to the MyOrg organizational unit (OU). It merges membership for the matching existing groups in the forest.

  Copy Code
$a = Get-DominoGroup -GroupType "Distribution"
$a | Add-AdGroup -TargetOU MyOrg -PrimaryDirectory "Merge"