Add-CAAuthorityInformationAccess

Configures the AIA or OCSP for a certification authority.

Syntax

Add-CAAuthorityInformationAccess
   [-InputObject] <AuthorityInformationAccess>
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CAAuthorityInformationAccess
   [-Uri] <String>
   [-AddToCertificateOcsp]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CAAuthorityInformationAccess
   [-Uri] <String>
   [-AddToCertificateAia]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<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

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

Add-CAAuthorityInformationAccess -AddToCertificateOcsp -Uri http://www.corp.contoso.com/ocsp.

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

Parameters

-AddToCertificateAia

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:AuthorityInformationAccess
Position:1
Default value:None
Required:True
Accept pipeline input:True
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
Required:True
Accept pipeline input:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.CertificateServices.Administration.Commands.CA.AuthorityInformationAccess

String

SwitchParameter

Outputs

Microsoft.CertificateServices.Administration.Commands.CA.AuthorityInformationAccessResult

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