New-SCStoragePool
Creates a storage pool.
Syntax
New-SCStoragePool
[-VMMServer <ServerConnection>]
-Name <String>
[-Description <String>]
-StorageArray <StorageArray>
-StoragePhysicalDisk <StoragePhysicalDisk[]>
-StorageClassification <StorageClassification>
[-FaultDomainAwareness <FaultDomainAwarenessType>]
[-InterleaveDefaultKB <UInt64>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCStoragePool cmdlet creates a storage pool.
Examples
Example 1: Create pool from physical disks
PS C:\> $Disks = Get-SCStoragePhysicalDisk | where {$_.CanPool -eq $True}
PS C:\> New-SCStoragePool -StoragePhysicalDisk $Disks -Name "Pool01"The first command gets all physical disk objects that can be pooled and stores the objects in the $Disks variable.
The second command creates a storage pool named Pool01 with the physical disks stored in $Disks.
Parameters
-Description
Specifies a description for the storage pool.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FaultDomainAwareness
Specifies the default fault domain for new virtual disks created in this storage pool. The acceptable values for this parameter are:
- 1: PhysicalDisk
- 2: StorageEnclosure
- 3: Node
| Type: | FaultDomainAwarenessType |
| Accepted values: | NotSupported, PhysicalDisk, StorageEnclosure, StorageScaleUnit |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InterleaveDefaultKB
Specifies the default interleave size, in kilobytes, for new virtual disks created in this storage pool,
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a VMM object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageArray
Specifies a storage array object. This can be a Fibre Channel or iSCSI storage sub-system that is used to store virtual machine configuration and virtual disks.
| Type: | StorageArray |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageClassification
Specifies a storage classification object.
| Type: | StorageClassification |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StoragePhysicalDisk
Specifies an array of physical disks (spinning media or solid state).
| Type: | StoragePhysicalDisk[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
StoragePool
This cmdlet returns a StoragePool object.