PowerCLI Reference

Get-VMHostHardware

Synopsis

This cmdlet retrieves ESXi host hardware and firmware information.

Syntax

Get-VMHostHardware [-VMHost <VMHost[]>] [-WaitForAllData] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-SkipAllSslCertificateChecks] [-Server <VIServer[]>] [<CommonParameters>]

Get-VMHostHardware -Id <String[]> [-WaitForAllData] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-SkipAllSslCertificateChecks] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version

Detailed Description

This cmdlet retrieves hardware and firmware information for the hosts specified by the VMHost parameter. To specify a server different from the default one, use the Server parameter.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
IdString[]Filters the ESXi hosts by ID.

Note: When a list of values is specified for the Id parameter, the returned objects would have an ID that matches exactly one of the string values in that list.
truefalse
ServerVIServer[]This parameter is required when you specify the host by name. In this case, the host with the specified name is searched on the specified servers and hardware information is retrieved from it. If a VMHost object is passed to the VMHost parameter, the Server parameter is not used.falsefalse
SkipAllSslCertificateChecksSwitchParameterIndicates that all checks for SSL server certificates are skipped.

Note: You should use this parameter only for trusted computers.
falsefalse
SkipCACheckSwitchParameterIndicates that when connecting through HTTPS, the client does not validate that the server certificate is signed by a trusted certification authority (CA).

Note: You should use this parameter only when the remote server can be trusted by using another mechanism, such as when the remote computer is part of a network that is physically secure and isolated.
falsefalse
SkipCNCheckSwitchParameterIndicates that the certificate common name (CN) of the server does not need to match the hostname of the server.

Note: You should use this parameter only for trusted computers.
falsefalse
SkipRevocationCheckSwitchParameterIndicates that the revocation check for server certificates is skipped.

Note: You should use this parameter only for trusted computers.
falsefalse
VMHostVMHost[]Specifies the hosts for which you want to retrieve hardware information. If not specified, the cmdlet retrieves hardware information for all hosts on all default connections.falsetrue (ByValue)
WaitForAllDataSwitchParameterIf specified, forces all data for each result object to be retrieved before that object is returned. If this parameter is not specified, retrieval of some of the data in the output objects might be postponed to an arbitrary point in time between the cmdlet call and the first time the data is accessed through the corresponding property. As a result, not specifying this parameter makes the cmdlet return data faster, but different portions of the data in result objects might come from different points in time.falsefalse

Return Type

Zero or more VMHostHardware objects

Notes

This cmdlet is not supported on the Core edition of PowerShell.

Examples

-------------- Example 1 --------------

Get-VMHost "MyVMHost" | Get-VMHostHardware

Retrieves hardware information about the "MyVMHost" host.

-------------- Example 2 --------------

Get-VMHostHardware -VMHost "MyVMHost" -SkipAllSslCertificateChecks

Retrieves hardware information about the "MyVMHost" host, skipping all verifications of SSL server certificates.


Copyright © VMware, Inc. All rights reserved.