NAME

Add-DcsPoolMember

SYNOPSIS

Adds a physical disk or mirror to an existing pool.

SYNTAX

Add-DcsPoolMember   [ -Server <String> ]   -Pool <String>   -Disk <Object>   [ -Count <Int32> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Add-DcsPoolMember   [ -Server <String> ]   -Pool <String>   -Disk <Object>   [ -MirrorDisk <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Add-DcsPoolMember   [ -Server <String> ]   -Pool <String>   -PoolMember <String>   [ -MirrorDisk <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Adds a physical disk or mirror to an existing pool.

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 to which the disks should be added. 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

-Disk<Object>
PhysicalDiskData object, name, or ID that identifies a physical disk to add to the pool. 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

-Count<Int32>
The Count parameter can limit the number of disks added to the pool using the Disk parameter when the Disks parameter is obtained from the pipeline and includes multiple objects. If not specified, all disks will be added to the pool.

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

-MirrorDisk<String>
Name or ID that identifies a physical disk to be added to the pool as a mirror. To resolve by name, the name must be unique to the server group or the server must be specified. The MirrorDisk parameter can be used with the Disk parameter or PoolMember parameter.

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

-PoolMember<String>
PoolMember ID or caption that identifies the physical disk that is a Member of a disk pool. Use this parameter when adding a mirror to an existing disk in a pool.

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

INPUTS

PhysicalDiskData : Object the identifies the disk.

OUTPUTS

PoolMemberData : Object the identifies and describes the pool Member.

NOTES

Also see Set-DcsPoolProperties, Get-DcsPhysicalDisk, Unlock-DcsPhysicalDisk, Set-DcsPhysicalDiskProperties.

EXAMPLES


-------------- Example 1 Adds one physical disk to a pool --------------
Add-DcsPoolMember -Pool "Disk pool 1" -Disk "WDC WD800AAJS-N8TDA03"

Adds a physical disk named "WDC WD800AAJS-N8TDA03" to the pool named "Disk pool 1". In this case, the physical disk name must be unique in the server group.

DiskPoolId:101796F5-90A6-4929-B28D-98D195834677:{2186893e-985e-11e5-80e7-00155d138910}
DiskInRecoveryId:
DiskTier:2
MemberState:Healthy
Size:200.00 GiB
SectorSize:512 B
IsMirrored:False
Sequencenumber:8684
Id:f155ff13-5cf2-4289-9eba-4252518d6f23
Caption:WDC WD800AAJS-N8TDA03
ExtendedCaption:Pool disk WDC WD800AAJS-N8TDA03 on SSVVM04
Internal:False
   

-------------- Example 2 Adds physical disks by piping objects --------------
Get-DcsPhysicalDisk -Server SSV1 -Type Uninitialized | Add-DcsPoolMember -Pool  "Disk pool 1" -Count 2

The cmdlet Get-DcsPhysicalDisk is invoked to get PhysicalDiskData objects for all the disks of type "uninitialized" on the server "SSV1". Those objects are piped to the cmdlet Add-DcsPoolMember to add two physical disks to the pool "Disk pool 1".

DiskPoolId:8BD7BD0F-F5F9-40DB-B8B0-6ABB74D43F81:{2b28c5b6-a04d-11e1-96c0-00155d11e929}
DiskInRecoveryId:
DiskTier:2
MemberState:Healthy
Size:500.00 GiB
SectorSize:512 B
IsMirrored:False
Sequencenumber:6738
Id:dfc54ce8-314d-4b36-a09d-a40c958f6975
Caption:WDC WD800AAJS-N8TDA02
ExtendedCaption:Pool disk WDC WD800AAJS-N8TDA02 on SSV1
Internal:False
   
DiskPoolId:8BD7BD0F-F5F9-40DB-B8B0-6ABB74D43F81:{2b28c5b6-a04d-11e1-96c0-00155d11e929}
DiskInRecoveryId:
DiskTier:2
MemberState:Healthy
Size:100.00 GiB
SectorSize:512 B
IsMirrored:False
Sequencenumber:6746
Id:d6ca93da-9086-49f7-a80b-00630dcecb66
Caption:WDC WD800AAJS-N8TDA010
ExtendedCaption:Pool disk WDC WD800AAJS-N8TDA010 on SSV1
Internal:False
   

-------------- Example 3 Adds a mirror disk to a pool. --------------
$PM = Get-DcsPoolMember -Pool "Disk pool 1" -Disk "SSV1-WDC100-D1"
Add-DcsPoolMember -Pool $PM.DiskPoolId -PoolMember $PM -MirrorDisk "SSV1-WDC100-D2"

The cmdlet Get-DcsPoolMember is invoked to get the PoolMemberData object for the physical disk named "SSV1-WDC100-D1" in the pool named "Disk pool 1". The object is stored in the variable $PM.

The cmdlet Add-DcsPoolMember is invoked using the object in the variable to get the Disk pool ID for the Pool parameter and the PoolMemberData object for the PoolMember parameter. The MirrorDisk parameter is the physical disk named "SSV1-WDC100-D2". The updated PoolMemberData object is returned.

DiskPoolId:8BD7BD0F-F5F9-40DB-B8B0-6ABB74D43F81:{2b28c5b6-a04d-11e1-96c0-00155d11e929}
DiskInRecoveryId:{0b89a4a7-242e-4f8b-926f-ecc9397d5cdf}
DiskTier:2
MemberState:OutOfSync
Size:100.00 GiB
SectorSize:512 B
IsMirrored:True
Sequencenumber:7335
Id:ed78b36a-613a-4c28-b4d8-f00d0fc5fbec
Caption:SSV1-WDC100-D1|SSV1-WDC100-D2
ExtendedCaption:Pool mirror SSV1-WDC100-D1|SSV1-WDC100-D2 on SSV1
Internal:False