Windows PowerShell command on Get-command Set-StorageTier

NAME

Set-StorageTier

SYNOPSIS

Modifies a storage tier.

SYNTAX

Set-StorageTier [-CimSession ] [-NewFriendlyName ] [-ThrottleLimit ] -UniqueId

[]

Set-StorageTier [-CimSession ] [-Description ] [-ThrottleLimit ] []

Set-StorageTier [-CimSession ] [-ColumnIsolation {PhysicalDisk | StorageEnclosure | StorageScaleUnit

| StorageChassis | StorageRack}] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure | StorageScaleUnit |

StorageChassis | StorageRack}] [-Interleave ] [-MediaType {HDD | SSD | SCM}] [-NumberOfColumns ]

[-NumberOfDataCopies ] [-NumberOfGroups ] [-PhysicalDiskRedundancy ] [-ProvisioningType

{Thin | Fixed}] [-ResiliencySettingName ] [-ThrottleLimit ] []

Set-StorageTier [-CimSession ] [-NewFriendlyName ] [-ThrottleLimit ]

[]

Set-StorageTier [-FriendlyName] [-CimSession ] [-NewFriendlyName ] [-ThrottleLimit

] []

Set-StorageTier [-FriendlyName] [-CimSession ] [-ColumnIsolation {PhysicalDisk |

StorageEnclosure | StorageScaleUnit | StorageChassis | StorageRack}] [-FaultDomainAwareness {PhysicalDisk |

StorageEnclosure | StorageScaleUnit | StorageChassis | StorageRack}] [-Interleave ] [-MediaType {HDD | SSD

| SCM}] [-NumberOfColumns ] [-NumberOfDataCopies ] [-NumberOfGroups ]

[-PhysicalDiskRedundancy ] [-ProvisioningType {Thin | Fixed}] [-ResiliencySettingName ]

[-ThrottleLimit ] []

Set-StorageTier [-CimSession ] [-ColumnIsolation {PhysicalDisk | StorageEnclosure | StorageScaleUnit

| StorageChassis | StorageRack}] [-FaultDomainAwareness {PhysicalDisk | StorageEnclosure | StorageScaleUnit |

StorageChassis | StorageRack}] [-Interleave ] [-MediaType {HDD | SSD | SCM}] [-NumberOfColumns ]

[-NumberOfDataCopies ] [-NumberOfGroups ] [-PhysicalDiskRedundancy ] [-ProvisioningType

{Thin | Fixed}] [-ResiliencySettingName ] [-ThrottleLimit ] -UniqueId []

Set-StorageTier [-FriendlyName] [-CimSession ] [-Description ] [-ThrottleLimit

] []

Set-StorageTier [-CimSession ] [-Description ] [-ThrottleLimit ] -UniqueId

[]

DESCRIPTION

The Set-StorageTier cmdlet modifies a storage tier. Use this cmdlet to change the name and description of a

storage tier, and to change the media type that is associated with storage tier.

PARAMETERS

-CimSession []

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such

as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local

computer. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-ColumnIsolation []

Specifies at which level columns within a virtual disk should be isolated from each other. We recommend omitting this parameter and using the defaults. The acceptable values for this parameter are:

-- PhysicalDisk

-- StorageScaleUnit

-- StorageChassis

-- StorageEnclosure

-- StorageRack

Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-Description []

Specifies a description for the storage tier. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-FaultDomainAwareness []

Specifies at what level you want the storage tier to be fault tolerant. The acceptable values for this parameter are:

-- PhysicalDisk

-- StorageScaleUnit

-- StorageChassis

-- StorageEnclosure

-- StorageRack

For example, specify StorageScaleUnit to store data copies on separate nodes of a Storage Spaces Direct cluster. This cmdlet refers to nodes of a Storage Spaces Direct cluster as storage scale units because you can expand the scale of the cluster by adding more nodes. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-FriendlyName

Specifies the friendly name of the storage tier to modify. Required? true Position? 1 Default value none

Accept pipeline input? true(ByPropertyName)

Accept wildcard characters? false

-Interleave []

Specifies the interleave value to use during the creation of a virtual disk. The interleave value represents

