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