Domain Detective

API Reference

Class

CmdletImportTlsRptReportSnapshot

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

Imports TLS-RPT JSON reports into a time-series store.

Inheritance

  • PSCmdlet
  • CmdletImportTlsRptReportSnapshot

Examples

Ingest TLS-RPT reports from a folder


Import-DDTlsRptReportSnapshot -DomainName example.com -Path .\TlsRpt -StorePath .\Store
        

Ingest TLS-RPT report attachments from IMAP


Import-DDTlsRptReportSnapshot -DomainName example.com -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 DomainName { get; set; } #
Parameter(Mandatory = true) ValidateNotNullOrEmpty ValidateDomainName

Domain these TLS-RPT reports belong to (policy domain).

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" }}