New-VsanIscsiLun Command | Vmware PowerCLI Reference

New-VsanIscsiLun

This cmdlet adds a new vSAN iSCSI LUN to a target.

Syntax

New-VsanIscsiLun
-CapacityGB < Decimal >
-Target < VsanIscsiTarget >
[-LunId < Int32 > ]
[-Name < String > ]
[-ProgressAction < ActionPreference > ]
[-RunAsync ]
[-Server < VIServer[] > ]
[-StoragePolicy < SpbmStoragePolicy > ]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
CapacityGB Decimal named
Specifies the capacity of the newly created vSAN iSCSI LUN in gigabytes (GB).
required
Target VsanIscsiTarget named
  • wildcards
Specifies the vSAN iSCSI target to which you want to add the LUN.
optional LunId Int32 named
Specifies the ID of the LUN. The value must be in the range from 0 to 255. If specified, the ID should be unique within a target.
optional Name String named
Specifies the name of the newly created vSAN iSCSI LUN. The name can indicate additional information about the LUN.
optional ProgressAction ActionPreference named
optional RunAsync SwitchParameter named
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console.
optional Server VIServer[] named
  • wildcards
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.
optional StoragePolicy SpbmStoragePolicy named
  • wildcards
Specifies the storage policy associated with the newly created vSAN iSCSI LUN. If not specified, the default storage policy defined in the iSCSI service is used.

Output

VMware.VimAutomation.Storage.Types.V1.Vsan.Iscsi.VsanIscsiLun

Examples

Example 1

New-VsanIscsiLun -Name "FirstLun" -Target $target -LunId 3 -CapacityGB 2

Creates a new vSAN iSCSI LUN of capacity 2 GB named "FirstLun" in the $target iSCSI target and sets the value of LunId to 3.

Related Commands

VsanIscsiInitiatorGroup

This cmdlet retrieves vSAN iSCSI initiator groups.

This cmdlet adds a new vSAN iSCSI initiator group to a cluster.

This cmdlet removes the specified vSAN iSCSI initiator groups from their clusters.

This cmdlet modifies the specified vSAN iSCSI initiator groups.

VsanIscsiInitiatorGroupTargetAssociation

This cmdlet retrieves all pairs of associations between vSAN iSCSI targets and initiator groups, which have access to the corresponding targets.

This cmdlet associates the specified vSAN iSCSI initiator group with specified vSAN iSCSI target to provide access to the target.

This cmdlet removes the specified association of vSAN iSCSI initiator group and target.

VsanIscsiLun

This cmdlet retrieves the vSAN iSCSI LUNs from a cluster or target.

This cmdlet adds a new vSAN iSCSI LUN to a target.

This cmdlet removes vSAN iSCSI LUNs from their iSCSI targets.

This cmdlet modifies the specified vSAN iSCSI LUNs.

VsanIscsiTarget

This cmdlet retrieves vSAN iSCSI targets from clusters.

This cmdlet adds a new vSAN iSCSI target to a cluster.

This cmdlet removes vSAN iSCSI targets form their clusters.

This cmdlet modifies the settings of the specified vSAN iSCSI targets.