TestimoX

API Reference

Command

Test-ADXEntraConnect

Namespace ADPlayground.PowerShell
Inputs
System.String[]
Outputs
ADPlayground.Monitoring.Probes.ProbeResult

Tests Microsoft Entra Connect Sync service and event telemetry.

Examples

Authored help example

Example 1: Check an Entra Connect Sync server without starting the monitoring service


Test-ADXEntraConnect -ComputerName 'sync01.contoso.com'

Example 2: Check event-only Entra Connect telemetry


Test-ADXEntraConnect -ComputerName 'sync01.contoso.com' -SkipService -FailureEventId 650,680

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.

Syntax

Test-ADXEntraConnect -ComputerName <string[]> [-AllowedRecentErrorEvents <int>] [-AllowedRecentWarningEvents <int>] [-EventLogChannel <string[]>] [-EventLookbackHours <int>] [-EventProviderName <string[]>] [-FailureEventId <int[]>] [-FailureLookbackHours <int>] [-IgnoreWarnings] [-IncludeChildResults] [-MaxConcurrency <int>] [-Name <string>] [-QueryTimeoutSeconds <int>] [-ServiceName <string[]>] [-SkipService] [-StaleSuccessCriticalHours <int>] [-StaleSuccessWarningHours <int>] [-SuccessEventId <int[]>] [-TimeoutSeconds <int>] [<CommonParameters>]
#

Parameters

ComputerName string[] requiredposition: 0pipeline: true (ByValue, ByPropertyName)
Microsoft Entra Connect Sync servers to test.
AllowedRecentErrorEvents int optionalposition: namedpipeline: false
Recent Entra Connect error events tolerated before the result changes state.
AllowedRecentWarningEvents int optionalposition: namedpipeline: false
Recent Entra Connect warning events tolerated before the result changes state.
EventLogChannel string[] optionalposition: namedpipeline: false
Event log channels to query for Entra Connect telemetry.
EventLookbackHours int optionalposition: namedpipeline: false
Event lookback window in hours.
EventProviderName string[] optionalposition: namedpipeline: false
Event provider/source names to query.
FailureEventId int[] optionalposition: namedpipeline: false
Event IDs treated as failures. Empty means warning/error levels are used.
FailureLookbackHours int optionalposition: namedpipeline: false
Failure lookback window in hours.
IgnoreWarnings SwitchParameter optionalposition: namedpipeline: false
Does not degrade the result for warning-level Entra Connect events.
IncludeChildResults SwitchParameter optionalposition: namedpipeline: false
Writes child per-server results when a multi-target aggregate is returned.
MaxConcurrency int optionalposition: namedpipeline: false
Maximum concurrent server checks.
Name string optionalposition: namedpipeline: false
Probe name written to the result object.
QueryTimeoutSeconds int optionalposition: namedpipeline: false
Timeout in seconds for each WMI and event-log query.
ServiceName string[] optionalposition: namedpipeline: false
Windows service names that must exist and run.
SkipService SwitchParameter optionalposition: namedpipeline: false
Skips service checks and evaluates only event telemetry.
StaleSuccessCriticalHours int optionalposition: namedpipeline: false
Success evidence age in hours that marks the result down. Zero disables stale-success critical status.
StaleSuccessWarningHours int optionalposition: namedpipeline: false
Success evidence age in hours that marks the result degraded. Zero disables stale-success warning.
SuccessEventId int[] optionalposition: namedpipeline: false
Event IDs treated as successful sync evidence.
TimeoutSeconds int optionalposition: namedpipeline: false
Overall per-target timeout in seconds.

Outputs

ADPlayground.Monitoring.Probes.ProbeResult