Share via


New-SpacesPool

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

Detaillierte Beschreibung

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.

Parameter

-FriendlyName<String>

Specifies the friendly name of the storage pool to create.

Aliasse

Keiner

Erforderlich?

true

Position?

1

Standardwert

Keiner

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-NumberOfHotsparesToUse<Int32>

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

Aliasse

Keiner

Erforderlich?

false

Position?

3

Standardwert

Keiner

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-NumberofPhysicalDiskstoUse<Int32>

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

Aliasse

Keiner

Erforderlich?

true

Position?

2

Standardwert

Keiner

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-PhysicalDisks<Object[]>

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

Aliasse

Keiner

Erforderlich?

true

Position?

2

Standardwert

Keiner

Pipelineeingaben akzeptieren?

True (ByValue, ByPropertyName)

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

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

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

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

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

    This cmdlet outputs a StoragePool object.

Beispiele

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