Skip to content

Add-VcCertificateAssociation

SYNOPSIS

Associate certificates with applications

SYNTAX

Add-VcCertificateAssociation [-Certificate] <String> [-Application] <String[]> [-NoOverwrite] [-PassThru]
 [[-VenafiSession] <PSObject>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Associate one or more certificates with one or more applications. The associated applications can either replace or be added to existing. By default, applications will be replaced.

EXAMPLES

EXAMPLE 1

Add-VcCertificateAssociation -Certificate '7ac56ec0-2017-11ee-9417-a17dd25b82f9' -Application '96fc9310-67ec-11eb-a8a7-794fe75a8e6f'

Associate a certificate to an application

EXAMPLE 2

Add-VcCertificateAssociation -Certificate '7ac56ec0-2017-11ee-9417-a17dd25b82f9' -Application '96fc9310-67ec-11eb-a8a7-794fe75a8e6f', 'a05013bd-921d-440c-bc22-c9ead5c8d548'

Associate a certificate to multiple applications

EXAMPLE 3

Find-VcCertificate -First 5 | Add-VcCertificateAssociation -Application 'My Awesome App'

Associate multiple certificates to 1 application by name

EXAMPLE 4

Add-VcCertificateAssociation -Certificate 'www.barron.com' -Application '96fc9310-67ec-11eb-a8a7-794fe75a8e6f' -NoOverwrite

Associate a certificate, by name, to another application, keeping the existing

PARAMETERS

-Certificate

Certificate ID or name to be associated. If a name is provided and multiple certificates are found, they will all be associated. Tab completion can be used for a list of certificate names to choose from. Type 3 or more characters for tab completion to work.

Type: String
Parameter Sets: (All)
Aliases: CertificateID

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

-Application

One or more application IDs or names. Tab completion can be used for a list of application names.

Type: String[]
Parameter Sets: (All)
Aliases: ApplicationID

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

-NoOverwrite

Append to existing applications as opposed to overwriting

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PassThru

Return the newly updated certificate object(s)

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-VenafiSession

Authentication for the function. The value defaults to the script session object $VenafiSession created by New-VenafiSession. A TLSPC key can also provided.

Type: PSObject
Parameter Sets: (All)
Aliases: Key

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
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

Certificate

OUTPUTS

PSCustomObject

NOTES