EmailVerify.NET v3.0 Send comments on this topic.
Verify-EmailAddress
See Also
Reference > Windows PowerShell built-in support > Cmdlet reference > Verify-EmailAddress

Glossary Item Box

The Verify-EmailAddress cmdlet verifies e-mail addresses using various techniques, including syntax verification (according to RFC 2821 and RFC 2822), MX record lookup, disposable address (DEA) validation, SMTP availability check, mailbox existence check and catch-all verification.

 

Syntax

Verify-EmailAddress [-Address] [<string[]>]
 [-Level {Syntax | DomainMX | Disposable | Smtp | Mailbox | CatchAll}]
 [-LocalSenderAddress [<string>]]
 [-LocalHostFqdn [<string>]]
 [-DnsQueryTimeout [<int>]]
 [-MailboxInspectionTimeout [<int>]]
 [-CatchAllValidationTimeout [<int>]]
 [-SmtpConnectionTimeout [<int>]]
 [-LocalSmtpEndPoint [<IPEndPoint>]]
 [<CommonParameters>]

Parameters

 

-Address <string[]>

Specifies one or more e-mail address to verify.
This parameter is required.

-Level <VerificationLevel>

Specifies the desired level of verification to apply.
The following lists the acceptable values for this parameter:

  • Syntax
  • DomainMX
  • Disposable
  • Smtp
  • Mailbox
  • CatchAll

 

The default value for this parameter is Syntax.

For additional info on verification levels please see the Levels of verification section.

-LocalHostFqdn <string>

Specifies the fully qualified domain name (FQDN) of the local host, used to connect to external SMTP servers while validating e-mail addresses.

The default value for this property is the resolved DNS name for the local host.

-LocalSenderAddress <string>

Specifies the local sender e-mail address, used to connect to external SMTP servers while validating e-mail addresses.

The default value for this property is postmaster@host, where host is the value retrieved from LocalHostFqdn.

-LocalSmtpEndPoint <IPEndPoint>

Specifies the local SMTP endpoint, used to connect to external SMTP servers while validating e-mail addresses.

Default is an endpoint which listens on all available network interfaces.

-DnsQueryTimeout <int>

Specifies the timeout, in seconds, for the query to the DNS server to complete. Queries lasting more than this timeout will be automatically aborted and yeld to the failure of the verification.

Default is 10 seconds.

-SmtpConnectionTimeout <int>

Specifies the timeout, in seconds, for the SMTP server to accepts a connection. Connection attempts lasting more than this timeout will be automatically aborted and yeld to the failure of the verification.

Default is 10 seconds.

-MailboxInspectionTimeout <int>

Specifies the the timeout, in seconds, for the inspection of the mailbox to complete. Inspections lasting more than this timeout will be automatically aborted and yeld to the failure of the verification.

Default is 60 seconds (1 minute).

-CatchAllValidationTimeout <int>

Specifies the the timeout, in seconds, for the verification against non existent address being accepted by the mail server to complete. Verification lasting more than this timeout will be automatically aborted and yeld to the failure of the verification.

Default is 10 seconds.

 

Output

 

This cmdlet outputs a VerificationStatus object, which can be used to inspect the details of the verification result.

See Also