NAME

Get-DcsPool

SYNOPSIS

Returns the data for disk pools.

SYNTAX

Get-DcsPool   [ -Server <Object> ]   [ -Pool <Object> ]   [ -SharedPool <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsPool   [ -Server <Object> ]   [ -Pool <Object> ]   [ -SharedPool <Object> ]   [ -Shared]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsPool   [ -Server <Object> ]   [ -Pool <Object> ]   [ -NonShared]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns the data for disk pools. Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, data for all disk pools belonging to all servers in the default server group connection will be returned.

PARAMETERS

-Server<Object>
ServerHostData object, computer name or ID of the server. The computer name must be unique or the name must be fully qualified. If a server is specified, only data for that server will be returned. The ServerHostData object can be obtained from Get-DcsServer.

Required: false
Position: named
Default value:
Accept pipeline input: false
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 the pool is specified, only data for that pool will be returned.

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

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

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

-Shared<SwitchParameter>
Specify this parameter for data on shared pools only.

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

-NonShared<SwitchParameter>
Specify this parameter for data on non-shared pools only.

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

INPUTS

DiskPoolData : Object that identifies and describes the pool.

OUTPUTS

DiskPoolData : Object that identifies and describes the pool.

NOTES

Also see Set-DcsPoolProperties, Get-DcsChunkAllocation, Get-DcsChunkAllocationMap, Get-DcsChunkReclamationMap, Add-DcsPool, Get-DcsSharedPool.

EXAMPLES


-------------- Example 1 Returns data for a pool specified by name --------------
Get-DcsPool -Pool "Disk pool 1"

The cmdlet is invoked with the parameter Pool. The pool name is "Disk pool 1" which is unique to the server group so the parameter Server is not necessary.
Returns data for "Disk pool 1" on the server "SSV1".


PoolMode:ReadWrite
ServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SharedPoolId:
Alias:Disk pool 1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
TierReservedPct:0
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:False
SMPAApproved:False
Sequencenumber:6942
Id:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
Caption:Disk pool 1
ExtendedCaption:Disk pool 1 on SSV1
Internal:False
   

-------------- Example 2 Returns data for all pools on a server specified by name --------------
Get-DcsPool -Server SSV1

Returns data for all pools on server "SSV1". There are two pools.

PoolMode:ReadWrite
ServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SharedPoolId:
Alias:Disk pool 1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SharedPoolId:
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:False
SMPAApproved:False
Sequencenumber:6942
Id:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{ea7c7a80-bdf3-11e0-8304-00155d11e921}
Caption:Disk pool 1
ExtendedCaption:Disk pool 1 on SSV1
Internal:False
   
PoolMode:ReadWrite
ServerId:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3
SharedPoolId:
Alias:Disk pool 2
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:False
SMPAApproved:False
Sequencenumber:6942
Id:A6EA4E77-BBFF-4F48-91CD-3987E81C1CB3:{8d8cb33b-c37e-11e0-90c4-00155d11e921}
Caption:Disk pool 2
ExtendedCaption:Disk pool 2 on SSV1
Internal:False
   

-------------- Example 3 Returns data for a shared pool --------------
Get-DcsPool -SharedPool shared-pool-1

The cmdlet is invoked with the parameter SharedPool. The name of the shared pool is "shared-pool-1". An object is returned for each server that shares the pool.

PoolMode:ReadWrite
ServerId:F0AE5233-62EC-4006-A0C7-0BD308F84D28
SharedPoolId:{c5d2cc01-0b41-11e3-9829-002590570c2f}
Alias:shared-pool-1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:False
InSharedMode:False
Sequencenumber:41285
Id:F0AE5233-62EC-4006-A0C7-0BD308F84D28:{c5d2cc01-0b41-11e3-9829-002590570c2f}
Caption:shared-pool-1
ExtendedCaption:shared-pool-1 on Heavy
Internal:False
   
PoolMode:ReadWrite
ServerId:45C4A667-7A9B-4BF0-9E6D-EFEA0EF01A0E
SharedPoolId:{c5d2cc01-0b41-11e3-9829-002590570c2f}
Alias:shared-pool-1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:True
Sequencenumber:41284
Id:45C4A667-7A9B-4BF0-9E6D-EFEA0EF01A0E:{c5d2cc01-0b41-11e3-9829-002590570c2f}
Caption:shared-pool-1
ExtendedCaption:shared-pool-1 on Metal
Internal:False
   

-------------- Example 4 Returns data for all shared pools in the server group --------------
Get-DcsPool -Shared

The cmdlet is invoked with the switch parameter Shared and objects are returned for all shared pools on all servers in the default server group. Data for all non-shared pools are excluded.

PoolMode:ReadWrite
ServerId:842E17B3-B000-4553-B711-7BE46FA260FF
SharedPoolId:{b490ba62-8e9a-11e3-bbb8-00155d11e952}
Alias:SharedPool1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:True
Sequencenumber:7181
Id:842E17B3-B000-4553-B711-7BE46FA260FF:{b490ba62-8e9a-11e3-bbb8-00155d11e952}
Caption:SharedPool1
ExtendedCaption:SharedPool1 on SSV1
Internal:False
   
PoolMode:ReadWrite
ServerId:FF212987-2B4F-40DD-A490-A0CA13E58FDF
SharedPoolId:{b490ba62-8e9a-11e3-bbb8-00155d11e952}
Alias:SharedPool1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:True
Sequencenumber:7189
Id:FF212987-2B4F-40DD-A490-A0CA13E58FDF:{b490ba62-8e9a-11e3-bbb8-00155d11e952}
Caption:SharedPool1
ExtendedCaption:SharedPool1 on SSV2
Internal:False
   
PoolMode:ReadWrite
ServerId:842E17B3-B000-4553-B711-7BE46FA260FF
SharedPoolId:{b490ba64-8e9a-11e3-bbb8-00155d11e952}
Alias:SharedPool2
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:True
Sequencenumber:7218
Id:842E17B3-B000-4553-B711-7BE46FA260FF:{b490ba64-8e9a-11e3-bbb8-00155d11e952}
Caption:SharedPool2
ExtendedCaption:SharedPool2 on SSV1
Internal:False
   
PoolMode:ReadWrite
ServerId:FF212987-2B4F-40DD-A490-A0CA13E58FDF
SharedPoolId:{b490ba64-8e9a-11e3-bbb8-00155d11e952}
Alias:SharedPool2
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:128.00 MiB
SectorSize:512 B
MaxTiernumber:3
AutoTieringEnabled:True
IsAuthorized:False
InSharedMode:False
Sequencenumber:7226
Id:FF212987-2B4F-40DD-A490-A0CA13E58FDF:{b490ba64-8e9a-11e3-bbb8-00155d11e952}
Caption:SharedPool2
ExtendedCaption:SharedPool2 on SSV2
Internal:False