Use the Get-DominoUser cmdlet to retrieve information from Domino Directory Person documents and to match Domino users to Active Directory directory service accounts.

Get-DominoUser [-SourceIdentity <String>] [-DomainController <String>] [-DominoDirectoryDatabase <String>] [-DominoDirectoryServer <String>] [-DominoOU <String>] [-MatchToTarget <SwitchParameter>] [-MaxThreadCount <UInt32>] [-NotesIniPath <String>] [-SourceCredential <PSCredential>] [-SourceDetail <String>] [-SourceMapping <String>]
Get-DominoUser [-DomainController <String>] [-DominoOU <String>] [-MatchToTarget <SwitchParameter>] [-MaxThreadCount <UInt32>] [-SourceCredential <PSCredential>] [-SourceDetail <String>] [-SourceMapping <String>]

Parameters

Parameter Required Type Description

DomainController

Optional

System.String

Active Directory domain controller.

DominoDirectoryDatabase

Optional

System.String

Domino Directory file name (Typically names.nsf).

DominoDirectoryServer

Optional

System.String

Lotus Domino server hosting Directory that will be used in this process.

DominoOU

Optional

System.String

Filter to retrieve users in a given Domino organizational unit (OU).

MatchToTarget

Optional

System.Management.Automation.SwitchParameter

Attempts to associate users with existing Active Directory accounts.

MaxThreadCount

Optional

System.UInt32

Maximum number of threads allocated to this task.

NotesIniPath

Optional

System.String

Path to local Notes.ini file including filename.

SourceCredential

Optional

System.Management.Automation.PSCredential

PSH credential object consisting of Notes ID file and password.

SourceDetail

Optional

System.String

Level of detail:

Lite

or

Xtra

or

Full.

SourceIdentity

Optional

System.String

Extracts a single user from the Domino Directory by referencing GUID, hierarchical, or canonical name.

SourceMapping

Optional

System.String

The SourceMapping parameter specifies a custom mapfile that defines how the attributes in the object schema will be mapped from the source schema.

Detailed Description

The Get-DominoUser cmdlet returns details from a user(s) Domino Directory Person document. This cmdlet can also be used to match Domino users with existing Active Directory accounts.

To run the Get-DominoUser cmdlet, the Notes ID file on the local workstation must have Reader or higher access control list (ACL) access to the Domino Directory. To perform user matching, this cmdlet requires Read access to Active Directory.

For related information, see User Migration Prerequisites.

To run the Get-DominoUser cmdlet, the account you use must be delegated the following:

  • Exchange Recipient Administrator role

  • Account Operator role for applicable Active Directory containers

Input Types

None.

Return Types

MigrationUserItem.

Example

The following code example returns a list of the Domino users in the Boston organizational unit (OU) listed in the Domino Directory.

  Copy Code
Get-DominoUser -DominoOU Boston