Add-CAAuthority Information Access

Module:
adcsadministration
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 

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.