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