NAME

Add-DcsLogicalDisk

SYNOPSIS

Creates a logical disk from a pool or a pass-through disk on a server.

SYNTAX

Add-DcsLogicalDisk   [ -Server <String> ]   -Pool <String>   [ -ReservedSpace <String> ]   [ -Count <UInt32> ]   [ -SectorSize <DataSize> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Add-DcsLogicalDisk   [ -Server <String> ]   -PassThroughDisk <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Creates a logical disk from a pool or a pass-through disk on a server. Multiple logical disks can be created if the source is from a pool. Logical disks can be used when creating virtual disks (see Add-DcsVirtualDisk).

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

-Pool<String>
Name or ID of the pool if used as the storage source of the logical disk. To resolve by name, the name must be unique to the server group or the server must be specified.

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

-ReservedSpace<String>
The amount of space reserved in a pool for exclusive use by the logical disk. This space must be free in the pool. Valid values consist of the number followed by the unit of measurement (MiB, GiB, TiB). Decimals may be used. For example, "100GiB", "1.5TiB", and "500000MiB" are valid sizes. Size can range from a minimum of 1GiB to the size of the virtual disk.

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

-Count<UInt32>
The number of logical disks to create from a pool. If not specified, one logical disk will be created.

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

-SectorSize<DataSize>
The sector size of the logical disk. Valid values are "512", "512B", "4096", or "4KiB". If the unit is not included, it is assumed to represent the number of bytes in the sector. If this parameter is not specified, the sector size of the disk pool will be used.

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

-PassThroughDisk<String>
Physical disk name or ID of the pass-through disk if used as the storage source of the logical disk. To resolve by name, the name must be unique to the server group or the server must be specified.

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

INPUTS

OUTPUTS

LogicalDiskData : Object the identifies and describes the logical disk.

NOTES

Also see Add-DcsVirtualDisk, Get-DcsLogicalDisk, Remove-DcsLogicalDisk.

EXAMPLES


-------------- Example 1 Adds logical disk from pool --------------

Add-DcsLogicalDisk -Server SSV1 -Pool "Disk pool 1" -ReservedSpace 10GiB -Count 3
			

Creates three logical disks from the pool named "Disk pool 1" on the server named "SSV1", each having 10GiB of reserved space in the pool. The server is identified to resolve the disk pool name.

StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:1
MinQuota:10.00 GiB
MaxQuota:0.00 B
TierAffinity:
StorageName:
InReclamation:False
DataStatus:Undefined
PresenceStatus:Present
Size:1.00 PiB
SectorSize:512 B
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
IsMapped:False
Protected:False
Id:LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000001
Caption:Storage source from Disk pool 1 on SSV1
ExtendedCaption:Storage source from Disk pool 1 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:2
MinQuota:10.00 GiB
MaxQuota:0.00 B
TierAffinity:
StorageName:
InReclamation:False
DataStatus:Undefined
PresenceStatus:Present
Size:1.00 PiB
SectorSize:512 B
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
IsMapped:False
Protected:False
Id:LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000002
Caption:Storage source from Disk pool 1 on SSV1
ExtendedCaption:Storage source from Disk pool 1 on SSV1
Internal:False
   
StreamDiskId:
RetentionTime:0
StreamSize:0.00 B
StreamState:NotPresent
PoolId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
VolumeIndex:3
MinQuota:10.00 GiB
MaxQuota:0.00 B
TierAffinity:
StorageName:
InReclamation:False
DataStatus:Undefined
PresenceStatus:Present
Size:1.00 PiB
SectorSize:512 B
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
IsMapped:False
Protected:False
Id:LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.{ea7c7a80-bdf3-11e0-8304-00155d11e921}-00000003
Caption:Storage source from Disk pool 1 on SSV1
ExtendedCaption:Storage source from Disk pool 1 on SSV1
Internal:False
   

-------------- Example 2 Adds logical disk using passthrough disk --------------
Add-DcsLogicalDisk -Server SSV1 -PassThroughDisk "Disk 7"
			

Creates a logical disk from the pass-through disk named "Disk 7" on the server named "SSV1".

PhysicalDiskId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:naa.60030d9056566f6c34345f535356315f
DataStatus:Undefined
PresenceStatus:Present
Size:50.00 GiB
SectorSize:512 B
Description:
DiskStatus:Online
Virtualized:False
ClientAccessRights:NotDefined
Failure:Undefined
VirtualDiskId:
DiskRole:Unknown
ServerHostId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
IsMapped:False
Protected:False
Id:LD:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3_V.DataCore-naa.60030d9056566f6c34345f535356315f
Caption:Storage source from SSV1
ExtendedCaption:Storage source from SSV1
Internal:False