Domain Detective

API Reference

Class

CmdletGetCertificateInventoryCtHealth

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

Builds CT diagnostics health timeline from persisted certificate inventory snapshots.

Inheritance

  • PSCmdlet
  • CmdletGetCertificateInventoryCtHealth

Examples

Get CT health for the last 30 days


Get-DDCertificateInventoryCtHealth -SinceUtc (Get-Date).ToUniversalTime().AddDays(-30) -MaxSnapshots 60
        

Apply thresholds and fail when latest snapshot is breached


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

Fail when any returned snapshot is breached


Get-DDCertificateInventoryCtHealth -SinceUtc (Get-Date).ToUniversalTime().AddDays(-7) -FailOnAnyBreach -MaxFailed 0 -FailOnThresholdBreach
        

Constructors

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 Int32 MaxSnapshots { get; set; } #
Parameter(Mandatory = false) ValidateRange(0, 2147483647)

Maximum timeline rows 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 diagnostics.

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

When set, fail if any returned snapshot breaches thresholds (otherwise latest snapshot only).

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

When set, throw a terminating error when threshold breach condition is met.

{{ include "footer" }}