vSphere PowerCLI Reference

Get-VMHostFirmware

Synopsis

Retrieves hosts firmware information.

Syntax

Get-VMHostFirmware [-VMHost] <VMHost[]> [-Server <VIServer[]>] [<CommonParameters>]
Get-VMHostFirmware [-VMHost] <VMHost[]> [-BackupConfiguration] -DestinationPath <String> [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online version
Set-VMHostFirmware

Detailed Description

Retrieves firmware information for the hosts specified by the VMHost parameter. To specify a server different from the default one, use the -Server parameter. To run this cmdlet, you need to have the "Host.Config.Firmware" permission to the ESX.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
VMHostVMHost[]Specify the hosts for which you want to retrieve firmware information.truetrue (ByValue)
BackupConfigurationSwitchParameterIndicate that you want to backup the host firmware configuration and download the bundle to the specified DestinationPath.falsefalse
DestinationPathStringSpecify a destination path where to download the host configuration backup bundle if the BackupConfiguration parameter is set.truefalse
ServerVIServer[]The -Server parameter is needed when the host is specified by name. In this case, the host with the specified name is searched on the specified servers and firmware information is retrieved from it. If a VMHost object is passed to the VMHost parameter, the -Server parameter is not used.falsefalse

Return Type

HostFirmware

Notes

This functionality applies to ESXi Embedded only.

Examples

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

Get-VMHostFirmware -VMHost $host

Retrieves the firmware information for the specified host.

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

Get-VMHostFirmware -VMHost $host -BackupConfiguration -DestinationPath C:\Downloads

Backups a server configuration for the virtual machine host stored in the $host variable, and downloads the configuration files into the specified folder.


Copyright © 1998 - 2011 VMware, Inc. All rights reserved.