New-SpacesPool

New-SpacesPool

Creates a storage pool on the Storage Spaces subsystem.

Sintaxis

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

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

Descripción detallada

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.

Parámetros

-FriendlyName<String>

Specifies the friendly name of the storage pool to create.

Alias

ninguno

¿Requerido?

true

¿Posición?

1

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-NumberOfHotsparesToUse<Int32>

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

Alias

ninguno

¿Requerido?

false

¿Posición?

3

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-NumberofPhysicalDiskstoUse<Int32>

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

Alias

ninguno

¿Requerido?

true

¿Posición?

2

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-PhysicalDisks<Object[]>

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

Alias

ninguno

¿Requerido?

true

¿Posición?

2

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByValue, ByPropertyName)

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

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

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

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

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

    This cmdlet outputs a StoragePool object.

Ejemplos

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