NAME

Reset-DcsServerPort

SYNOPSIS

Reinitializes a server target port.

SYNTAX

Reset-DcsServerPort   -Port <Object>   [ -Server <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Reinitializes a server target port. This cmdlet performs a full re-initialization on the specified Fibre Channel or iSCSI port on a server, which includes reloading firmware, re-initializing hardware (FC only), resetting the link, and logging in the ports. This operation may take a few minutes and during that time traffic on the port will be suspended.

PARAMETERS

-Port<Object>
ScsiPortData object, name, or ID that identifies the port. 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. The computer name must be unique or the name must be fully qualified.

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 that identifies and describes the port.

OUTPUTS

ScsiPortData : Object that identifies and describes the port.

NOTES

Also see Get-DcsPort

EXAMPLES


-------------- Example 1 Reinitializes a server port by specifying the name --------------
Reset-DcsServerPort -Port "Server iSCSI Port 3" -Server SSV1
		

The port named "Server iSCSI Port 3" on the server named "SSV1" is reinitialized.

IdInfo:DataCore.Executive.iSCSI.iScsiPortIdInfo
PortConfigInfo:DataCore.Executive.iSCSI.PortConfigInfo
IScsiPortStateInfo:DataCore.Executive.iSCSI.iScsiPortStateInfo
iSCSINodes:{iqn.1991-05.com.microsoft:ssv3.datacoresoftware.com, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com}
CapabilityInfo:DataCore.Executive.iSCSI.iScsiPortCapabilityInfo
PresenceStatus:Present
PhysicalName:MAC:00-15-5D-65-16-01
ServerPortProperties:DataCore.Executive.ServeriScsiPortPropertiesData
RoleCapability:Frontend, Mirror
AluaId:1028
PortName:iqn.2000-08.com.datacore:ssv1-3
Alias:Server iSCSI Port 3
Description:
PortType:iSCSI
PortMode:Target
HostId:10724844-FEF9-415C-8292-44EAE2826487
Connected:True
Sequencenumber:1989
Id:158f6c2b-8475-42df-92e0-77e5ceb6361e
Caption:Server iSCSI Port 3
ExtendedCaption:Server iSCSI Port 3 on SSV1
Internal:False
   

-------------- Example 2 Reinitializes all iSCSI target ports for a server --------------
$ports = Get-DcsPort -Type "iSCSI" -Machine SSV1 | where {$_.PortMode -eq 'Target'}
$ports | Reset-DcsServerPort
		

The cmdlet Get-DcsPort is invoked to get ScsiPortData objects for all iSCSI ports on server "SSV1" that have a target port mode. The objects are saved in the variable $ports. The variable $ports is used to pipe all the objects to the cmdlet Reset-DcsServerPort. All target iSCSI ports on the server "SSV1" are reinitialized.

IdInfo:DataCore.Executive.iSCSI.iScsiPortIdInfo
PortConfigInfo:DataCore.Executive.iSCSI.PortConfigInfo
IScsiPortStateInfo:DataCore.Executive.iSCSI.iScsiPortStateInfo
iSCSINodes:{iqn.1991-05.com.microsoft:vmhost.datacoresoftware.com, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com}
CapabilityInfo:DataCore.Executive.iSCSI.iScsiPortCapabilityInfo
PresenceStatus:Present
PhysicalName:MAC:00-15-5D-65-16-00
ServerPortProperties:DataCore.Executive.ServeriScsiPortPropertiesData
RoleCapability:Frontend, Mirror
AluaId:1027
PortName:iqn.2000-08.com.datacore:ssv1-1
Alias:Server iSCSI Port 1
Description:
PortType:iSCSI
PortMode:Target
HostId:10724844-FEF9-415C-8292-44EAE2826487
Connected:True
Sequencenumber:2517
Id:a8d45168-1a67-4823-ad20-79247cc511e9
Caption:Server iSCSI Port 1
ExtendedCaption:Server iSCSI Port 1 on SSV1
Internal:False
   
IdInfo:DataCore.Executive.iSCSI.iScsiPortIdInfo
PortConfigInfo:DataCore.Executive.iSCSI.PortConfigInfo
IScsiPortStateInfo:DataCore.Executive.iSCSI.iScsiPortStateInfo
iSCSINodes:{iqn.1991-05.com.microsoft:ssv3.datacoresoftware.com, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com}
CapabilityInfo:DataCore.Executive.iSCSI.iScsiPortCapabilityInfo
PresenceStatus:Present
PhysicalName:MAC:00-15-5D-65-16-03
ServerPortProperties:DataCore.Executive.ServeriScsiPortPropertiesData
RoleCapability:Frontend, Mirror
AluaId:1030
PortName:iqn.2000-08.com.datacore:ssv1-2
Alias:Server iSCSI Port 2
Description:
PortType:iSCSI
PortMode:Target
HostId:10724844-FEF9-415C-8292-44EAE2826487
Connected:True
Sequencenumber:1991
Id:8f24e316-ae18-4562-a723-ecc53dcee196
Caption:Server iSCSI Port 2
ExtendedCaption:Server iSCSI Port 2 on SSV1
Internal:False