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