Domain Detective

API Reference

Class

CmdletGetCertificateInventoryCtDiagnostics

Namespace DomainDetective.PowerShell
Assembly DomainDetective.PowerShell
Base PSCmdlet
Modifiers sealed
Attributes
Cmdlet("Get", "DDCertificateInventoryCtDiagnostics") OutputType([typeof(CertificateInventoryNativeCtDiagnosticsResult)])

Queries persisted native CT ingestion diagnostics captured with certificate inventory snapshots.

Inheritance

  • PSCmdlet
  • CmdletGetCertificateInventoryCtDiagnostics

Examples

Query failed native CT diagnostics from the last 7 days


Get-DDCertificateInventoryCtDiagnostics -SinceUtc (Get-Date).ToUniversalTime().AddDays(-7) -State Failed
        

Find circuit-open native CT diagnostics with high lag


Get-DDCertificateInventoryCtDiagnostics -State CircuitOpen -LagAfterMin 10000
        

Enforce alert thresholds and fail when breached


Get-DDCertificateInventoryCtDiagnostics -LatestOnly -MaxFailed 0 -MaxCircuitOpen 0 -MaxLagAfter 5000 -FailOnThresholdBreach
        

Constructors

public CmdletGetCertificateInventoryCtDiagnostics() #

Methods

ProcessRecord() #

Executes the cmdlet.

Properties

public String CacheDirectory { get; set; } #
Parameter(Mandatory = false)

Certificate monitor cache directory containing the inventory folder.

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

Only include snapshots captured since this UTC date/time.

public Nullable<DateTime> UntilUtc { get; set; } #
Parameter(Mandatory = false)

Only include snapshots captured up to this UTC date/time.

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

Only evaluate the latest snapshot after date filtering.

public String[] State { get; set; } #
Parameter(Mandatory = false) ValidateSet(["Succeeded", "Failed", "CircuitOpen", "Unknown"])

Optional state filter(s): Succeeded, Failed, CircuitOpen, Unknown.

public String LogUrlContains { get; set; } #
Parameter(Mandatory = false)

Optional contains filter applied to CT log URL.

public String ScopeContains { get; set; } #
Parameter(Mandatory = false)

Optional contains filter applied to diagnostic scope.

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

Only return diagnostics currently marked as circuit open.

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

Only return diagnostics that include failure messages.

public Nullable<Int64> LagBeforeMin { get; set; } #
Parameter(Mandatory = false)

Optional minimum LagBefore value.

public Nullable<Int64> LagBeforeMax { get; set; } #
Parameter(Mandatory = false)

Optional maximum LagBefore value.

public Nullable<Int64> LagAfterMin { get; set; } #
Parameter(Mandatory = false)

Optional minimum LagAfter value.

public Nullable<Int64> LagAfterMax { get; set; } #
Parameter(Mandatory = false)

Optional maximum LagAfter value.

public Int32 MaxResults { get; set; } #
Parameter(Mandatory = false) ValidateRange(0, 2147483647)

Maximum number of entries returned.

public Nullable<Int32> MaxFailed { get; set; } #
Parameter(Mandatory = false) ValidateRange(0, 2147483647)

Alert threshold: maximum allowed diagnostics in Failed state.

public Nullable<Int32> MaxCircuitOpen { get; set; } #
Parameter(Mandatory = false) ValidateRange(0, 2147483647)

Alert threshold: maximum allowed diagnostics in CircuitOpen state.

public Nullable<Int64> MaxLagAfter { get; set; } #
Parameter(Mandatory = false) ValidateRange(0, 9223372036854775807)

Alert threshold: maximum allowed LagAfter value across matched diagnostics.

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

When set, the cmdlet throws a terminating error if any configured threshold is breached.

{{ include "footer" }}