NAME
Get-DcsVirtualLogicalUnit
SYNOPSIS
Returns front-end or mirror path information for logical disks.
SYNTAX
Get-DcsVirtualLogicalUnit [ -InitiatorPort <String> ] [ -TargetPort <String> ] [ -InitiatorHost <String> ] [ -TargetHost <String> ] [ -VirtualDisk <Object> ] [ -VirtualLogicalUnit <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Returns front-end or mirror path information for logical disks. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, path data for all logical disks on all servers in the default connection will be returned.
PARAMETERS
- -InitiatorPort<String>
- Name, ID, or address of an initiator port. To uniquely identify a port by name, the initiator host must be specified. If the port is specified, only data for that port will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -TargetPort<String>
- Name, ID, or address of a target port. To uniquely identify a port by name, the target host must be specified. If the port is specified, only data for that port will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -InitiatorHost<String>
- Computer name or ID of a server, or the name or ID of a client host used as an initiator. The computer name of a server must be unique or the name must be fully qualified. If the initiator host is specified, only data for that server or client host will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -TargetHost<String>
- Computer name or ID of the server used as a target. The computer name must be unique or the name must be fully qualified. If specified, data for that server will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -VirtualDisk<Object>
- VirtualDiskData object, name, or ID that identifies a virtual disk. If specified, only data for that virtual disk will be returned.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -VirtualLogicalUnit<String>
- ID or name (caption) that identifies the virtual logical unit. If specified, only data for that virtual logical unit will be returned.
-
- 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
VirtualDiskData : Object that identifies and describes the virtual disk.
OUTPUTS
VirtualLogicalDiskData : Object the identifies and describing the path of a logical disk on a server.
NOTES
Also see Get-DcsLogicalDisk, Add-DcsVirtualLogicalUnit, Remove-DcsVirtualLogicalUnit.
EXAMPLES
-------------- Example 1 Returns data for paths using a specific initiator port on a specific initiator host --------------
Get-DcsVirtualLogicalUnit -InitiatorPort "iSCSI Port 1" -InitiatorHost Host3
Returns virtual logical unit path data for the initiator port named "iSCSI Port 1" on the machine "Host3".
| LogicalDiskId | : | LD:781D998D-3920-46BB-9F26-88BC591772B6_V.{315f03ec-bdf5-11e0-9dc3-00155d11e923}-0000001E |
| VirtualTargetDeviceId | : | 20bbc66f-673a-46de-b80d-b9ff62aa16fb |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | False |
| Enabled | : | True |
| Id | : | 091e5bab-2669-4697-bb97-7b36f6931e18 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV2 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV2 | LUN 0 |
| Internal | : | False |
| LogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000018 |
| VirtualTargetDeviceId | : | 14773e8b-788b-45d1-b361-38240474a842 |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | bf3d332b-ebe7-470a-b7f1-2d8790c33bcf |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV1 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV1 | LUN 0 |
| Internal | : | False |
| LogicalDiskId | : | LD:781D998D-3920-46BB-9F26-88BC591772B6_V.{315f03ec-bdf5-11e0-9dc3-00155d11e923}-0000001E |
| VirtualTargetDeviceId | : | 99429536-660b-4d30-ab7b-9efd31b492a6 |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | False |
| Enabled | : | True |
| Id | : | 03f537e3-f435-40c3-a325-c66907b43b98 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV2 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV2 | LUN 0 |
| Internal | : | False |
| LogicalDiskId | : | LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000018 |
| VirtualTargetDeviceId | : | 7a42bf89-106e-4827-987f-ab51980f4508 |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | cafdd48c-4487-4ac8-b957-6c1b8b78107b |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 1 on SSV1 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 1 on SSV1 | LUN 0 |
| Internal | : | False |
-------------- Example 2 Returns data for a specific virtual disk type and a specific initiator host --------------
Get-DcsVirtualDisk -Kind Rollback | Get-DcsVirtualLogicalUnit -InitiatorHost Host3
The cmdlet Get-DcsVirtualDisk is invoked with the Kind parameter set to Rollback to get data for all virtual disks which are rollbacks. This data is piped to the cmdlet Get-DcsVirtualLogicalUnit with the InitiatorHost parameter set to Host3. This results in data for all rollbacks that are served to the client host named Host3.
| LogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000032 |
| VirtualTargetDeviceId | : | dcf8c909-c610-4b53-9aa8-e49e902770b2 |
| Lun | : | 1 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | 874f6c93-96ac-458c-81cc-255c6257e7a5 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 4 on SSV1 | LUN 1 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 4 on SSV1 | LUN 1 |
| Internal | : | False |
| LogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000032 |
| VirtualTargetDeviceId | : | 5faead98-f219-4a7e-92df-b05cc07b30e3 |
| Lun | : | 1 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | f3faafe4-6ef0-45bd-baf7-6604fd1dbdca |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV1 | LUN 1 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV1 | LUN 1 |
| Internal | : | False |
| LogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000003B |
| VirtualTargetDeviceId | : | dcf8c909-c610-4b53-9aa8-e49e902770b2 |
| Lun | : | 2 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | efbacf1c-10e9-417a-9452-86b261fb58a9 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 4 on SSV1 | LUN 2 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 4 on SSV1 | LUN 2 |
| Internal | : | False |
| LogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000003B |
| VirtualTargetDeviceId | : | 23c5a1d2-4c15-444f-ac0d-2eb5d3579ac6 |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | a406c5ac-4ea6-4bbf-91df-09518890fa17 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV1 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 2 on SSV1 | LUN 0 |
| Internal | : | False |
-------------- Example 3 Returns data for a specific virtual disk and a specific initiator host and target host --------------
Get-DcsVirtualLogicalUnit -InitiatorHost Host3 -TargetHost SSV1 -VirtualDisk "Virtual disk 3"
Returns path data for virtual disk named "Virtual disk 3" which is served to the initiator host named "Host3" from the target host named "SSV1".
| LogicalDiskId | : | LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002F |
| VirtualTargetDeviceId | : | 5faead98-f219-4a7e-92df-b05cc07b30e3 |
| Lun | : | 0 |
| Access | : | ReadWrite |
| Type | : | Client |
| Preferred | : | True |
| Enabled | : | True |
| Id | : | 6c5fd817-fb2f-489e-b3f0-53543dc0c610 |
| Caption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV1 | LUN 0 |
| ExtendedCaption | : | iSCSI Port 1 on Host3 | Server iSCSI Port 3 on SSV1 | LUN 0 |
| Internal | : | False |