Logo

Documentation home for Transend tools

Export-DOMUsers

SYNOPSIS

Exports users from a Domino tenant.

DESCRIPTION

Use the Export-DOMUsers agent to export users from a Domino tenant.

See the Notes section for agent requirements.

EXAMPLES

Example 1: Export from local TMCTools.nsf and map data for Google Workspace

  1. Copy Person docs from Domino Directory and paste into TMCTools.nsf

  2. Set the following parameters in config.ini:
    • LICENSE=xxxxxxxxxxxxxxxxxxxxxxxx
    • SERVER=Local
    • DATABASE=TMCTools.nsf
    • INTERNAL_NOTES_ORGANIZATIONS=Example,Sample
    • INTERNAL_SMTP_DOMAINS=example.org,sample.org
    • TARGET=Google
  3. Run Actions -> Export-DOMUsers from TMCTools.nsf

Example 2: Export from server names.nsf and map data for Microsoft 365

  1. Set the following parameters in config.ini:
    • LICENSE=xxxxxxxxxxxxxxxxxxxxxxxx
    • SERVER=Domino/Example
    • DATABASE=names.nsf
    • INTERNAL_NOTES_ORGANIZATIONS=Example,Sample
    • INTERNAL_SMTP_DOMAINS=example.org,sample.org
    • TARGET=M365
  2. Run Actions -> Export-DOMUsers from TMCTools.nsf

Example 3: Export from local TMCTools.nsf and map data for TMC

  1. Copy Person docs from Domino Directory and paste into TMCTools.nsf

  2. Set the following parameters in config.ini:
    • LICENSE=xxxxxxxxxxxxxxxxxxxxxxxx
    • SERVER=Local
    • DATABASE=TMCTools.nsf
    • INTERNAL_NOTES_ORGANIZATIONS=Example,Sample
    • INTERNAL_SMTP_DOMAINS=example.org,sample.org
    • TARGET=TMC
  3. Run Actions -> Export-DOMUsers from TMCTools.nsf

PARAMETERS

DATABASE

The database from which Person docs will be retrieved.

Type: String
Accepted values: TMCTools.nsf, names.nsf, pubnames.nsf

Required: True
Default value: None

INTERNAL_NOTES_ORGANIZATIONS

A comma-separated list of Notes organizations considered internal to the current environment.

Note that you must omit the leading slash character. For example, use Example,Sample instead of /Example,/Sample.

Type: String

Required: True
Default value: None

INTERNAL_SMTP_DOMAINS

A comma-separated list of SMTP domains considered internal to the current environment.

LICENSE

Your TMCTools license key.

Type: String

Required: True
Default value: None

SERVER

The location of the database specified in the DATABASE parameter.

For a server location, use the server’s hierarchical name. For example, Domino/Example.

For a local location, use Local.

Type: String

Required: True
Default value: None

SOURCE_USERNAME

By default, exported source identifiers come from the objects being exported. When TARGET is set to TMC, you may instead prefer to have a single admin account listed as the source identifier. In those cases, set SOURCE_USERNAME to the canonical name of the account that will be used to access the corresponding mail file.

Type: String

Required: True
Default value: None

TARGET

Specifies a mapping target for the exported data. Exported data mapped for a supported target is directly consumable by a corresponding import cmdlet or by TMC.

Type: String
Accepted values: Google, M365, TMC

Required: True
Default value: None

INPUTS

None

OUTPUTS

CSV

NOTES

  • Output is written to users.csv in the invocation directory in C:\ProgramData\Transend\tools\logs.

  • Review warnings.log for non-fatal problems that may impact the data.

TMCTools configuration options