Windows PowerShell is a powerful tool for automating tasks and managing Windows-based systems. It provides a wide range of commands that allow users to manage their systems more efficiently. One of these commands is New-StoragePool, which is used to create a new storage pool.
A storage pool is a collection of physical disks that can be used to create virtual disks. It provides a way to manage multiple disks as a single unit, allowing users to create virtual disks that span multiple physical disks. This can be used to increase storage capacity and performance, as well as to provide redundancy and fault tolerance.
Syntax
The syntax for the New-StoragePool command is as follows:
New-StoragePool [-FriendlyName] <String> [-StorageSubSystem] <StorageSubSystem> [-PhysicalDisks] <PhysicalDisk[]> [-ProvisioningTypeDefault] <String> [-ResiliencySettingNameDefault] <String> [-WriteCacheSizeDefault] <UInt64> [-NumberOfColumnsDefault] <UInt32> [-NumberOfGroupsDefault] <UInt32> [-NumberOfDataCopiesDefault] <UInt32> [-NumberOfCacheGroupsDefault] <UInt32> [-NumberOfCacheColumnsDefault] <UInt32> [-NumberOfDataColumnsDefault] <UInt32> [-AutoConfigureCacheSize] <Boolean> [-AutoConfigureDataSize] <Boolean> [-AutoConfigureWriteCacheSize] <Boolean> [-AutoConfigureNumberOfColumns] <Boolean> [-AutoConfigureNumberOfGroups] <Boolean> [-AutoConfigureNumberOfDataCopies] <Boolean> [-AutoConfigureNumberOfCacheGroups] <Boolean> [-AutoConfigureNumberOfCacheColumns] <Boolean> [-AutoConfigureNumberOfDataColumns] <Boolean> [-CimSession] <CimSession[]> [-ThrottleLimit] <Int32> [-AsJob] [-WhatIf] [-Confirm] [<CommonParameters>]
Parameters
The New-StoragePool command has the following parameters:
| Parameter | Description |
|---|---|
| FriendlyName | The friendly name of the storage pool. |
| StorageSubSystem | The storage subsystem to use for the storage pool. |
| PhysicalDisks | The physical disks to add to the storage pool. |
| ProvisioningTypeDefault | The default provisioning type for the storage pool. |
| ResiliencySettingNameDefault | The default resiliency setting name for the storage pool. |
| WriteCacheSizeDefault | The default write cache size for the storage pool. |
| NumberOfColumnsDefault | The default number of columns for the storage pool. |
| NumberOfGroupsDefault | The default number of groups for the storage pool. |
| NumberOfDataCopiesDefault | The default number of data copies for the storage pool. |
| NumberOfCacheGroupsDefault | The default number of cache groups for the storage pool. |
| NumberOfCacheColumnsDefault | The default number of cache columns for the storage pool. |
| NumberOfDataColumnsDefault | The default number of data columns for the storage pool. |
| AutoConfigureCacheSize | Indicates whether the cache size should be automatically configured. |
| AutoConfigureDataSize | Indicates whether the data size should be automatically configured. |
| AutoConfigureWriteCacheSize | Indicates whether the write cache size should be automatically configured. |
| AutoConfigureNumberOfColumns | Indicates whether the number of columns should be automatically configured. |
| AutoConfigureNumberOfGroups | Indicates whether the number of groups should be automatically configured. |
| AutoConfigureNumberOfDataCopies | Indicates whether the number of data copies should be automatically configured. |
| AutoConfigureNumberOfCacheGroups | Indicates whether the number of cache groups should be automatically configured. |
| AutoConfigureNumberOfCacheColumns | Indicates whether the number of cache columns should be automatically configured. |
| AutoConfigureNumberOfDataColumns | Indicates whether the number of data columns should be automatically configured. |
| CimSession | The CIM session to use for the command. |
| ThrottleLimit | The maximum number of concurrent operations that can be established to run the cmdlet. |
| AsJob | Indicates that the command should be run as a background job. |
| WhatIf | Indicates that the command should be run without making any changes. |
| Confirm | Indicates that the user should be prompted for confirmation before running the command. |
Inputs
The New-StoragePool command requires the following inputs:
- FriendlyName
- StorageSubSystem
- PhysicalDisks
- ProvisioningTypeDefault
- ResiliencySettingNameDefault
- WriteCacheSizeDefault
- NumberOfColumnsDefault
- NumberOfGroupsDefault
- NumberOfDataCopiesDefault
- NumberOfCacheG