New-SCStorageTier
Creates a Storage Tier configured with Virtual Machine Manager Server.
Syntax
New-SCStorageTier
[-VMMServer <ServerConnection>]
-MediaType <StoragePhysicalDiskMediaType>
-SizeMB <UInt64>
[-ResiliencySettingName <String>]
[-PhysicalDiskRedundancy <UInt16>]
[-NumberOfColumns <UInt16>]
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCStorageTier
[-VMMServer <ServerConnection>]
-StorageTierFriendlyName <String>
-StorageTierSizeInMB <UInt64>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCStorageTier cmdlet creates a Storage Tier configured by using Virtual Machine Manager Server. As part of creating the Storage Tier, you can specify the media type (HDD, SSD) underlying the storage tier and the resiliency (Simple, Mirroring, or Parity) to define the availability characteristics of the tier.
Examples
Example 1: Create a storage tier on non-S2D system
PS C:\> New-SCStorageTier -MediaType "SSD" -SizeMB 1024 -NumberOfColumns 2 -PhysicalDiskRedundancyThis command creates a storage tier on a non-S2D system.
Example 2: Create a storage tier on S2D system
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Performance" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "191de146-dbec-4955-a347-70edd4315c41"This command creates a storage tier on an S2D system.
Parameters
-JobGroup
Specifies an identifier for a series of commands that run as a set just before the final command that includes the same job group identifier runs.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies a variable in which job progress is tracked and stored.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MediaType
Specifies an array of storage physical disk media type objects. The acceptable values for this parameter are:
- HDD
- SSD
| Type: | StoragePhysicalDiskMediaType |
| Accepted values: | Unknown, HDD, SSD |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NumberOfColumns
Specifies the number of columns for a virtual disk.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalDiskRedundancy
Specifies the number of physical disk failures that a virtual disk can sustain.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-ResiliencySettingName
Specifies the resiliency setting for a virtual disk. The acceptable values for this parameter are:
- Mirror
- Parity
| Type: | String |
| Accepted values: | Simple, Mirror, Parity |
| 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 |
-SizeMB
Specifies the size, in megabytes, of a storage volume or file share.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageTierFriendlyName
Specifies an existing global storage tier name. Supported on S2D system.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageTierSizeInMB
| Type: | UInt64 |
| 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 |