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
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 |