NAME

Set-DcsPoolProperties

SYNOPSIS

Sets the properties of a disk pool.

SYNTAX

Set-DcsPoolProperties   [ -Server <String> ]   -Pool <Object>   [ -NewName <String> ]   [ -Description <String> ]   [ -MaxTiernumber <Int32> ]   [ -TierReservedPct <Int32> ]   [ -SMPAApproved <Boolean> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets the properties of a disk pool. Specify the parameters to set or change.

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<Object>
DiskPoolData object, name, or ID that identifies the disk pool. To resolve by name, the name must be unique to the server group or the server must be specified. The DiskPoolData object can be obtained from Get-DcsPool.

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

-NewName<String>
The new name for the disk pool. The name must be unique in the server group.

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

-Description<String>
Use this parameter to set a description of the pool. To remove the description, use an empty string as the value; for example "".

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

-MaxTiernumber<Int32>
Use this parameter to set a maximum number of tiers for the disk pool. Up to 15 tiers are allowed in a pool.

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

-TierReservedPct<Int32>
Use this parameter to reserve a percentage of space in each pool tier (except the lowest tier) to use for future virtual disk allocations. A valid value is a number between 0 and 95 which refers to the percentage. For example, to reserve 20% space in each tier, enter the value "20".

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

-SMPAApproved<Boolean>
Use this parameter to confirm that the pool is an actively shared pool containing disks that meet the requirements of a shared multi-port array. Specify $true if the pool is intended to be used as an actively shared pool and that all pool disks meet the requirements of a shared multi-port array. Specify $false to remove the acknowledgement.

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

DiskPoolData : Object that identifies the pool.

OUTPUTS

DiskPoolData : Object that identifies the pool.

NOTES

Also see Get-DcsPool.

EXAMPLES


-------------- Example 1 Sets properties for a pool specified by name --------------
Set-DcsPoolProperties -Server SSV1 -Pool "Disk pool 1" -NewName "SSV1 SSD Pool 1" -MaxTiernumber 5 -TierReservedPct 10
		

Sets the pool properties for the pool named "Disk pool 1" on the server "SSV1". The pool name is changed to "SSV1 SSD Pool 1". The maximum number of tiers in the pool is set to 5 and the percentage of preserved space in each tier is set to 10%.

PoolMode:ReadWrite
ServerId:8BFC6F8B-F0F3-48D9-AE9A-635BC66557C4
SharedPoolId:
Alias:SSV1 SSD Pool 1
Description:
PresenceStatus:Present
PoolStatus:Running
Type:Dynamic
ChunkSize:64 MiB
MaxTiernumber:5
TierReservedPct:10
AutoTieringEnabled:True
IsAuthorized:True
InSharedMode:False
Sequencenumber:13194
Id:8BFC6F8B-F0F3-48D9-AE9A-635BC66557C4:{5b98d064-c0ce-11e3-889b-00155d651603}
Caption:SSV1 SSD Pool 1
ExtendedCaption:SSV1 SSD Pool 1 on SSV1
Internal:False
   

-------------- Example 2 Sets properties for all pools by piping objects --------------
Get-DcsPool | Set-DcsPoolProperties -MaxTiernumber 3
		

The cmdlet Get-DcsPool is invoked without parameters to obtain DiskPoolData objects for all pools in the server group. The objects are piped to Set-DcsPoolProperties to set the maximum number of tiers for all pools to 3.

PoolMode:ReadWrite
ServerId:C553D471-3527-47EC-9326-D53E04204F2B
SharedPoolId:
Alias:SSV2 SSD 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:C553D471-3527-47EC-9326-D53E04204F2B:{9437d954-ca79-11e0-857f-00155d11e923}
Caption:SSV2 SSD Pool 1
ExtendedCaption:SSV2 SSD Pool 1 on SSV2
Internal:False
   
PoolMode:ReadWrite
ServerId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
SharedPoolId:
Alias:SSV1 SSD 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:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:{91e63003-ca79-11e0-a962-00155d11e921}
Caption:SSV1 SSD Pool 1
ExtendedCaption:SSV1 SSD Pool 1 on SSV1
Internal:False