Edit

Share via


Add-CAAuthorityInformationAccess

Configures the AIA or OCSP for a certification authority.

Syntax

AddAsInputObject

Add-CAAuthorityInformationAccess
    [-InputObject] <AuthorityInformationAccess>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AddAsOCSP

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

AddAsAIA

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddAsAIA
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-AddToCertificateOcsp

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddAsOCSP
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

Forces the command to run without asking for user confirmation.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

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

Parameter properties

Type:AuthorityInformationAccess
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddAsInputObject
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-Uri

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

AddAsOCSP
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False
AddAsAIA
Position:1
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:True
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.