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
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 |
|
Parameters
| 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. |
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 | 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. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
VMHost | VMHost[] | named |
|
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. |
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 | 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
TrustedCertificateInfoExamples
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.