Public/Connectors/Test-SIAConnector.ps1

function Test-SIAConnector {
    <#
    .SYNOPSIS
        Tests reachability of a SIA connector.
    .DESCRIPTION
        Calls the connector reachability check operation. This is a read-only
        diagnostic call; it does not change connector state.
    .PARAMETER Id
        The connector's id, as returned by Get-SIAConnector.
    .EXAMPLE
        Get-SIAConnector | Test-SIAConnector

        Tests reachability for every connector on the tenant.
    .INPUTS
        psSIA.Connector
    .OUTPUTS
        psSIA.ConnectorReachability
    .LINK
        https://api-docs.cyberark.com/secure-infra-access/docs/sia-connector-api
    #>

    [CmdletBinding()]
    [OutputType('psSIA.ConnectorReachability')]
    param(
        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]
        [string]$Id
    )

    process {
        Invoke-SIARequest -Method POST -Path "/api/connectors/$Id/reachability" |
            ConvertFrom-SIAResponse -TypeName 'psSIA.ConnectorReachability'
    }
}