Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Add-CAAuthorityInformationAccess

Brian Lich|Last Updated: 3/26/2017

SYNOPSIS

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

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.

PARAMETERS

-AddToCertificateAia

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

Type: SwitchParameter
Parameter Sets: AddAsAIA
Aliases: 

Required: True
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
Parameter Sets: AddAsOCSP
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
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
Parameter Sets: (All)
Aliases: 

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

-InputObject

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

Type: AuthorityInformationAccess
Parameter Sets: AddAsInputObject
Aliases: 

Required: True
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
Parameter Sets: AddAsOCSP, AddAsAIA
Aliases: 

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

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

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

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.

NOTES

Get-CAAuthorityInformationAccess

Remove-CAAuthorityInformationAccess

© 2017 Microsoft