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

-Id < String[] >

[-ProgressAction < ActionPreference > ]

[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	ProgressAction	ActionPreference	named

Required	Parameter Name	Type	Position	Features	Description
optional	ProgressAction	ActionPreference	named
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.

Required	Parameter Name	Type	Position	Description
required	EsxOnly	SwitchParameter	named	Specifies that the result includes only the certificates trusted by the connected ESXi hosts.
optional	ProgressAction	ActionPreference	named
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.

Required	Parameter Name	Type	Position	Features	Description
required	VMHost	VMHost[]	named	pipeline	Specifies one or more ESXi hosts whose trusted certificates you want to retrieve.
optional	ProgressAction	ActionPreference	named
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.

Required	Parameter Name	Type	Position	Description
required	VCenterOnly	SwitchParameter	named	Specifies that the result includes only the certificates trusted by the vCenter Server instance.
optional	ProgressAction	ActionPreference	named
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

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

Add-VITrustedCertificate

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

Get-VITrustedCertificate

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

Remove-VITrustedCertificate

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