New-SCStorageTier

Creates a Storage Tier configured with Virtual Machine Manager Server.

Syntax

New-SCStorageTier -JobGroup <Guid> [-JobVariable <String>] -MediaType <StoragePhysicalDiskMediaType>
 [-NumberOfColumns <UInt16>] [-PROTipID <Guid>] [-PhysicalDiskRedundancy <UInt16>]
 [-ResiliencySettingName <String>] [-RunAsynchronously] -SizeMB <UInt64> [-VMMServer <ServerConnection>]
 [<CommonParameters>]
New-SCStorageTier -JobGroup <Guid> [-JobVariable <String>] [-PROTipID <Guid>] [-RunAsynchronously]
 -StorageTierFriendlyName <String> -StorageTierSizeInMB <UInt64> [-VMMServer <ServerConnection>]
 [<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 -PhysicalDiskRedundancy

This 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
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

Specifies a variable in which job progress is tracked and stored.

Type:String
Required:False
Position:Named
Default value:None
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
Parameter Sets:Unknown, HDD, SSD
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NumberOfColumns

Specifies the number of columns for a virtual disk.

Type:UInt16
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PhysicalDiskRedundancy

Specifies the number of physical disk failures that a virtual disk can sustain.

Type:UInt16
Required:False
Position:Named
Default value:None
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
Parameter Sets:Simple, Mirror, Parity
Required:False
Position:Named
Default value:None
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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SizeMB

Specifies the size, in megabytes, of a storage volume or file share.

Type:UInt64
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StorageTierFriendlyName

Specifies an existing global storage tier name. Supported on S2D system.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StorageTierSizeInMB
Type:UInt64
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False