Get-VITrustedCertificate Command | Vmware PowerCLI Reference

Get-VITrustedCertificate

This cmdlet retrieves information about the certificates trusted by a vCenter Server instance and/or its connected ESXi hosts. The returned object is a pair of the certificate and the vCenter Server or ESXi entity that trusts the certificate. The cmdlet might return more than one certificate/entity object. If you pass no parameters, the command returns all certificate/entity pairs trusted by the vCenter Server instance and the connected ESXi hosts.

Syntax

Get-VITrustedCertificate
-Id < String[] >
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Id String[] named
Specifies the UIDs of the trusted certificates you want to retrieve. Note: If you specify multiple UIDs, the system returns a certificate/entity object for each UID.
optional Server VIServer[] named
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default server. For more information about default servers, see the description of the Connect-VIServer cmdlet.
Get-VITrustedCertificate
[-Server < VIServer[] > ]
[-VMHost < VMHost[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
optional Server VIServer[] named
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default server. For more information about default servers, see the description of the Connect-VIServer cmdlet.
optional VMHost VMHost[] named
  • pipeline
Specifies one or more ESXi hosts whose trusted certificates you want to retrieve.
Get-VITrustedCertificate
-EsxOnly
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
EsxOnly SwitchParameter named
Specifies that the result includes only the certificates trusted by the connected ESXi hosts.
optional Server VIServer[] named
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default server. For more information about default servers, see the description of the Connect-VIServer cmdlet.
Get-VITrustedCertificate
-VCenterOnly
[-Server < VIServer[] > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
VCenterOnly SwitchParameter named
Specifies that the result includes only the certificates trusted by the vCenter Server instance.
optional Server VIServer[] named
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default server. For more information about default servers, see the description of the Connect-VIServer cmdlet.

Output

VMware.VimAutomation.ViCore.Types.V1.Certificates.TrustedCertificateInfo

Examples

Example 1

Get-VITrustedCertificate

Retrieves the certificates trusted by the vCenter Server instance and the connected ESXi hosts.

Example 2

Get-VITrustedCertificate -VCenterOnly

Retrieves the certificates trusted by the vCenter Server system only.

Example 3

Get-VITrustedCertificate -EsxOnly

Retrieves the certificates trusted by the connected ESXi hosts only.

Example 4

Get-VITrustedCertificate -VMHost 'MyHost'

Retrieves the certificates trusted by the specified ESXi host(s) only.

Related Commands

VITrustedCertificate

This cmdlet adds a certificate or certificate chain to the vCenter Server or ESXi trusted stores.

This cmdlet retrieves information about the trusted certificates in a vCenter Server environment.

This cmdlet removes one or more certificates or certificate chains from the vCenter Server or ESXi trusted stores.