NAME

Get-DcsLogicalDisk

SYNOPSIS

Returns logical disk (storage source) data.

SYNTAX

Get-DcsLogicalDisk   [ -Server <Object> ]   [ -VirtualDisk <Object> ]   [ -Pool <Object> ]   [ -LogicalDisk <Object> ]   [ -WithCdpEnabled <Boolean> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns logical disk (storage source) data. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, logical disk data will be returned for all servers in the default connection.

PARAMETERS

-Server<Object>
Computer name or ID of a server. The computer name must be unique or the name must be fully qualified. If specified, only data for the designated 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 the designated virtual disk will be returned.

Required: false
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Pool<Object>
DiskPoolData object, name or ID that identifies a disk pool. To resolve by name, the name must be unique to the server group or the server must be specified. If a disk pool is specified, only data for that pool will be returned.

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

-LogicalDisk<Object>
LogicalDiskData object, ID or caption that identifies a logical disk. If specified, only data for that logical disk will be returned.

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

-WithCdpEnabled<Boolean>
Use this parameter to return logical disk data based on the Continuous Data Protection (CDP) setting. Specify $true to return data for logical disks with CDP enabled or $false to return data for logical disks with CDP disabled.

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

LogicalDiskData : Object the identifies and describes the logical disk.

NOTES

Also see Get-DcsMirror, Get-DcsVirtualDiskLogicalUnit, Get-DcsChunkAllocationMap, Add-DcsVirtualDisk, Remove-DcsLogicalDisk. Note: The RetentionTime is the returned object is not to be confused with the Retention Period of a CDP-enabled virtual disk. See the examples of Get-DcsPerformanceCounter for an example to get the up-to-date Retention Period of a logical disk.

EXAMPLES


-------------- Example 1 Returns data for a pool specified by name --------------
Get-DcsLogicalDisk -Server SSV1 -Pool "Disk pool 1"
		

Returns data for all logical disks created from "Disk pool 1" on server "SSV1".

StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:45
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:0dc5596489cb4d8ba0346f80eb47ad46
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002D
Caption:Virtual disk 1 on SSV1
ExtendedCaption:Virtual disk 1 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:46
MinQuota:25.00 GiB
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:a6c21da23ec84baa80ab6a5c8c8c605c
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002E
Caption:Virtual disk 2 on SSV1
ExtendedCaption:Virtual disk 2 on SSV1
Internal:False
   
StreamDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000031
RetentionTime:36000000000
StreamSize:2.50 GiB
StreamState:Active
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:47
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:635134ab2cad4b5d81af73ae5f09bd6f
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:True
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-0000002F
Caption:Virtual disk 3 on SSV1
ExtendedCaption:Virtual disk 3 on SSV1
Internal:False
   
StreamDiskId:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000033
RetentionTime:36000000000
StreamSize:2.50 GiB
StreamState:Active
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:50
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:54893a865cc4412d83b43ba09179996d
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:False
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000032
Caption:Virtual disk 3 @ 8/16/2011 10:10:20 AM on SSV1
ExtendedCaption:Virtual disk 3 @ 8/16/2011 10:10:20 AM on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:51
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:Undefined
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:False
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000033
Caption:Log history of Virtual disk 3 @ 8/16/2011 10:10:20 AM on SSV1
ExtendedCaption:Log history of Virtual disk 3 @ 8/16/2011 10:10:20 AM on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:49
MinQuota:2.50 GiB
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:Undefined
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:False
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000031
Caption:Log history of Virtual disk 3 on SSV1
ExtendedCaption:Log history of Virtual disk 3 on SSV1
Internal:False
   

-------------- Example 2 Returns data for all virtual disks of a certain kind by piping objects --------------
Get-DcsVirtualDisk -Kind Snapshot | Get-DcsLogicalDisk
		

The cmdlet Get-DcsVirtualDisk is used to get virtual disk data for all snapshots in the server group. This data is piped to the cmdlet Get-DcsLogicalDisk resulting in logical disk data for all snapshots in the server group.

StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:52
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:ff93ddd9444b46cab5374a04f75cb20d
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:False
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000034
Caption:Virtual disk 1 @ 8/16/2011 10:16:12 AM on SSV1
ExtendedCaption:Virtual disk 1 @ 8/16/2011 10:16:12 AM on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:54
MinQuota:0.00 B
MaxQuota:0.00 B
TierAffinity:{1, 2, 3}
StorageName:
InReclamation:False
DataStatus:UpToDate
PresenceStatus:Present
Size:1.00 PiB
Description:
DiskStatus:Online
Virtualized:True
ClientAccessRights:ReadWrite
Failure:Healthy
VirtualDiskId:47994570d6b54c59b7e8f8333afd3b9e
DiskRole:First
ServerHostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
IsMapped:False
Protected:True
Id:LD:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000036
Caption:Virtual disk 2 @ 8/16/2011 10:16:26 AM on SSV1
ExtendedCaption:Virtual disk 2 @ 8/16/2011 10:16:26 AM on SSV1
Internal:False