New-SCStorageTier

Reference

Module:: VirtualMachineManager

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 -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
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:

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

Share via