Click or drag to resize

Test-DtEmailNotification

Tests the e-mail options configured with Set-DtEmailNotificationOptions by attempting to send an e-mail to the specified recipient. For this cmdlet, the -ServiceHost could be your source or target server.

Syntax

Test-DtEmailNotification [-Options] <EmailNotificationOptions> [-To] <String> [-Body] <String> [-ServiceHost] <Server> [<CommonParameters>]

Parameters
-Options<EmailNotificationOptions>

Specify the object returned from the Get-DtEmailNotificationOptions cmdlet.

Required?

true

Position?

2

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-To<String>

Specify the e-mail address that the test Double-Take e-mail message should be sent to. Multiple addresses can be separated by a comma.

Required?

true

Position?

3

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Body<String>

Specify the text of the test Double-Take email message.

Required?

true

Position?

4

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ServiceHost<Server>

Specify the server object returned from the New-DtServer cmdlet.

Required?

true

Position?

1

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

Examples

------------------EXAMPLE------------------

A server object is created for the server alpha using the domain\administrator and password credentials. It assigns the server object to the variable called DtServerObjectAlpha. Then the default Double-Take e-mail notification options are stored in the variable DtEmailOptions. Two of the options are then changed. The Enabled option is set to true which turns on the e-mail notification feature. The SMTP server is also configured for mail.company.com. Those changes for the email notification options are set on the server. Finally a test message is sent to the administrator@mail.company.com addresses with the specified message text using the configured e-mail notification options. The connections for the server object are then closed.

$DtServerObjectAlpha= New-DtServer -Name alpha -UserName domain\administrator -Password password

$DtEmailOptions = Get-DtEmailNotificationOptions -ServiceHost $DtServerObject

$DtEmailOptions.Enabled = $true

$DtEmailOptions.SmtpServer = "mail.company.com"

Set-DtEmailNotificationOptions -ServiceHost $DtServerObjectAlpha -Options $DtEmailOptions

Test-DtEmailNotification -ServiceHost $DtServerObjectAlpha -Options $DtEmailOptions -To "administrator@mail.company.com" -Body "This is a test Double-Take message."

Disconnect-DtServer -ServiceHost $DtServerObjectAlpha