PowerCLI Reference



This cmdlet retrieves the host storages on a vCenter Server system.


Get-VMHostStorage -Id <String[]> [-Server <VIServer[]>] [<CommonParameters>]

Get-VMHostStorage [-VMHost] <VMHost[]> [-Refresh] [-RescanAllHba] [-RescanVmfs] [-Server <VIServer[]>] [<CommonParameters>]

Related Commands

Online Version

Detailed Description

This cmdlet retrieves the host storages on a vCenter Server system. The cmdlet returns a list of the storages on the hosts specified by the VMHost parameter. To specify a server different from the default one, use the Server parameter.


NameTypeDescriptionRequired?Pipeline InputDefault Value
VMHostVMHost[]Specifies the hosts for which you want to retrieve storage information.trueTrue (ByValue)
IdString[]Specifies the IDs of the host storages that you want to retrieve.

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.
RefreshSwitchParameterIndicates whether the cmdlet refreshes the storage system information before retrieving the specified host storages.falseFalse
RescanAllHbaSwitchParameterIndicates whether to issue a request to rescan all virtual machine hosts bus adapters for new storage devices prior to retrieving the storage information.falseFalse
RescanVmfsSwitchParameterIndicates whether to perform a re-scan for new virtual machine file systems that might have been added, prior to retrieving the storage information.falseFalse
ServerVIServer[]Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.falseFalse

Return Type

Zero or more VMHostStorageInfo objects


The ScsiLun property of the VMHostStorageInfo object is deprecated and scheduled for removal.


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

Get-VmHostStorage -VMHost -Refresh

Retrieves storage information from the virtual machine host with IP address

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

Get-VMHostStorage | select -expandproperty scsilun | fl *

Retrieves information about the vendor, model, and serial number of the virtual machine host storage SCSI adapter.

Note that for devices, that are not SCSI-3 compliant, the SerialNumber property is not defined. And not all SCSI-3 compliant devices provide the serial number information.

Copyright © VMware, Inc. All rights reserved.