New-StoragePool

New-StoragePool
    [-StorageSubSystemFriendlyName] <String[]>
    -FriendlyName <String>
    -PhysicalDisks <CimInstance[]>
    [-Usage <Usage>]
    [-OtherUsageDescription <String>]
    [-ProvisioningTypeDefault <ProvisioningType>]
    [-MediaTypeDefault <MediaType>]
    [-EnclosureAwareDefault <Boolean>]
    [-FaultDomainAwarenessDefault <FaultDomainType>]
    [-ResiliencySettingNameDefault <String>]
    [-LogicalSectorSizeDefault <UInt64>]
    [-WriteCacheSizeDefault <UInt64>]
    [-AutoWriteCacheSize <Boolean>]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

New-StoragePool
    -StorageSubSystemUniqueId <String[]>
    -FriendlyName <String>
    -PhysicalDisks <CimInstance[]>
    [-Usage <Usage>]
    [-OtherUsageDescription <String>]
    [-ProvisioningTypeDefault <ProvisioningType>]
    [-MediaTypeDefault <MediaType>]
    [-EnclosureAwareDefault <Boolean>]
    [-FaultDomainAwarenessDefault <FaultDomainType>]
    [-ResiliencySettingNameDefault <String>]
    [-LogicalSectorSizeDefault <UInt64>]
    [-WriteCacheSizeDefault <UInt64>]
    [-AutoWriteCacheSize <Boolean>]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

New-StoragePool
    -StorageSubSystemName <String[]>
    -FriendlyName <String>
    -PhysicalDisks <CimInstance[]>
    [-Usage <Usage>]
    [-OtherUsageDescription <String>]
    [-ProvisioningTypeDefault <ProvisioningType>]
    [-MediaTypeDefault <MediaType>]
    [-EnclosureAwareDefault <Boolean>]
    [-FaultDomainAwarenessDefault <FaultDomainType>]
    [-ResiliencySettingNameDefault <String>]
    [-LogicalSectorSizeDefault <UInt64>]
    [-WriteCacheSizeDefault <UInt64>]
    [-AutoWriteCacheSize <Boolean>]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

New-StoragePool
    -InputObject <CimInstance[]>
    -FriendlyName <String>
    -PhysicalDisks <CimInstance[]>
    [-Usage <Usage>]
    [-OtherUsageDescription <String>]
    [-ProvisioningTypeDefault <ProvisioningType>]
    [-MediaTypeDefault <MediaType>]
    [-EnclosureAwareDefault <Boolean>]
    [-FaultDomainAwarenessDefault <FaultDomainType>]
    [-ResiliencySettingNameDefault <String>]
    [-LogicalSectorSizeDefault <UInt64>]
    [-WriteCacheSizeDefault <UInt64>]
    [-AutoWriteCacheSize <Boolean>]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [<CommonParameters>]

The New-StoragePool cmdlet creates a new storage pool using a group of physical disks exposed by a specific storage subsystem.

PS C:\> $PhysicalDisks = (Get-PhysicalDisk -CanPool $True)
PS C:\> New-StoragePool -FriendlyName CompanyData -StorageSubsystemFriendlyName "Windows Storage*" -PhysicalDisks $PhysicalDisks

The first line uses the Get-PhysicalDisk cmdlet to get all PhysicalDisk objects that are not yet in a (concrete) storage pool and assigns the array of objects to the $PhysicalDisks variable.

The second line creates a new storage pool using the $PhysicalDisks variable to specify the disks to include from the WindowsStorage subsystem (specified with a wildcard * to remove the need to modify the friendly name for different computers).

This example creates a new storage pool named CompanyData using the Storage Spaces subsytem, using the minimum parameters, and assuming that there are no other storage subsystems attached to the computer that have available disks.

PS C:\> $PhysicalDisks = (Get-PhysicalDisk -CanPool $True)
PS C:\> New-StoragePool -FriendlyName CompanyData -StorageSubsystemFriendlyName "Windows Storage*" -PhysicalDisks $PhysicalDisks -ResiliencySettingNameDefault Mirror -ProvisioningTypeDefault Thin -Verbose

This example creates a new storage pool named CompanyData using the Windows Storage subsystem and sets default values for virtual disk creation.

The first line ($PhysicalDisks = …) gets the storage subsystem object for the Windows Storage subsystem, passes it to the Get-PhysicalDisk cmdlet, which then gets the physical disks in the specified subsystem that are available to add to a storage pool, and assigns these disks to the $PhysicalDisks variable.

The second line of the command has five parts, connected by the pipeline (|).

The first part (New-StoragePool …) creates a new storage pool using the physical disks in the $PhysicalDisks variable and then passes the new storage pool down the pipeline. All of the following commands are logically part of one command and should be entered as such.

The second part (New-VirtualDisk …) creates a new virtual disk on the passed in storage pool and then passes the new virtual disk down the pipeline. The third part (Initialize-Disk …) initializes the disk that was passed in and then passes the disk down the pipeline.

The fourth part (New-Partition …) creates a new partition on the disk that was passed in, assigns it the next available drive letter, and then passes the partition down the pipeline.

The final part of the command (Format-Volume) formats the partition that was passed in.

PS C:\> $PhysicalDisks = Get-StorageSubSystem -FriendlyName "Windows Storage*" | Get-PhysicalDisk -CanPool $True
PS C:\> New-StoragePool -FriendlyName "CompanyData" -StorageSubsystemFriendlyName "Windows Storage*" -PhysicalDisks $PhysicalDisks | New-VirtualDisk -FriendlyName "UserData" -Size 100GB -ProvisioningType Thin | Initialize-Disk -PassThru | New-Partition -AssignDriveLetter -UseMaximumSize | Format-Volume

This example creates a new storage pool, and then makes use of the pipeline to create a new virtual disk in the pool, initialize the disk, create a new partition on the disk, and then format the new partition (volume). Alternatively you can use the New-Volume cmdlet to achieve a similar result in a single command.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

You can use the pipeline operator to pass one or more MSFT_PhysicalDisk objects to the PhysicalDisks parameter.

You can use the pipeline operator to pass an MSFT_StorageSubsystem object to the InputObject parameter.

This cmdlet returns an object representing the newly created storage pool.

• When used in Failover Cluster, cmdlets from the Storage module operate on cluster level (all servers in the cluster).