New-EmcStorageRegisteredHost

Registers a host for a specified storage system.

 

Syntax

 

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.