PowerShell PKI Module Documentation

This command requires installed Remote Server Administration Tools (RSAT)

Ping-ICertInterface

Synopsis

Tests management and enrollment interface availability of the specified CA server.

Syntax

Ping-ICertInterface [-CertificationAuthority] <CertificateAuthority[]> [<CommonParameters>]

Description

Tests management and enrollment interface availability of the specified CA server. The command attempts to make calls to server's ICertAdmin and ICertRequest interfaces. ICertAdmin interface is used for CA server management purposes and may not available on client operating systems. ICertRequest is used during certificate enrollment process.

Parameters

-CertificationAuthority <CertificateAuthority[]>

Specifies the Certification Authority object to check. This object can be retrieved by running Get-CertificationAuthority and Connect-CertificationAuthority commands.

Required?	True
Position?	0
Default value
Accept pipeline input?	true (ByValue, ByPropertyName)
Accept wildcard characters?	False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, InformationAction, InformationVariable,
WarningAction, WarningVariable, OutBuffer, PipelineVariable and OutVariable.
For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Inputs

PKI.CertificateServices.CertificateAuthority[]

Outputs

PSObject

Notes

Examples

Example 1

PS C:\> Get-CertificationAuthority | Ping-ICertInterface

This command retrieves all Enterprise CAs and checks ICertAdmin and ICertRequest interface availability.

Minimum PowerShell version support

Windows PowerShell 3.0

Operating System Support

Windows 7
Windows 8
Windows 8.1
Windows 10
Windows 11
Windows Server 2008 R2 all editions
Windows Server 2012 all editions
Windows Server 2012 R2 all editions
Windows Server 2016 all editions
Windows Server 2019 all editions
Windows Server 2022 all editions