New-SCStorageLogicalUnit

Creates a logical unit from unallocated capacity in a storage pool.

Syntax

New-SCStorageLogicalUnit [-StoragePool] <StoragePool> [-Description <String>] -DiskSizeMB <UInt64>
 [-JobVariable <String>] -Name <String> [-PROTipID <Guid>] [-ProvisioningType <StorageProvisioningType>]
 [-RunAsynchronously] [-VMHostGroup <HostGroup>] [-VMMServer <ServerConnection>] [<CommonParameters>]
New-SCStorageLogicalUnit [-StorageLogicalUnit] <StorageLogicalUnit> [-Description <String>]
 [-JobVariable <String>] [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>] -Name <String>
 [-PROTipID <Guid>] [-RunAsynchronously] [-SetLogicalUnitCopySource] [-VMHostGroup <HostGroup>]
 [-VMMServer <ServerConnection>] [<CommonParameters>]
New-SCStorageLogicalUnit [-StorageLogicalUnit] <StorageLogicalUnit> [-Description <String>]
 [-JobVariable <String>] [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>] -Name <String>
 [-PROTipID <Guid>] [-RunAsynchronously] -TargetStoragePool <StoragePool> [-VMHostGroup <HostGroup>]
 [-VMMServer <ServerConnection>] [<CommonParameters>]

Description

The New-SCStorageLogicalUnit cmdlet creates a logical unit from unallocated capacity in a storage pool.

Examples

Example 1: Create a copy of an existing logical unit

PS C:\> $SourceLU = Get-SCStorageLogicalUnit -Name "LUN01"
PS C:\> New-SCStorageLogicalUnit -SetLogicalUnitCopySource -StorageLogicalUnit $SourceLU -Name "NewLU" -LogicalUnitCopyMethod Clone

The first command gets the storage logical unit object named LUN01 and stores the object in the $SourceLU variable.

The second command creates a new logical unit named NewLU by cloning LUN01.

Parameters

-Description

States a description for the specified object.

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

Specifies the size of a disk in megabytes (MB).

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

Specifies that job progress is tracked and stored in the variable named by this parameter.

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: Clone, Snapshot.

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

Specifies the name of a VMM object.

Type:String
Required:True
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
-ProvisioningType

Specifies a storage provisioning type. Valid values are: Thin, Fixed.

Thin indicates that capacity is committed on demand for a storage logical unit.

Fixed indicates that capacity is fully committed for a fixed-size storage logical unit.

Type:StorageProvisioningType
Parameter Sets:Unknown, Thin, Fixed
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
-SetLogicalUnitCopySource

Indicates that the specified storage logical unit is the source from which a clone is copied.

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

Specifies a storage logical unit object.

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

Specifies a storage pool object.

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

Specifies the target storage pool.

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

Specifies a virtual machine host group object.

Type:HostGroup
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Outputs

StorageLogicalUnit

This cmdlet returns a **StorageLogicalUnit** object.