Remove-CAAuthorityInformationAccess

Remove-CAAuthorityInformationAccess

Removes authority information access (AIA) or Online Certificate Status Protocol (OCSP) URI from the AIA extension set on the certification authority.

Syntax

Parameter Set: RemoveAsAIA
Remove-CAAuthorityInformationAccess [-Uri] <String> [-AddToCertificateAia] [-Force] [ <CommonParameters>]

Parameter Set: RemoveAsOCSP
Remove-CAAuthorityInformationAccess [-Uri] <String> [-AddToCertificateOcsp] [-Force] [ <CommonParameters>]

Detailed Description

The Remove-CAAuthorityInformationAccess cmdlet removes the Authority Information Access (AIA) or Online Certificate Status Protocol (OCSP) URI from the AIA extension set on the certification authority.

Parameters

-AddToCertificateAia

This switch indicates the Authority Information Access (AIA) uniform resource information (URI).

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-AddToCertificateOcsp

This switch indicates an Online Responder's uniform resource information (URI).

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Force

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Uri<String>

Specifies the uniform resource identifier (URI) from where the certificate for the certification authority (CA) can be downloaded or the online responder information can be obtained. This information is added to the CA properties and registry.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

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

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.String

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.CertificateServices.Administration.Commands.CA.AuthorityInformationAccessResult

Notes

  • You must be a member of Enterprise Admins group to successfully run this command.

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

-----------

Removes Authority Information Access (AIA) for the specified uniform resource identifier (URI) of 'https://www.contoso.com/pki/orca1.crt'.

C:\PS>Remove-CAAuthorityInformationAccess -uri "https://www.contoso.com/pki/orca1.crt" -AddToCertificateAIA

-------------------------- EXAMPLE 2 --------------------------

Description

-----------

Removes the Online Certificate Status Protocol (OCSP) for the specified uniform resource identifier (URI) of 'http://www.cpandl.com/ocsp'.

C:\PS>Remove-CAAuthorityInformationAccess -uri "http://www.cpandl.com/ocsp/" -AddToCertificateOCSP

-------------------------- EXAMPLE 3 --------------------------

Description

-----------

Removes all AIA and OCSP entries that match the URL 'https://www.contoso.com/pki/orca1.crt'.

C:\PS>Remove-CAAuthorityInformationAccess -uri "https://www.contoso.com/pki/orca1.crt"

Add-CAAuthorityInformationAccess

Get-CAAuthorityInformationAccess