New-SCStorageTier

Module:

VirtualMachineManager Module

Creates a Storage Tier configured with Virtual Machine Manager Server.

Syntax

NewTierSharedSpaces (Default)

New-SCStorageTier
    -MediaType <StoragePhysicalDiskMediaType>
    -SizeMB <UInt64>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-ResiliencySettingName <String>]
    [-PhysicalDiskRedundancy <UInt16>]
    [-NumberOfColumns <UInt16>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

NewTierS2D

New-SCStorageTier
    -StorageTierFriendlyName <String>
    -StorageTierSizeInMB <UInt64>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-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 -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.

Parameter properties

Type:	Guid
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-JobVariable

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

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-MediaType

Specifies an array of storage physical disk media type objects. The acceptable values for this parameter are:

• HDD
• SSD

Parameter properties

Type:	StoragePhysicalDiskMediaType
Default value:	None
Accepted values:	Unknown, HDD, SSD
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierSharedSpaces

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-NumberOfColumns

Specifies the number of columns for a virtual disk.

Parameter properties

Type:	UInt16
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierSharedSpaces

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-PhysicalDiskRedundancy

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

Parameter properties

Type:	UInt16
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierSharedSpaces

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	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.

Parameter properties

Type:	Guid
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ResiliencySettingName

Specifies the resiliency setting for a virtual disk. The acceptable values for this parameter are:

• Mirror
• Parity

Parameter properties

Type:	String
Default value:	None
Accepted values:	Simple, Mirror, Parity
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierSharedSpaces

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-SizeMB

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

Parameter properties

Type:	UInt64
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierSharedSpaces

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-StorageTierFriendlyName

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

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierS2D

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-StorageTierSizeInMB

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.

Parameter properties

Type:	UInt64
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

NewTierS2D

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-VMMServer

Specifies a VMM server object.

Parameter properties

Type:	ServerConnection
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

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.