## PowerCLI Reference

# New-VsanIscsiLun

## Synopsis

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

Syntax

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

Related Commands

Online version
Get-VsanIscsiLun
Remove-VsanIscsiLun
Set-VsanIscsiLun

Detailed Description

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

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
CapacityGB | Decimal | Specifies the capacity of the newly created vSAN iSCSI LUN in gigabytes (GB). | true | false
Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | false
LunId | Int32 | 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. | false | false
Name | String | Specifies the name of the newly created vSAN iSCSI LUN. The name can indicate additional information about the LUN. | false | false
RunAsync | SwitchParameter | 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. | false | false
Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | false | false
StoragePolicy | SpbmStoragePolicy | 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. | false | false
Target | VsanIscsiTarget | Specifies the vSAN iSCSI target to which you want to add the LUN. | true | false
WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | false

Return Type

The newly created VsanIscsiLun object

Notes

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.

Copyright © VMware, Inc. All rights reserved.