NAME

Disconnect-DcsiSCSITarget

SYNOPSIS

Logs out an iSCSI target port from the Microsoft Initiator on a server.

SYNTAX

Disconnect-DcsiSCSITarget   [ -Server <String> ]   [ -InitiatorPort <String> ]   -Session <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Logs out an iSCSI target port from the Microsoft Initiator on a server.

PARAMETERS

-Server<String>
Computer name or ID of the server. The computer name must be unique or the name must be fully qualified.

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

-InitiatorPort<String>
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: false
Position: 2
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Session<Object>
iSCSISessionData object or ID that identifies the session to disconnect.

Required: true
Position: 3
Default value:
Accept pipeline input: true (ByValue)
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

INPUTS

iSCSiSessionData : Object that identifies and describes the iSCSI session.

OUTPUTS

iSCSiSessionData : Object that identifies and describes the iSCSI session.

NOTES

Also see Connect-DcsiSCSITarget, Remove-DcsServerPort, Get-DcsPort, Get-DcsPortConnection.

EXAMPLES


-------------- Example 1 Logs out a specified target port by piping the object --------------
Get-DcsPortConnection -ConnectionType iSCSI -Machine SSV2 -Port "Server iSCSI Port 1" | Disconnect-DcsiSCSITarget -Server SSV1 -InitiatorPort "Microsoft iSCSI Initiator"
		

Logs out the target port named "Server iSCSI Port 1" on the server named "SSV2" from the initiator port named "Microsoft iSCSI Initiator" on the server named "SSV1". The session object was obtained using the Get-DcsPortConnection cmdlet.

PortADescriptor:DataCore.Executive.iSCSI.SessionDescriptor
PortBDescriptor:DataCore.Executive.iSCSI.SessionDescriptor
Target:
Connected:False
PortAId:781D998D-3920-46BB-9F26-88BC591772B6:MAC:00-15-5D-11-E9-10
PortBId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:MSFT-05-1991
Id:19422f2c70684923beff0b9a789fb76a
Caption:Server iSCSI Port 1 on SSV2 to Microsoft iSCSI Initiator on SSV1
ExtendedCaption:Server iSCSI Port 1 on SSV2 to Microsoft iSCSI Initiator on SSV1
Internal:False
   

-------------- Example 2 Logs out all target ports of a server by piping the objects --------------
Get-DcsPortConnection -ConnectionType iSCSI -Machine SSV2 | Disconnect-DcsiSCSITarget -Server SSV1 -InitiatorPort "Microsoft iSCSI Initiator"
		

Logs out all target ports belonging to server SSV2 from the Microsoft iSCSI Initiator on server SSV1. In this case there are four target ports. The session object was obtained using the Get-DcsPortConnection cmdlet.

PortADescriptor:
PortBDescriptor:DataCore.Executive.iSCSI.SessionDescriptor
Target:
Connected:False
PortAId:781D998D-3920-46BB-9F26-88BC591772B6:MAC:00-15-5D-11-E9-10
PortBId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:MSFT-05-1991
Id:19422f2c70684923beff0b9a789fb76a
Caption:Server iSCSI Port 1 on SSV2 to Microsoft iSCSI Initiator on SSV1
ExtendedCaption:Server iSCSI Port 1 on SSV2 to Microsoft iSCSI Initiator on SSV1
Internal:False
   
PortADescriptor:DataCore.Executive.iSCSI.SessionDescriptor
PortBDescriptor:DataCore.Executive.iSCSI.SessionDescriptor
Target:
Connected:False
PortAId:781D998D-3920-46BB-9F26-88BC591772B6:MAC:00-15-5D-11-E9-23
PortBId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:MSFT-05-1991
Id:aea86468f600412487fd9e8c606fe5fb
Caption:Server iSCSI Port 4 on SSV2 to Microsoft iSCSI Initiator on SSV1
ExtendedCaption:Server iSCSI Port 4 on SSV2 to Microsoft iSCSI Initiator on SSV1
Internal:False
   
PortADescriptor:DataCore.Executive.iSCSI.SessionDescriptor
PortBDescriptor:DataCore.Executive.iSCSI.SessionDescriptor
Target:
Connected:False
PortAId:781D998D-3920-46BB-9F26-88BC591772B6:MAC:00-15-5D-11-E9-22
PortBId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:MSFT-05-1991
Id:1095330d613040c78c8d280fbe2d2368
Caption:Server iSCSI Port 3 on SSV2 to Microsoft iSCSI Initiator on SSV1
ExtendedCaption:Server iSCSI Port 3 on SSV2 to Microsoft iSCSI Initiator on SSV1
Internal:False
   
PortADescriptor:DataCore.Executive.iSCSI.SessionDescriptor
PortBDescriptor:DataCore.Executive.iSCSI.SessionDescriptor
Target:
Connected:False
PortAId:781D998D-3920-46BB-9F26-88BC591772B6:MAC:00-15-5D-11-E9-18
PortBId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:MSFT-05-1991
Id:ab270dc1972d4666a829afe7e7cd94d8
Caption:Server iSCSI Port 2 on SSV2 to Microsoft iSCSI Initiator on SSV1
ExtendedCaption:Server iSCSI Port 2 on SSV2 to Microsoft iSCSI Initiator on SSV1
Internal:False