Get-VIMachineCertificate Command | Vmware PowerCLI Reference

Get-VIMachineCertificate

This cmdlet retrieves information about the machine SSL certificates of the vCenter Server instance and the ESXi hosts.Machine SSL certificates secure communication with HTTP clients, APIs and other services that are using port 443.

Syntax

Get-VIMachineCertificate
[-ProgressAction < ActionPreference > ]
[-Server < VIServer > ]
[CommonParameters]

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.
Get-VIMachineCertificate
-EsxOnly
[-ProgressAction < ActionPreference > ]
[-Server < VIServer > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
EsxOnly SwitchParameter named
Specifies that the result must include the machine SSL certificates of the ESXi hosts only.
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.
Get-VIMachineCertificate
-VMHost < VMHost[] >
[-ProgressAction < ActionPreference > ]
[-Server < VIServer > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
VMHost VMHost[] named
  • pipeline
Specifies one or more ESXi hosts for whose machine SSL certificates the command must return a result.
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.
Get-VIMachineCertificate
-VCenterOnly
[-ProgressAction < ActionPreference > ]
[-Server < VIServer > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
VCenterOnly SwitchParameter named
Specifies that the result must include the machine SSL certificate of the vCenter Server instance only.
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

ViMachineCertificateInfo

Examples

Example 1

Get-VIMachineCertificate

Retrieve the machine certificate of the vCenter Server system and its ESXi hosts.

Example 2

Get-VIMachineCertificate -VCenterOnly

Retrieve the machine certificate of the vCenter Server system.

Example 3

Get-VIMachineCertificate -EsxOnly

Retrieve the machine certificate of all the ESXi hosts of the vCenter Server system.

Example 4

Get-VIMachineCertificate -VMHost 'MyHost'

Retrieve the machine certificate of the 'MyHost' ESXi host.

Related Commands

VIMachineCertificate

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

This cmdlet sets a machine SSL certificate to a vCenter Server instance or a connected ESXi host.

VIMachineCertificateSigningRequest

This cmdlet generates a new Certificate Signing Request (CSR) for a vCenter Server system or an ESXi host.