New-SpacesPool

Reference

Module:: StorageSpaces

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.

Parameters

-FriendlyName

Specifies the friendly name of the storage pool to create.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-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
Required:	False
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
Required:	True
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
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Inputs

CimInstance

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

Outputs