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