the number of bytes that is written to a single physical disk. Therefore, Interleave * NumberOfColumns yields

the size of one stripe of user data. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-MediaType []

Specifies the media type of the storage tier. The acceptable values for this parameter are:

-- SSD

-- SCM

-- HDD

Use SCM for storage-class memory such as NVDIMMs.

Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-NewFriendlyName []

Specifies a new friendly name for the storage tier. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-NumberOfColumns []

Specifies the number of columns to use when allocating the storage tier. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-NumberOfDataCopies []

Specifies the number of data copies to create. Specify 2 to create a two-way mirror, or 3 to specify a

three-way mirror or for dual-parity.

Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-NumberOfGroups []

Specifies the number of groups used by Local Reconstruction Coding (LRC) with a dual parity virtual disk. We recommend omitting this parameter and using the defaults. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-PhysicalDiskRedundancy []

Specifies the physical disk redundancy value to use during the creation of a virtual disk. This value represents how many failed physical disks the virtual disk can tolerate without data loss. The redundancy values are as follows:

-- For two-way mirror spaces, the virtual disk can tolerate 1 failed physical disk without data loss.

-- For three-way mirror spaces, the virtual disk can tolerate 2 failed physical disks without data loss.

-- For single-parity spaces, the virtual disk can tolerate 1 failed physical disk without data loss.

-- For dual-parity spaces the virtual disk can tolerate 2 failed physical disks without data loss.

Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-ProvisioningType []

Specifies the type of provisioning. The acceptable values for this parameter are: Fixed and Thin. Specify Fixed for storage spaces that use storage tiers or a clustered storage pool. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-ResiliencySettingName []

Specifies the resiliency setting, or storage layout, to use for the virtual disk. Acceptable values vary by storage subsystem. Allowed values for the Windows Storage subsystem are: Simple, Mirror, or Parity. By default, when you specify

Mirror, Storage Spaces creates a two-way mirror, and when you specify Parity, Storage Spaces creates a

single-parity space.

To create a three-way mirror space, specify 3 for the NumberofDataCopies parameter or 2 for the

PhysicalDiskRedundancy parameter.

To create a dual-parity space, specify 2 for the PhysicalDiskRedundancy parameter and Fixed provisioning for

the ProvisioningType parameter. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-ThrottleLimit []

Specifies the maximum number of concurrent operations that can be established to run the cmdlet. If this parameter is omitted or a value of 0 is entered, then Windows PowerShellr calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer. The throttle limit applies only to the current cmdlet, not to the session or to the computer. Required? false Position? named Default value none Accept pipeline input? false Accept wildcard characters? false

-UniqueId

Specifies the unique ID of the storage tier to modify. Required? true Position? named Default value none

Accept pipeline input? true(ByPropertyName)

Accept wildcard characters? false This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageSubsystem http://msdn.microsoft.com/library/windows/desktop/hh830569.aspx You can use the pipeline operator to pass an array of MSFT_StorageTier objects to the InputObject parameter.

OUTPUTS

Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_StorageTier http://msdn.microsoft.com/library/windows/desktop/dn535818(v=vs.85).aspx This cmdlet returns an MSFT_StorageTier object that contains details about the tier such as tier friendly name, media type and size.

NOTES

The Microsoft.Management.Infrastructure.CimInstance object is a wrapper class that displays Windows Management Instrumentation (WMI) objects. The path after the pound sign (#) provides the namespace and class name for the underlying WMI object.

Example 1: Change the name of a storage tier

PS C:\> Set-StorageTier -UniqueId '{49dde1c4-5c34-11e2-8441-00155de88701}' -NewFriendlyName "FastTier"

This command changes the friendly name of the storage tier that has the specified ID.

Example 2: Change the description of a storage tier

PS C:\> Get-StorageTier -FriendlyName "FastTier" | Set-StorageTier -Description "This tier denotes fast media in

the system"

This command uses the Get-StorageTier cmdlet to get the storage tier named FastTier, and then passes the storage

tier to the Set-StorageTier cmdlet by using the pipeline operator. The Set-StorageTier cmdlet changes the

description of the storage tier to the specified string.