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