Use the Move-DominoGroup cmdlet to associate Domino groups with existing Active Directory directory service groups, if they exist, and then migrate the membership of the Domino groups to Active Directory groups. If no group exists in Active Directory, one will be created.

Move-DominoGroup [-Confirm [<SwitchParameter>]] [-GlobalCatalog <String>] [-PrimaryDirectory <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-TargetOU <String>] [-TransporterObject <IAlienDataObject>] [-WhatIf [<SwitchParameter>]]
Move-DominoGroup [-SourceIdentity <String>] [-Confirm [<SwitchParameter>]] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-GlobalCatalog <String>] [-GroupType <String>] [-NotesIniPath <String>] [-PrimaryDirectory <String>] [-Quiet <SwitchParameter>] [-SourceCredential <PSCredential>] [-TargetOU <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm parameter causes the command to pause processing and requires the administrator to acknowledge what the command will do before processing continues.

DomainController

Optional

System.String

The DomainController parameter specifies the domain controller and global catalog to connect to. If not specified, a domain controller and global catalog referral is made.

DominoDirectoryDatabase

Optional

System.String

The DominoDirectoryDatabase parameter specifies the name of the database from which directory information should be extracted.

The default behavior is names.nsf.

DominoDirectoryServer

Optional

System.String

The DominoDirectoryServer parameter specifies the name of the Domino server hosting the directory that the task will be connecting to. The name should be in one of the following formats:

  • IP Address

  • Host name (NetBIOS)

  • Domino Hierarchical name, for example, DF-Redbull-01/Microsoft

Note: FQDN will not be supported because the Notes API will not handle it.

The default behavior is to read the home server name from notes.ini.

GlobalCatalog

Optional

System.String

The GlobalCatalog parameter identifies the Active Directory server.

GroupType

Optional

System.String

The GroupType parameter specifies the type of group that should be extracted from Domino.  Choices are ALL, DISTRIBUTION, HYBRID, and SECURITY.

The default behavior is ALL.

NotesIniPath

Optional

System.String

The NotesIniPath parameter specifies the path to the Notes client’s ini file. If this is left blank, the notes.ini that is in the install directory is specified.

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 does. "Merge" adds all of the source list members to the target list membership.  Note:  This parameter should always merge proxy addresses.

The default behavior is Target.

Quiet

Optional

System.Management.Automation.SwitchParameter

The Quiet parameter suppresses feedback during task actions.

SourceCredential

Optional

System.Management.Automation.PSCredential

The SourceCredential parameter specifies the credential to use for authentication to the source platform.

The parameter reads the name of the ID file from the notes.ini and checks if a PS credential of that name is stored in the engine.

SourceIdentity

Optional

System.String

The SourceIdentity parameter specifies the name of the object to be acted upon. For Domino directory objects, the name should be one of the following formats:

  • GUID

  • Hierarchical name

  • Canonical name

  • SMTP address

If no identity is specified, all of the objects of the type specified in the task on the specified server are extracted.

TargetOU

Optional

System.String

The TargetOU parameter specifies the organizational unit (OU) for user creation. The existence of this parameter implies that new user creation should occur.

If not specified, new objects are not created for groups that do not have matches.

TransporterObject

Optional

Microsoft.Exchange.Transporter.IAlienDataObject

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

Note:
There is no support for "/" in the Organizational Unit (OU) name.

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, the administrator can view what changes would occur without having to apply any of those changes.

Detailed Description

The Move-DominoGroup cmdlet associates the Domino group's membership with an existing Active Directory group; if one does not exist, it will be created. Then the cmdlet migrates the membership of the Domino group to the Active Directory group.

To run the Move-DominoGroup cmdlet, you must have Recipient Admin and Account operator on the Microsoft Exchange Server 2007 server. The Notes ID file on the local workstation must have Reader or higher access control list (ACL) access to the Domino Directory.

For related information, see Mail Migration Prerequisites.

Example

This example extracts all of the multi-purpose groups from Domino and then creates new groups in the "Migrated Groups" OU.

  Copy Code
Move-DominoGroup -GroupType hybrid -TargetOU "contoso\Migrated Groups