Add-CAAuthorityInformationAccess

Configures the AIA or OCSP for a certification authority.

Syntax

Add-CAAuthorityInformationAccess
   [-Uri] <String>
   [-AddToCertificateAia]
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Add-CAAuthorityInformationAccess
   [-Uri] <String>
   [-AddToCertificateOcsp]
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Add-CAAuthorityInformationAccess
   [-InputObject] <AuthorityInformationAccess>
   [-Confirm]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Description

The Add-CAAuthorityInformationAccess cmdlet configures the uniform resource identifier (URI) for the Authority Information Access (AIA) or Online Certificate Status Protocol (OCSP) for a certification authority (CA). An AIA URI should specify either an AIA extension or an OCSP extension, but not both.

Examples

Example 1: Add AIA to the specified authority

PS C:\> Add-CAAuthorityInformationAccess -AddToCertificateAia -Uri http://ca1.corp.contoso.com/pki

This command adds Authority Information Access (AIA) for the specified certification authority to 'http://ca1.corp.contoso.com/pki'.

Example 2: Add AIA for OCSP

PS C:\> Add-CAAuthorityInformationAccess -AddToCertificateOcsp -Uri http://www.corp.contoso.com/ocsp.

This command adds AIA for OCSP pointing to http://www.corp.contoso.com/ocsp.

Example 3: Remove all AIA entries

PS C:\> $AIA = Get-CAAuthorityInformationAccess


PS C:\> $AIA | Remove-CAAuthorityInformationAccess

This example removes all AIA entries

The first command gets the certificate authority information and stores the information in the variable named $AIA.

The second command removes all the AIA entries that are stored in the $AIA variable.

Required Parameters

-AddToCertificateAia

Indicates the cmdlet adds the URI to the AIA extension of the issued certificate.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-AddToCertificateOcsp

Indicates that the cmdlet adds the URI to the Online Responder OCSP extension of the issued certificate.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-InputObject

Specifies the input object that is used in a pipeline command.

Type:AuthorityInformationAccess
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False
-Uri

Specifies a link, as a URI, for the AIA or Online Responder OCSP location.

Type:String
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

System.String

Outputs

Microsoft.CertificateServices.Administration.Commands.CA.AuthorityInformationAccessResult

The cmdlet returns a Boolean type property named Restart, which, by default, is set to $True.