Webinar: PKI Insights - Energy Utility PKI Cybersecurity in Critical Infrastructure (CIP) Environments by PKI Solutions

PowerShell PKI Module Documentation

Documentation Home
This command is not available in non-domain environments
This command requires installed Remote Server Administration Tools (RSAT)

Get-CertificationAuthority

Synopsis

Retrieves all Enterprise Certification Authorities from a current Active Directory forest.

Syntax

Get-CertificationAuthority [[-ComputerName] <String>] [-Enterprise] [-Standalone] [<CommonParameters>]

Get-CertificationAuthority [[-Name] <String>] [-Enterprise] [-Standalone] [<CommonParameters>]

Description

Retrieves all Enterprise Certification Authorities from a current Active Directory forest.

Parameters

-ComputerName <String>

Specifies Certification Authority computer name. (default)

This parameter accepts the following wildcard characters:
? – for single wildcard character matching
* – for multiple wildcard character matching

Required? False
Position? 0
Default value *
Accept pipeline input? false
Accept wildcard characters? False

-Name <String>

Specifies the particular Certification Authority display name.

This parameter accepts the following wildcard characters:
? – for single wildcard character matching
* – for multiple wildcard character matching.

Required? False
Position? 0
Default value *
Accept pipeline input? false
Accept wildcard characters? False

-Enterprise <SwitchParameter>

Retrieves only Enterprise Certification Authorities.

Required? False
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? False

-Standalone <SwitchParameter>

Retrieves only Standalone Certification Authorities.

Required? False
Position? named
Default value
Accept pipeline input? false
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

None.

Outputs

PKI.CertificateServices.CertificateAuthority[]

Notes

Examples

Example 1

PS C:\> Get-CertificationAuthority

Returns all Enterprise Certification Authorities objects in current forest.

Example 2

PS C:\> Get-CertificationAuthority -Name "RootCa"

Returns specified Certification Authority object.

Example 3

PS C:\> Get-CertificationAuthority "ca01*"

Retrieves all Enterprise Certification Authorities which server name starts with 'ca01'. Wildcards are useful when your infrastructure uses complex naming convention. You can put wildcards at any point in the string.

Example 4

PS C:\> Get-CertificationAuthority -Standalone

Retrieves all Active Directory domain-joined Standalone Certification Authorities.

Related links

Connect-CertificationAuthority

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