Domain Detective

API Reference

Class

CmdletImportDmarcAggregateSnapshot

Namespace DomainDetective.PowerShell
Assembly DomainDetective.PowerShell
Base PSCmdlet
Modifiers sealed
Attributes
Cmdlet("Import", "DDDmarcAggregateSnapshot", DefaultParameterSetName = "Path") Alias(["Import-DmarcAggregateSnapshot"]) OutputType([typeof(DmarcAggregateSnapshot)])

Imports DMARC aggregate reports into a time-series store.

Inheritance

  • PSCmdlet
  • CmdletImportDmarcAggregateSnapshot

Examples

Ingest DMARC aggregate reports from a folder


Import-DDDmarcAggregateSnapshot -Path .\Reports -StorePath .\Store
        

Ingest DMARC aggregate report attachments from IMAP


Import-DDDmarcAggregateSnapshot -StorePath .\Store -ImapHost imap.example.com -Credential (Get-Credential) -Mailbox INBOX -SinceUtc (Get-Date).ToUniversalTime().AddDays(-7)
        

Constructors

Methods

ProcessRecord() #

Executes the cmdlet.

Properties

public String Path { get; set; } #
Parameter(Mandatory = true, ParameterSetName = "Path", Position = 0, ValueFromPipeline = true, ValueFromPipelineByPropertyName = true) ValidateNotNullOrEmpty

Path to a report file/folder/wildcard.

public String StorePath { get; set; } #
Parameter(Mandatory = true) ValidateNotNullOrEmpty

Root directory for snapshot storage.

public String ImapHost { get; set; } #
Parameter(Mandatory = true, ParameterSetName = "Imap") ValidateNotNullOrEmpty

IMAP host used for mailbox ingestion.

public Int32 ImapPort { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

IMAP port (default 993).

public Boolean ImapUseSsl { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Use SSL/TLS for IMAP connection (default true).

public PSCredential Credential { get; set; } #
Parameter(Mandatory = true, ParameterSetName = "Imap")

Credential for IMAP authentication.

public String Mailbox { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Mailbox folder name (default INBOX).

public String SubjectContains { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Only scan messages with a subject containing this string.

public Nullable<DateTime> SinceUtc { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Only fetch messages delivered since this UTC date/time.

public Int32 MaxMessages { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Maximum number of messages to scan (default 500).

public Int32 MaxAttachmentMb { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Maximum attachment size to decode in MB (0 for unlimited).

public Boolean OnlyUnseen { get; set; } #
Parameter(Mandatory = false, ParameterSetName = "Imap")

Only consider unseen messages (default true).

public SwitchParameter NoDeduplicate { get; set; } #
Parameter(Mandatory = false)

Disable in-run deduplication (by report-id/date-range/org/domain).

public SwitchParameter AsResult { get; set; } #
Parameter(Mandatory = false)

Return the ingest result wrapper instead of snapshots.

{{ include "footer" }}