New-SpacesPool

Creates a storage pool on the Storage Spaces subsystem.

Syntax

New-SpacesPool
   [-FriendlyName] <String>
   [-NumberofPhysicalDiskstoUse] <Int32>
   [[-NumberOfHotsparesToUse] <Int32>]
New-SpacesPool
   [-FriendlyName] <String>
   [-PhysicalDisks] <Object[]>
   [[-NumberOfHotsparesToUse] <Int32>]

Description

The New-SpacesPool cmdlet creates a storage pool on the Storage Spaces subsystem with three or more eligible physical disks. The storage pool can then be used to create storage spaces.

Examples

Example 1 - Create a storage pool with five physical disks

PS C:\>New-SpacesPool -FriendlyName MyPool -NumberOfPhysicalDisksToUse 5

This example creates a storage pool named MyPool using five available physical disks from the Available Disks (primordial) storage pool.

Example 2 - Create a storage pool with an array of PhysicalDisk objects

PS C:\>New-SpacesPool -FriendlyName MyPool -PhysicalDisks $DiskArray

This example creates a storage pool named MyPool using the specified array of PhysicalDisk objects.

Example 3 - Create a storage pool with two hot spares

PS C:\>New-SpacesPool -FriendlyName MyPool -NumberofPhysicalDisksToUse 8 -NumberOfHotsparesToUse 2

This example creates a storage pool named MyPool using eight physical disks and assigns two physical disks to the pool for use as hot-spares in the event of a physical disk failure.

Required Parameters

-FriendlyName

Specifies the friendly name of the storage pool to create.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NumberofPhysicalDiskstoUse

Specifies how many physical disks to use to create the storage pool.

Type:Int32
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PhysicalDisks

Specifies the PhysicalDisk objects to use to create the storage pool.

Type:Object[]
Position:2
Default value:None
Accept pipeline input:True (ByValue, ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-NumberOfHotsparesToUse

Specifies how many physical disks to designate as hot spares, which are available to automatically replace failed disks.

Type:Int32
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_PhysicalDisk

You can pipe an array of PhysicalDisk objects to the PhysicalDisks parameter.

Outputs

Microsoft.Management.Infrastructure.CimInstance#root/microsoft/windows/storage/MSFT_StoragePool

This cmdlet outputs a StoragePool object.