NAME

Add-DcsPool

SYNOPSIS

Creates a disk pool.

SYNTAX

Add-DcsPool   -Server <String>   -Name <String>   [ -Description <String> ]   [ -StorageAllocationUnitSize <UInt32> ]   [ -SectorSize <UInt32> ]   [ -MaxTiernumber <Int32> ]   [ -TierReservedPct <Int32> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ] [<CommonParameters>]

DESCRIPTION

Creates a disk pool. Disks can be added to the pool with Add-DcsPoolMember. Properties can be customized with Set-DcsPoolProperties.

PARAMETERS

-Server<String>

Computer name or ID of the server. The computer name must be unique or the name must be fully qualified.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Name<String>

Name to assign to the disk pool. The disk pool will be created on the specified server.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Description<String>

Description of the disk pool.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-StorageAllocationUnitSize<UInt32>

number of megabytes to assign as the storage allocation unit (SAU) size of the disk pool. Possible values are "4", "8", "16", "32", "64", "128", "256", "512", or "1024" MiB. If the value is not specified, the pool will be created with the default size of 1024 MiB.

Required: false

Position: named

Default value: 1024

Accept pipeline input: false

Accept wildcard characters: false

-SectorSize<UInt32>

Use this parameter to set the sector size for the disk pool. Valid values are "512" and "4096", which represent the number of bytes in the sector. If this parameter is not specified, the default of "512" will be used.

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. If this parameter is not specified, the default of "3" will be used.

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 to use for future virtual disk allocations. A valid value is a number between 0 and 20 which refers to the percentage. For example, to reserve 20% space in each tier, enter the value "20". If this parameter is not specified, the default of "0" will be used, which will not reserve any space in the tiers.

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

 

-<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

DiskPoolData : Object that identifies and describes the disk pool.

NOTES

Also see Get-DcsPool, Set-DcsPoolProperties.

EXAMPLES

Add-DcsPool -Server SSVVM011 -Name "Disk pool 1"
		

Add-DcsPool -Server "SSVVM04" -Name "VM04Pool1" -StorageAllocationUnitSize 128 -SectorSize 4096 -MaxTiernumber 5 -TierReservedPct 20