NAME
Update-DcsServerPort
SYNOPSIS
Rescans server ports to discover disks.
SYNTAX
Update-DcsServerPort [ -Server <String> ] -Port <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]
Update-DcsServerPort [ -Server <String> ] -AllPorts [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Rescans server ports to discover disks. All ports on a server can be scanned or an individual port can be scanned.
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: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Port<Object>
- ScsiPortData object, name, or ID that identifies a port. To uniquely identify ports by name, the server must be specified.
-
- Required: true
- Position: named
- 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 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
-
- -AllPorts<SwitchParameter>
- use this parameter to rescan all ports on the server.
-
- Required: true
- 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 Set-DcsServerPortProperties, Set-DcsPortProperties, Remove-DcsServerPort, Disconnect-DcsiSCSITarget, Connect-DcsiSCSITarget.
EXAMPLES
-------------- Example 1 Scans all ports on a server specified by name --------------
Update-DcsServerPort -Server SSV1 -AllPorts
The cmdlet is invoked with the parameter AllPorts in order to scan all ports of the server named SSV1.
| PresenceStatus | : | Present |
| PhysicalName | : | 22FE0030D920F40E |
| ServerPortProperties | : | DataCore.Executive.ServerPortPropertiesData |
| RoleCapability | : | Frontend, Backend |
| PortName | : | 22-FE-00-30-D9-20-F4-0E |
| Alias | : | LooPBack Port |
| Description | : | |
| PortType | : | LooPBack |
| PortMode | : | InitiatorTarget |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:22FE0030D920F40E |
| Caption | : | LooPBack Port |
| ExtendedCaption | : | LooPBack Port 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:host3, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-15 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-1 |
| Alias | : | Server iSCSI Port 1 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-15 |
| 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:host3, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-20 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-2 |
| Alias | : | Server iSCSI Port 2 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-20 |
| Caption | : | Server iSCSI Port 2 |
| ExtendedCaption | : | Server iSCSI Port 2 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:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-0F |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-3 |
| Alias | : | Server iSCSI Port 3 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-0F |
| Caption | : | Server iSCSI Port 3 |
| ExtendedCaption | : | Server iSCSI Port 3 on SSV1 |
| Internal | : | False |
| InitiatorPortals | : | {fe80::ac9f:4abc:8e7:447a, fe80::2de4:e3b4:87d0:b299, fe80::d86e:28b1:6c8e:ee36, fe80::f13e:c21d:f0b8:c2e...} |
| iSnsServer | : | {} |
| TargetPortals | : | {DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData} |
| PresenceStatus | : | Present |
| PhysicalName | : | MSFT-05-1991 |
| ServerPortProperties | : | DataCore.Executive.ServerPortPropertiesData |
| RoleCapability | : | Backend, Mirror |
| PortName | : | ssv1msiscsiinitiator |
| Alias | : | Microsoft iSCSI Initiator |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Initiator |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MSFT-05-1991 |
| Caption | : | Microsoft iSCSI Initiator |
| ExtendedCaption | : | Microsoft iSCSI Initiator on SSV1 |
| Internal | : | False |
-------------- Example 2 Scans a port specified by name --------------
Update-DcsServerPort -Server SSV1 -Port "Server iSCSI Port 1"
The port named "Server iSCSI Port 1" on the server SSV1 is scanned.
| IdInfo | : | DataCore.Executive.iSCSI.iScsiPortIdInfo |
| PortConfigInfo | : | DataCore.Executive.iSCSI.PortConfigInfo |
| IScsiPortStateInfo | : | DataCore.Executive.iSCSI.iScsiPortStateInfo |
| iSCSINodes | : | {iqn.1991-05.com.microsoft:host3, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-15 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-1 |
| Alias | : | Server iSCSI Port 1 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-15 |
| Caption | : | Server iSCSI Port 1 |
| ExtendedCaption | : | Server iSCSI Port 1 on SSV1 |
| Internal | : | False |
-------------- Example 3 Scans all iSCSI ports for servers by piping objects --------------
Get-DcsPort -Type iSCSI -MachineType Servers | Update-DcsServerPort
The cmdlet Get-DcsPort is invoked to obtain ScsiPortData objects for all iSCSI ports for both servers in the server group. The objects are piped to Update-DcsServerPort to scan the ports for those objects.
| IdInfo | : | DataCore.Executive.iSCSI.iScsiPortIdInfo |
| PortConfigInfo | : | DataCore.Executive.iSCSI.PortConfigInfo |
| IScsiPortStateInfo | : | DataCore.Executive.iSCSI.iScsiPortStateInfo |
| iSCSINodes | : | {iqn.1991-05.com.microsoft:host3, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-15 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-1 |
| Alias | : | Server iSCSI Port 1 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-15 |
| 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:host3, iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-20 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-2 |
| Alias | : | Server iSCSI Port 2 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-20 |
| Caption | : | Server iSCSI Port 2 |
| ExtendedCaption | : | Server iSCSI Port 2 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:ssv2.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-0F |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv1-3 |
| Alias | : | Server iSCSI Port 3 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MAC:00-15-5D-11-E9-0F |
| Caption | : | Server iSCSI Port 3 |
| ExtendedCaption | : | Server iSCSI Port 3 on SSV1 |
| Internal | : | False |
| InitiatorPortals | : | {fe80::ac9f:4abc:8e7:447a, fe80::2de4:e3b4:87d0:b299, fe80::d86e:28b1:6c8e:ee36, fe80::f13e:c21d:f0b8:c2e...} |
| iSnsServer | : | {} |
| TargetPortals | : | {DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData} |
| PresenceStatus | : | Present |
| PhysicalName | : | MSFT-05-1991 |
| ServerPortProperties | : | DataCore.Executive.ServerPortPropertiesData |
| RoleCapability | : | Backend, Mirror |
| PortName | : | ssv1msiscsiinitiator |
| Alias | : | Microsoft iSCSI Initiator |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Initiator |
| HostId | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2 |
| Connected | : | True |
| Id | : | 4A58C0F4-59AB-4A16-A559-2ED9778CC2B2:MSFT-05-1991 |
| Caption | : | Microsoft iSCSI Initiator |
| ExtendedCaption | : | Microsoft iSCSI Initiator 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:host4.datacoresoftware.com, iqn.1991-05.com.microsoft.ssv1.datacoresoftware.com, iqn.1991-05.com.microsoft:host2.datacoresoftware.com, iqn.1991-05.com.microsoft:host3} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-22 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv2-2 |
| Alias | : | Server iSCSI Port 2 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1 |
| Connected | : | True |
| Id | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1:MAC:00-15-5D-11-E9-22 |
| Caption | : | Server iSCSI Port 2 |
| ExtendedCaption | : | Server iSCSI Port 2 on SSV2 |
| Internal | : | False |
| IdInfo | : | DataCore.Executive.iSCSI.iScsiPortIdInfo |
| PortConfigInfo | : | DataCore.Executive.iSCSI.PortConfigInfo |
| IScsiPortStateInfo | : | DataCore.Executive.iSCSI.iScsiPortStateInfo |
| iSCSINodes | : | {iqn.1991-05.com.microsoft:host4.datacoresoftware.com, iqn.1991-05.com.microsoft:host2.datacoresoftware.com, ssv1msiscsiinitiator, iqn.1991-05.com.microsoft:host3} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-23 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv2-3 |
| Alias | : | Server iSCSI Port 3 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1 |
| Connected | : | True |
| Id | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1:MAC:00-15-5D-11-E9-23 |
| Caption | : | Server iSCSI Port 3 |
| ExtendedCaption | : | Server iSCSI Port 3 on SSV2 |
| Internal | : | False |
| IdInfo | : | DataCore.Executive.iSCSI.iScsiPortIdInfo |
| PortConfigInfo | : | DataCore.Executive.iSCSI.PortConfigInfo |
| IScsiPortStateInfo | : | DataCore.Executive.iSCSI.iScsiPortStateInfo |
| iSCSINodes | : | {iqn.1991-05.com.microsoft.ssv1.datacoresoftware.com} |
| CapabilityInfo | : | DataCore.Executive.iSCSI.iScsiPortCapabilityInfo |
| PresenceStatus | : | Present |
| PhysicalName | : | MAC:00-15-5D-11-E9-10 |
| ServerPortProperties | : | DataCore.Executive.ServeriScsiPortPropertiesData |
| RoleCapability | : | Frontend, Mirror |
| PortName | : | iqn.2000-08.com.datacore:ssv2-1 |
| Alias | : | Server iSCSI Port 1 |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Target |
| HostId | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1 |
| Connected | : | True |
| Id | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1:MAC:00-15-5D-11-E9-10 |
| Caption | : | Server iSCSI Port 1 |
| ExtendedCaption | : | Server iSCSI Port 1 on SSV2 |
| Internal | : | False |
| InitiatorPortals | : | {fe80::6181:9311:6644:c8d2, fe80::4845:95ea:39c3:6fa6, fe80::706f:1642:d9f4:d1b7, fe80::2920:ddc6:93a7:45df...} |
| iSnsServer | : | {} |
| TargetPortals | : | {DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData, DataCore.Executive.iScsiTargetPortalData...} |
| PresenceStatus | : | Present |
| PhysicalName | : | MSFT-05-1991 |
| ServerPortProperties | : | DataCore.Executive.ServerPortPropertiesData |
| RoleCapability | : | Backend, Mirror |
| PortName | : | iqn.1991-05.com.microsoft:ssv2.datacoresoftware.com |
| Alias | : | Microsoft iSCSI Initiator |
| Description | : | |
| PortType | : | iSCSI |
| PortMode | : | Initiator |
| HostId | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1 |
| Connected | : | True |
| Id | : | 02BE2FB5-73E0-4072-9DDB-4F0B1B9BB0D1:MSFT-05-1991 |
| Caption | : | Microsoft iSCSI Initiator |
| ExtendedCaption | : | Microsoft iSCSI Initiator on SSV2 |
| Internal | : | False |