Gets connected host systems.
Syntax
Get-EmcHostSystem [[-Id] <String>] [-HostSystemType <HostSystemType>] [-Silent] [<CommonParameters>]
Get-EmcHostSystem [-Silent] -HostDisk <Disk> [<CommonParameters>]
Get-EmcHostSystem [-Silent] -Volume <Volume> [<CommonParameters>]
Get-EmcHostSystem [-Silent] -VirtualMachineConfiguration <VirtualMachineConfiguration> [<CommonParameters>]
Get-EmcHostSystem [-Silent] -MailboxServer <MailboxServer> [<CommonParameters>]
Parameters
-Id <String>
Attributes: Optional, Position: 1
Specifies the host name, IP address, or global ID. Wildcards are permitted. It is a positional parameter (position = 1).
-HostSystemType <HostSystemType>
Attributes: Optional, Position: named
Specifies the host system type. Valid values are Hypervisor, VirtualMachine, Windows, HyperV, XenServer, VMwareEsxHost, HyperV_VirtualMachine, VMware_VirtualMachine, XenServer_VirtualMachine.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
-HostDisk <Disk>
Attributes: Required, Position: named
Specifies the ESI host disk object, which you can get from the ESI host system object or by using the Get-EmcHostDisk or Find-EmcHostDisk cmdlets.
-Volume <Volume>
Attributes: Required, Position: named
Specifies the ESI volume object, which you can get from the ESI host system object or by using the Get-EmcHostVolume cmdlet.
-VirtualMachineConfiguration <VirtualMachineConfiguration>
Attributes: Required, Position: named
Specifies the ESI virtual machine configuration object, which you can get from the ESI hypervisor host system object VirtualMachinesConfigurations parameter or by using the Get-EmcVirtualMachineConfiguration cmdlet.
-MailboxServer <MailboxServer>
Attributes: Required, Position: named
Specifies the mailbox server associated with the host system.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
Examples
-------------- Example 1 --------------
C:\PS>$h = Get-EmcHostSystemCredential
C:\PS>$Host1 = $h | Connect-EmcHostSystem
C:\PS>Get-EmcHostSystem
This example gets the connected host systems.
-------------- Example 2 --------------
C:\PS>$Disk = Get-EmcHostDisk -id 4074289894
C:\PS>$Disk
C:\PS>Get-EmcHostSystem -HostDisk $Disk
This example gets the host system of the specified disk.
-------------- Example 3 --------------
C:\PS>$Volume = Get-EmcHostVolume *Site2Farm94*Data*
C:\PS>$Volume
C:\PS>Get-EmcHostSystem -Volume $Volume
This example gets the host system of the specified volume.
-------------- Example 4 --------------
C:\PS>Get-EmcHostSystem <HostName>
C:\PS>Get-EmcHostSystem <HostIP address>
C:\PS>Get-EmcHostSystem <HostGlobalId>
This example gets the host system with the specified host name, IP address, or global ID. Wildcards are permitted.
-------------- Example 5 --------------
C:\PS>Get-EmcHostSystem -HostSystemType hyperV
This example gets all of the Hyper-V systems.
-------------- Example 6 --------------
C:\PS>Get-EmcHostSystem -HostSystemType hyperV <HostIpAddress>
This example gets the Hyper-V system with a specified IP address. Wildcards are permitted.
-------------- Example 7 --------------
C:\PS>Get-EmcHostSystem -HostSystemType VMwareESXHost
This example gets all of the VMware ESX Hosts.
-------------- Example 8 --------------
C:\PS>Get-EmcHostSystem -HostSystemType VMware_VirtualMachine
This example gets all of the virtual machines of the VMware systems.
-------------- Example 9 --------------
C:\PS>$vm = Get-EmcHostSystemCredential | Connect-EmcSystem
C:\PS>$vmconfig = Get-EmcVirtualMachineConfiguration -VirtualMachine $vm
C:\PS>Get-EmcHostSystem -VirtualMachineConfiguration $vmconfig
This example gets the virtual machines for a specified configuration.
-------------- Example 10 --------------
C:\PS>$ms = Get-EmcMailboxServer MS1
C:\PS>Get-EmcHostSystem -MailboxServer $ms
This example gets the host system of the MS1 mailbox server.