Domain Detective

API Reference

Class

CmdletTestEmailAddress

Namespace DomainDetective.PowerShell
Assembly DomainDetective.PowerShell
Implements
IDisposable
Modifiers sealed
Attributes
Cmdlet("Test", "DDEmailAddress") Alias(["Test-EmailAddress"])

Validates an email address using syntax, DNS, and optional SMTP checks.

Inheritance

Examples

Validate an email address using DNS checks.


Test-DDEmailAddress -EmailAddress [email protected]
        

Include SMTP probing and catch-all detection.


Test-DDEmailAddress -EmailAddress [email protected] -SmtpProbe -CheckCatchAll
        

Use provider web checks for Proton with authenticated session values.


Test-DDEmailAddress -EmailAddress [email protected] -SmtpProbe -EnableProviderWebChecks -ProtonAuthCookie "AUTH-<uid>=<value>" -ProtonUid "<uid>"
        

Constructors

Methods

BeginProcessingAsync() #

Initializes logging and helper classes.

Returns

A Task representing the asynchronous operation.

ProcessRecordAsync() #

Executes the cmdlet operation.

Returns

A Task representing the asynchronous operation.

Fields

public String EmailAddress #
Parameter(Mandatory = true, Position = 0) ValidateNotNullOrEmpty

Email address to validate.

public DnsEndpoint DnsEndpoint #
Parameter(Mandatory = false, Position = 1)

DNS server used for queries.

public SwitchParameter AllowInternational #
Parameter(Mandatory = false)

Allow international characters in local parts.

public SwitchParameter AllowTopLevelDomains #
Parameter(Mandatory = false)

Allow top-level-only domains.

public SwitchParameter SmtpProbe #
Parameter(Mandatory = false)

Enable SMTP probe for deliverability.

public SwitchParameter CheckCatchAll #
Parameter(Mandatory = false)

Enable catch-all detection when SMTP probing.

public Int32 SmtpPort #
Parameter(Mandatory = false)

SMTP port for probing.

public Int32 SmtpTimeoutSeconds #
Parameter(Mandatory = false)

SMTP timeout in seconds.

public SwitchParameter AllowInvalidSmtpCertificates #
Parameter(Mandatory = false)

Allow invalid SMTP TLS certificates when STARTTLS is used.

public Int32 SmtpProbeDelaySeconds #
Parameter(Mandatory = false)

Delay between SMTP probe attempts in seconds.

public Int32 SmtpMaxHosts #
Parameter(Mandatory = false)

Max SMTP hosts to try.

public Int32 SmtpRetryCount #
Parameter(Mandatory = false)

SMTP retries on temporary failures.

public Int32 SmtpRetryDelaySeconds #
Parameter(Mandatory = false)

SMTP retry delay in seconds.

public String SmtpHelloName #
Parameter(Mandatory = false)

EHLO/HELO name to present.

public String SmtpFromAddress #
Parameter(Mandatory = false)

MAIL FROM address to use.

public String SmtpProxyHost #
Parameter(Mandatory = false)

SMTP proxy host (SOCKS5).

public Int32 SmtpProxyPort #
Parameter(Mandatory = false)

SMTP proxy port (SOCKS5).

public String SmtpProxyUsername #
Parameter(Mandatory = false)

SMTP proxy username (SOCKS5).

public String SmtpProxyPassword #
Parameter(Mandatory = false)

SMTP proxy password (SOCKS5).

public SwitchParameter CheckGravatar #
Parameter(Mandatory = false)

Check for an existing Gravatar image.

public SwitchParameter DisableProviderRules #
Parameter(Mandatory = false)

Disable provider-specific SMTP rules.

public SwitchParameter CheckHaveIBeenPwned #
Parameter(Mandatory = false)

Check Have I Been Pwned breach status.

public String HaveIBeenPwnedApiKey #
Parameter(Mandatory = false)

Have I Been Pwned API key.

public String DisposableDomainsPath #
Parameter(Mandatory = false)

Override disposable domain list path.

public String RoleAccountsPath #
Parameter(Mandatory = false)

Override role account list path.

public String FreeProvidersPath #
Parameter(Mandatory = false)

Override free provider list path.

public String B2CProvidersPath #
Parameter(Mandatory = false)

Override B2C provider list path.

public SwitchParameter DisableFreeProvidersAsB2C #
Parameter(Mandatory = false)

Do not treat free providers as B2C.

public String SmtpRulesPath #
Parameter(Mandatory = false)

SMTP rules JSON path.

public SwitchParameter DisableBuiltinSmtpRules #
Parameter(Mandatory = false)

Disable built-in SMTP rules.

public SwitchParameter AllowB2CCatchAll #
Parameter(Mandatory = false)

Allow catch-all probing for B2C providers.

public SwitchParameter EnableProviderWebChecks #
Parameter(Mandatory = false)

Enable provider web checks when available.

public String ProtonAuthCookie #
Parameter(Mandatory = false)

Proton AUTH cookie value (AUTH-<uid> or raw value).

public String ProtonUid #
Parameter(Mandatory = false)

Proton uid value used for x-pm-uid.

{{ include "footer" }}