Import-DOMForwardingRules

SYNOPSIS

Imports forwarding rules into a Domino tenant.

DESCRIPTION

Use the Import-DOMForwardingRules agent to import forwarding rules into a Domino tenant.

Note that this agent adds a forwarding rules to mailboxes, so email is delivered to the user’s mailbox.

See the Notes section for agent requirements.

EXAMPLES

Example 1: Import from local TMCTools.nsf

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
   • IMPORT_FILE=C:\ProgramData\Transend\tools\forwarding_addresses.csv
3. Run Actions -> Import-DOMForwardingRules from TMCTools.nsf

Example 2: Import from 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-DOMForwardingRules 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

DISABLE_EXISTING_RULES

By default, existing rules are not modified, which could interfere with processing the forwarding rule added by this agent. Use DISABLE_EXISTING_RULES=True to disable all existing rules.

Type: String
Accepted values: False, True

Required: True
Default value: False

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