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.
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
You can pipe an array of PhysicalDisk objects to the PhysicalDisks parameter.
Outputs
This cmdlet outputs a StoragePool object.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for