Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

New-SpacesPool

Published: February 6, 2013

Updated: February 6, 2013

Applies To: Windows 8, Windows Server 2012

New-SpacesPool

Creates a storage pool on the Storage Spaces subsystem.

Syntax

Parameter Set: ByDiskArray
New-SpacesPool [-FriendlyName] <String> [-PhysicalDisks] <Object[]> [[-NumberOfHotsparesToUse] <Int32> ] [ <CommonParameters>]

Parameter Set: ByLocalStorage
New-SpacesPool [-FriendlyName] <String> [-NumberofPhysicalDiskstoUse] <Int32> [[-NumberOfHotsparesToUse] <Int32> ] [ <CommonParameters>]




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

Parameters

-FriendlyName<String>

Specifies the friendly name of the storage pool to create.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NumberOfHotsparesToUse<Int32>

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


Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-NumberofPhysicalDiskstoUse<Int32>

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


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PhysicalDisks<Object[]>

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


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

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

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


Outputs

The output type is the type of the objects that the cmdlet emits.

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

    This cmdlet outputs a StoragePool object.


Notes

  • The StorageSpaces module is a downloadable module available for use with Windows Server 2012 and Windows 8. You can download the module from the Script Center.

Examples

Example 1 – Create a storage pool with five physical disks

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


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

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

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


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

Example 3 – Create a storage pool with two hot spares

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.


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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.