Creates a new meta or composite LUN from the specified LUNs. To compose or form a meta or composite LUN, at least two LUNs are required and the first LUN becomes the metahead. In case of a concatenated meta or composite LUN, the configuration head can be bound or unbound. All remaining members must be unbound.



New-EmcCompositeLun [-Name <String>] -LunsThatParticipateInComposition <Lun[]> -CompositionConfiguration <CompositionConfiguration> [-Silent] [<CommonParameters>]



-Name <String>

Attributes: Optional, Position: named

Specifies the name of the new Composite LUN.


-LunsThatParticipateInComposition <Lun[]>

Attributes: Required, Position: named

Specifies the list of ESI LUN objects. You can get a LUN object with the ESI storage system object or with the Get-EmcLun cmdlet. You can get unbound LUNs with the Get-EmcUnboundLun cmdlet.


-CompositionConfiguration <CompositionConfiguration>

Attributes: Required, Position: named

Specifies the composite configuration object, which can be either striped or concatenated.


-Silent <SwitchParameter>

Attributes: Optional, Position: named

Turns off all the informational and verbose messages. However, it still displays errors.



This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.



-------------- Example 1 --------------

C:\PS>Getting the Storage System

$storage=Get-EmcStorageSystem -ID *vmax480*

Creates an unbound LUN.


C:\PS>$lun1 = New-EmcLun -StorageSystem $storage -Name mm1 -Capacity 1GB

C:\PS>$lun2 = New-EmcLun -StorageSystem $storage -Name mm2 -Capacity 1GB

Create a composite LUN from the two unbound LUNs created above.


C:\PS>$compositelun = New-EmcCompositeLun -Name new_stripe -LunsThatParticipateInComposition $lun1, $lun2 -CompositionConfiguration StripeOnly

This example creates two unbound LUNs with which a new stripe meta or composite LUN is formed.