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" |