NAME

Connect-DcsiSCSITarget

SYNOPSIS

Creates an iSCSI session connection.

SYNTAX

Connect-DcsiSCSITarget   -InitiatorPort <Object>   [ -Server <String> ]   -Address <String>   [ -Portnumber <UInt16> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Connect-DcsiSCSITarget   -InitiatorPort <Object>   [ -Server <String> ]   -Address <String>   [ -Portnumber <UInt16> ]   [ -UseChap]   [ -UseMutualAuthentication]   [ -InitiatorPortal <String> ]   [ -UserName <String> ]   -Password <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Creates an iSCSI session connection. Adds an iSCSI target portal to the Microsoft iSCSI Initiator port of a server and logs in. Authentication can be enabled. If different types of authentication are required for different targets, the cmdlet must be run individually for each authentication type. After invoking this cmdlet, when the target is logged out, the target will disappear and in order to log in the target again, this cmdlet would have to be invoked again.

PARAMETERS

-InitiatorPort<Object>

ScsiPortData object, name, or ID that identifies the Microsoft iSCSI Initiator port. In order to uniquely identify a port by name, the server must be specified.

Required: true

Position: named

Default value:

Accept pipeline input: true (ByValue)

Accept wildcard characters: false

-Server<String>

Computer name or ID of the server. Computer names must be unique or the names must be fully qualified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Address<String>

Address of an iSCSI target port. The address can be a valid server name or IP address.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Portnumber<UInt16>

The TCP port number used for the connection. If not specified, 3260 will be used.

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

-UseChap<SwitchParameter>

Specify the UseChap parameter to enable authentication.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-UseMutualAuthentication<SwitchParameter>

Specify the UseMutualAuthentication parameter to enable mutual authentication. If UseMutualAuthentication is specified, the parameter UseChap must also be specified.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-InitiatorPortal<String>

IP address that identifies the Microsoft iSCSI Initiator port.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-UserName<String>

User name assigned to the target port.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Password<String>

The target secret for the iSCSI target port. Secret is 12-16 characters. Use caution when entering the secret, it will appear as typed on the display.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

INPUTS

ScsiPortData : Object that identifies the initiator port.

OUTPUTS

iSCSISessionData : Object that identifies and describes the session.

NOTES

Also see Disconnect-DcsiSCSITarget, Get-DcsPort, Get-DcsPortConnection, Set-DcsiSCSIInitiatorSecret, Set-DcsServerPortProperties.

EXAMPLES

Connect-DcsiSCSITarget -InitiatorPort "Microsoft iSCSI Initiator" -Server SSV1 -Address 13.0.0.36 -UseChap -UserName CHAPhandshk -Password 111111111111