NAME

Register-DcsClientPort

SYNOPSIS

Registers a port to a client (host).

SYNTAX

Register-DcsClientPort   -Port <Object>   -Client <String>   [ -PortType <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Registers a port to a client (host). The client must be registered before using this cmdlet (see Add-DcsClient). If a port is not defined or known to the server, it will be added.

PARAMETERS

-Port<Object>
ScsiPortData object, name (IQN or WWN), ID, or address that identifies the port to register. If the port is not known to the server, it will be added. If providing an IQN as the value, all letters must be lowercase.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Client<String>
Name or ID of the client. The client must be registered and exist in the configuration (see Add-DcsClient).

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PortType<String>
The PortType parameter is used to define the port as the specified type. Valid values are "iSCSI" or "FibreChannel".

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection is used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

ScsiPortData : Object the identifies and describes the port.

OUTPUTS

ScsiPortData : Object the identifies and describes the port.

NOTES

Also see Set-DcsPortProperties, Get-DcsPort, Get-DcsPortConnection.

EXAMPLES


-------------- Example 1 Assigns a specified port to a specified client --------------
Register-DcsClientPort -Port iqn.1991-05.com.microsoft:host4.datacoresoftware.
com -Client Host4
		

The cmdlet is invoked with the value of the Port parameter being the IQN. (The IQN must be entered in lowercase.) The name of the client is provided in the Client parameter. The iSCSI port named "iqn.1991-05.com.microsoft:host4.datacoresoftware.com" is assigned to the client named "Host4". An alias of "iSCSI Port 1" is assigned to the port.

HostId:b26c5aa9d9c74f8e97b29ce20b2c7fef
PortName:iqn.1991-05.com.microsoft:host4.datacoresoftware.com
Alias:iSCSI Port 1
Description:
PortType:iSCSI
PortMode:Initiator
Connected:True
Id:iqn.1991-05.com.microsoft:host4.datacoresoftware.com
Caption:iSCSI Port 1
ExtendedCaption:iSCSI Port 1 on Host4
Internal:False