New-VsanIscsiLun

Synopsis

Syntax

Related Commands

Online version

Get-VsanIscsiLun

Remove-VsanIscsiLun

Set-VsanIscsiLun

Detailed Description

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

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

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

Name

String

Specifies the name of the newly created vSAN iSCSI LUN. The name can indicate additional information about the LUN.

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

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

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

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

Return Type

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.

PowerCLI Reference

Synopsis