Set-SCStorageArray

Modifies the properties of a storage array object.

Syntax

Set-SCStorageArray [-StorageArray] <StorageArray> -AddStoragePoolToManagement <StoragePool[]>
 [-CreateStorageGroupsPerCluster <Boolean>] [-Description <String>] [-DiscoverPhysicalDisks]
 [-IOPSNormalizationSizeKB <UInt32>] [-JobGroup <Guid>] [-JobVariable <String>]
 [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>] [-MaximumStorageLogicalUnitNameLength <Int16>]
 [-Name <String>] [-PROTipID <Guid>] [-RemoveStoragePoolFromManagement <StoragePool[]>] [-RunAsynchronously]
 -StorageClassificationAssociation <StorageClassification[]> [-VMHostGroupAssociation <HostGroup[]>]
 [<CommonParameters>]
Set-SCStorageArray [-StorageArray] <StorageArray> [-CreateStorageGroupsPerCluster <Boolean>]
 [-Description <String>] [-DiscoverPhysicalDisks] [-IOPSNormalizationSizeKB <UInt32>] [-JobGroup <Guid>]
 [-JobVariable <String>] [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>]
 [-MaximumStorageLogicalUnitNameLength <Int16>] [-Name <String>] [-PROTipID <Guid>] [-Pair]
 -PeerStorageArrayName <String> [-RemoveStoragePoolFromManagement <StoragePool[]>]
 [-RunAsAccount <RunAsAccount>] [-RunAsynchronously] [-UnPair] [<CommonParameters>]

Description

The Set-SCStorageArray cmdlet modifies the properties of a Virtual Machine Manager (VMM) storage array object.

Examples

Example 1: Change the name of a storage array

PS C:\> $Array = @(Get-SCStorageArray)[0]
PS C:\> Set-SCStorageArray -StorageArray $Array -Name "New Name"

The first command gets the first item in the storage array, and then stores it in the $Array variable.

The second command changes the name of the storage array stored in $Array to New Name.

Parameters

-AddStoragePoolToManagement

Indicates whether management of a storage pool through VMM is enabled. When set to $True, VMM imports all logical unit objects hosted by the storage pool.

Type:StoragePool[]
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CreateStorageGroupsPerCluster

Indicates whether a storage group is created for each cluster.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for the storage array.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DiscoverPhysicalDisks

Indicates that the cmdlet performs a level 3 discovery of physical disks.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IOPSNormalizationSizeKB
Type:UInt32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobGroup

Specifies an ID for a series of commands that run as a set just before the final command that includes the same job group ID runs.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

Specifies the name of a variable in which to track and store job progress.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LogicalUnitCopyMethod

Specifies the method used by the array to copy an existing logical unit. Valid values are: Clone and Snapshot.

Type:StorageLogicalUnitCopyMethod
Parameter Sets:Snapshot, Clone, RemoteMirror
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaximumStorageLogicalUnitNameLength

Specifies the maximum length that the name for a logical unit can be.

Type:Int16
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name for the storage array.

Type:String
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
-Pair
Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PeerStorageArrayName
Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RemoveStoragePoolFromManagement

Removes a storage pool from VMM management. This parameter deletes all logical unit information from VMM, but does not delete any data from the logical units themselves.

Type:StoragePool[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsAccount
Type:RunAsAccount
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
-StorageArray

Specifies a storage array object. This array can be a Fibre Channel or iSCSI storage sub-system that is used to store virtual machine configuration and virtual disks.

Type:StorageArray
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-StorageClassificationAssociation

Specifies an array of storage classification objects that is associated with a storage pool.

Type:StorageClassification[]
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UnPair
Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMHostGroupAssociation

Specifies an array of host group objects.

Type:HostGroup[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

StorageArray

This cmdlet returns a **StorageArray** object.