Edit

Add-CAAuthorityInformationAccess

  • Reference
Module:
adcsadministration

Configures the Authority Information Access (AIA) or Online Certificate Status Protocol (OCSP) for a certification authority (CA).

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 AIA or Online Responder OCSP location for a CA. An AIA URI should specify either an AIA extension or an OCSP extension, but not both.

Examples

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

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

Description

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

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

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

Description

Adds AIA for OCSP pointing to http://www.corp.contoso.com/ocsp

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

PS C:\>$aia = Get-CAAuthorityInformationAccess


PS C:\>$aia | remove-CAAuthorityInformationAccess

These commands remove all AIA entries

Parameters

-AddToCertificateAia

Specifies to add 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

Specifies to add 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

Suppresses all user prompts. By default, you are prompted to confirm each operation.

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

-InputObject

The input object is meant to be 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 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

String

Outputs

Microsoft.CertificateServices.Administration.Commands.CA.AuthorityInformationAccessResult

This output object has a single property named Restart of Boolean type, which by default is set to True.