Creates a new ESI LUN object.
Syntax
New-EmcLun -Pool
<StoragePool> [-Name <String>] -Capacity <UInt64>
[-ApplicationHint <String>] [-StorageServiceNode
<StorageServiceNode>] [-Thick] [-Description <String>]
[-VNXLunAllocationPolicy <VNXLunAllocationPolicy>] [-Silent]
[<CommonParameters>]
New-EmcLun [-Name
<String>] -Capacity <UInt64> [-Description
<String>] [-VNXLunAllocationPolicy
<VNXLunAllocationPolicy>] [-Silent] -StorageSystem
<IVmaxStorageSystem2>
[<CommonParameters>]
Parameters
-VNXTieringPolicy <VNXTieringPolicy>
Attributes: Optional, Position: named
Specifies the tiering policy of the LUN. The default is Unknown. The other available options are: NoMovement, AutoTier, HighestAvailable, and LowestAvailable. This feature only supports VNX storage systems with LUNs pool .
Attributes: Optional, Position: 1
Specifies the LUN name or ID. Wildcards are permitted. It is a positional parameter (position = 1).
-StorageSystem <IStorageSystem>
Attributes: Required, Position: named
Specifies the storage system object. You can add the storage system object to ESI with the Get-EmcStorageSystemCredential and Connect-EmcSystem cmdlets. You can get the storage system object with the Get-EmcStorageSystem cmdlet.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
Examples
-------------- Example 1 --------------
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$l = New-EmcLun -Pool $p -Name mylun_test_1 -Capacity 10gb
TaskStatus: Started
10% : Creating the LUN...
100% : The specified LUN has been created...
TaskStatus: Completed
C:\PS>$l | select ProvisioningType, Name
ProvisioningType Name
---------------- ----
Thin mylun_test_1
This example creates a LUN.
---------- Example 2 ----------
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$l = New-EmcLun -Pool $p -Name mylun_test_1 -Capacity 10mb -Silent -Thick
C:\PS>$l | select ProvisioningType, Name
ProvisioningType Name
---------------- ----
Thick mylun_test_1
This example creates a LUN without thin provisioning.
---------- Example 3 ----------
C:\PS>$s = Get-EmcStorageSystem myVNX
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$serviceNodes = Get-EmcStorageServiceNode -StorageSystem $s
C:\PS>$l = New-EmcLun -Pool $p -Name mylun_test_1 -Capacity 10mb -StorageServiceNode $serviceNodes[0]
This example creates a LUN with a specified pool, capacity and service node.
---------- Example 4 ----------
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$l = New-EmcLun -Pool $p -Name mylun_test_1 -Capacity 10gb -ApplicationHint "HyperV"
This example creates a LUN with a specified pool, capacity, and application hint. The ApplicationHint parameter can be only used on storage systems such as VNXe that are application-aware.
---------- Example 5 ----------
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$l = New-EmcLun -Pool $p -Capacity 1gb -Name mylun_test_1 -Thick -VNXLunAllocationPolicy onDemand
This example creates a LUN with a specified pool, capacity, and allocation policy. The AllocationPolicy parameter can be only used on VNX2 storage systems where the LUNProvisioningType is Thick.
---------- Example 6 ----------
C:\PS>$sys = Get-EmcStorageSystem –SystemType VMAX
C:\PS>$l = New-EmcLun -Capacity 1gb -Name mylun_test_1 -StorageSystem $sys
This example creates an unbound LUN in a VMAX system.
---------- Example 7 ----------
C:\PS>$p = Get-EmcStoragePool gold*
C:\PS>$l = New-EmcLun -Pool $p -Capacity 1gb -Name mylun_AutoTierTest -VNXTieringPolicy AutoTier
Creates a LUN with specified pool, capacity, and VNX tiering policy. The policy parameter can be only used on VNX family storage systems.