PowerCLI Reference

Add-TrustAuthorityKeyProviderServerCertificate

Synopsis

This cmdlet adds the certificate from the Trust Authority key provider server to be trusted by the Trust Authority key provider.

Syntax

Add-TrustAuthorityKeyProviderServerCertificate [-KeyProvider] <TrustAuthorityKeyProvider> -Certificate <X509Certificate2[]> [-Server <VIServer[]>] [-TrustAuthorityCluster <TrustAuthorityCluster>] [<CommonParameters>]

Add-TrustAuthorityKeyProviderServerCertificate [-KeyProvider] <TrustAuthorityKeyProvider> -FilePath <String> [-Server <VIServer[]>] [-TrustAuthorityCluster <TrustAuthorityCluster>] [<CommonParameters>]

Add-TrustAuthorityKeyProviderServerCertificate [-ServerCertificate] <TrustAuthorityKeyProviderServerCertificate[]> [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online Version
Get-TrustAuthorityKeyProviderServerCertificate
Remove-TrustAuthorityKeyProviderServerCertificate
Get-TrustAuthorityKeyProviderServer

Detailed Description

This cmdlet adds the certificate from the Trust Authority key provider server to be trusted by the Trust Authority key provider.

Parameters

Name	Type	Description	Required?	Pipeline Input
KeyProvider	TrustAuthorityKeyProvider	Specifies the Trust Authority key provider to trust the specified certificate.	true	True (ByValue)
ServerCertificate	TrustAuthorityKeyProviderServerCertificate[]	Specifies the Trust Authority key provider server certificate that you can trust.	true	True (ByValue)
Certificate	X509Certificate2[]	Specifies the certificate to be trusted by the specified Trust Authority key provider.	true	False
FilePath	String	Specifies a file that stores the X509Certificate2 data which you want to be trusted by the Trust Authority key provider.	true	False
Server	VIServer[]	Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet.	false	False
TrustAuthorityCluster	TrustAuthorityCluster	Specifies the Trust Authority cluster where the Trust Authority key provider resides.	false	False

Return Type

VMware.VimAutomation.Security.Types.V1.TrustedInfrastructure.TrustAuthorityKeyProviderServerCertificate

Notes

Examples

-------------------------- Example 1 --------------------------

$kps = Get-TrustAuthorityKeyProviderServer -KeyProvider myProvider | select -First 1
$serverCertificate = Get-TrustAuthorityKeyProviderServerCertificate -KeyProviderServer $kps
Add-TrustAuthorityKeyProviderServerCertificate -ServerCertificate $serverCertificate

Adds the $serverCertificate certificate which you can retrieve from the first Trust Authority key Provider server in the Trust Authority key provider named myProvider.

-------------------------- Example 2 --------------------------

$kps = Get-TrustAuthorityKeyProviderServer -KeyProvider myProvider | select -First 1
$serverCertificate = Get-TrustAuthorityKeyProviderServerCertificate -KeyProviderServer $kps
Add-TrustAuthorityKeyProviderServerCertificate -KeyProvider myProvider -Certificate $serverCertificate.Certificate

Adds the certificate which you want to retrieve from the $serverCertificate certificate to be trusted by the Trust Authority key provider myProvider.