Import-DOMForwardingAddresses

SYNOPSIS

Imports forwarding addresses into a Domino tenant.

DESCRIPTION

Use the Import-DOMForwardingAddresses agent to import forwarding addresses into a Domino tenant.

Note that this agent adds a forwarding address to Person docs, so email is not delivered to the user’s mailbox.

See the Notes section for agent requirements.

EXAMPLES

Example 1: Import into server names.nsf

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
   • IMPORT_FILE=C:\ProgramData\Transend\tools\forwarding_addresses.csv
2. Run Actions -> Import-DOMForwardingAddresses 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

IMPORT_FILE

Specifies the path to a file containing Identity;ForwardingAddress mappings.

Type: String
Accepted values: Google, M365

Required: True
Default value: None

INPUTS

None

OUTPUTS

CSV

NOTES

• The input file header must be Identity;ForwardingAddress.

• The Identity field can be any of the following:
  • Canonical name (CN=Jane Doe/O=Example)
  • Abbreviated name (Jane Doe/Example)
  • Email address (jdoe@example.org)
  • Display name (Jane Doe)
• Review warnings.log for non-fatal problems that may impact the data.

RELATED LINKS

TMCTools configuration options