Registers a host for a specified storage system.
Syntax
New-EmcStorageRegisteredHost -HostSystem <IHostSystem> -StorageSystem <IRequireRemoteHostRegistration> [-Silent] [<CommonParameters>]
New-EmcStorageRegisteredHost -StorageSystem <IRequireRemoteHostRegistration> [-Silent] -HostName <String> -IpAddress <String> [-InitiatorIds <String[]>] [-AlternativeIpAddresses <String[]>] [<CommonParameters>]
Parameters
-HostSystem <IHostSystem>
Attributes: Required, Position: named
Specifies the ESI host system object. You can add a host system object to ESI by using the Get-EmcHostSystemCredential and Connect-EmcSystem cmdlets. You can get a host system object by using the Get-EmcHostSystem cmdlet. The object can be a stand-alone host system, a virtual machine, or a hypervisor.
-StorageSystem <IRequireRemoteHostRegistration>
Attributes: Required, Position: named
Specifies the storage system.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
-HostName <String>
Attributes: Required, Position: named
Specifies the host name.
-IpAddress <String>
Attributes: Required, Position: named
Specifies the IP address.
-InitiatorIds <String[]>
Attributes: Optional, Position: named
Specifies the IDs of the initiators.
-AlternativeIpAddresses <String[]>
Attributes: Optional, Position: named
Specifies the alternative IP addresses.
<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>$hs = Get-EmcHostSystem TestHost.localdomain
C:\PS>$ss = Get-EmcStorageSystem storage01
C:\PS>New-EmcStorageRegisteredHost -HostSystem $hs -StorageSystem $ss
This example registers the host and host initiators with the storage array. By default, all of the initiators for that specified host will be registered together.
-------------- Example 2 --------------
C:\PS>$ss = Get-EmcStorageSystem storage01
C:\PS>New-EmcStorageRegisteredHost -HostName "TestHost.localdomain" -storageSystem $ss -IpAddress "10.2.5.23"
This example registers the host with the specified storage system, based on the specified host name and IP address.
-------------- Example 3 --------------
C:\PS>$ss = Get-EmcStorageSystem storage01
C:\PS>New-EmcStorageRegisteredHost -HostName "TestHost.localdomain" -storageSystem $ss -IpAddress "10.2.5.23" -InitiatorIds "iqn.1991-05.com.microsoft:TestHost.localdomain"
This example registers the host with the specified storage system, based on the specified host name, IP address, and the IDs of the host bus adapters.