Share via

New-SCStorageLogicalUnit

  • Reference
Module:
VirtualMachineManager

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

Syntax

New-SCStorageLogicalUnit
   [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>]
   [-VMHostGroup <HostGroup>]
   [-VMMServer <ServerConnection>]
   [-StorageLogicalUnit] <StorageLogicalUnit>
   -Name <String>
   [-Description <String>]
   -TargetStoragePool <StoragePool>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCStorageLogicalUnit
   [-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>]
   [-VMHostGroup <HostGroup>]
   [-VMMServer <ServerConnection>]
   [-StorageLogicalUnit] <StorageLogicalUnit>
   -Name <String>
   [-Description <String>]
   [-SetLogicalUnitCopySource]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCStorageLogicalUnit
   [-ProvisioningType <StorageProvisioningType>]
   [-VMHostGroup <HostGroup>]
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-Description <String>]
   [-StoragePool] <StoragePool>
   -DiskSizeMB <UInt64>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskSizeMB

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

Type:UInt64
Position:Named
Default value:None
Required:True
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
Position:Named
Default value:None
Required:False
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
Accepted values:Snapshot, Clone, RemoteMirror
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of a VMM object.

Type:String
Position:Named
Default value:None
Required:True
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

-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
Accepted values:Unknown, Thin, Fixed
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

-SetLogicalUnitCopySource

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

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

-StorageLogicalUnit

Specifies a storage logical unit object.

Type:StorageLogicalUnit
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StoragePool

Specifies a storage pool object.

Type:StoragePool
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetStoragePool

Specifies the target storage pool.

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

-VMHostGroup

Specifies a virtual machine host group object.

Type:HostGroup
Position:Named
Default value:None
Required:False
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

Outputs

StorageLogicalUnit

This cmdlet returns a StorageLogicalUnit object.