New-IscsiVirtualDisk

Syntax

New-IscsiVirtualDisk
   [-Description <String>]
   [-Path] <String>
   [-SizeBytes] <UInt64>
   [-LogicalSectorSizeBytes <UInt32>]
   [-PhysicalSectorSizeBytes <UInt32>]
   [-BlockSizeBytes <UInt32>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

New-IscsiVirtualDisk
   [-Description <String>]
   -ParentPath <String>
   [-Path] <String>
   [[-SizeBytes] <UInt64>]
   [-PhysicalSectorSizeBytes <UInt32>]
   [-BlockSizeBytes <UInt32>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

New-IscsiVirtualDisk
   [-Description <String>]
   [-Path] <String>
   [-SizeBytes] <UInt64>
   [-DoNotClearData]
   [-UseFixed]
   [-LogicalSectorSizeBytes <UInt32>]
   [-PhysicalSectorSizeBytes <UInt32>]
   [-BlockSizeBytes <UInt32>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

The New-IscsiVirtualDisk cmdlet creates an iSCSI Virtual Hard Disk (VHDX) object that has the specified file path and size. After the iSCSI VHDX object has been created, the virtual disk can be assigned to an iSCSI target. Once a virtual disk has been assigned to a target, and an initiator connects to that target, the iSCSI initiator can then access the virtual disk after the initiator connects to the target.

If the virtual hard disk file path does not exist, a new VHDX file is created.

If the VHDX file path exists, the server returns an error. Use the Import-IscsiVirtualDisk cmdlet to import existing virtual hard disks.

If the cmdlet displays an error while it creates a virtual disk, check the following conditions:

• An absolute file path must be specified for the Path and ParentPath parameters.

• The virtual disk file name must have a .vhdx file name extension.

• The VHDX file cannot be a network file, or be in a compressed, sparse, or transacted folder.

Examples

Example 1: Create a fixed VHDX

PS C:\> New-IscsiVirtualDisk -UseFixed -Path "E:\temp\test.vhdx" -Size 10GB

This example creates a fixed VHDX that is 10GB in size.

Example 2: Create a differencing VHDX

PS C:\> New-IscsiVirtualDisk -ParentPath "E:\temp\test.vhdx" -Path "E:\temp\child\diff.vhdx"

This example creates a differencing VHDX, with the parent path E:\temp\test.vhdx and the differencing VHDX path is E:\temp\child\diff.vhdx.

Example 3: Create a dynamic VHDX on a remote computer

PS C:\> New-IscsiVirtualDisk -Path "E:\temp\test.vhdx" -Size 10GB -ComputerName "iscsisvr"

This example creates a dynamic VHDX with the size 10GB at E:\temp\test.vhdx on the computer named iscsisvr.

Example 4: Create a VHDX

PS C:\> New-IscsiVirtualDisk -Path "ramdisk:test.vhdx" -Size 20MB

This example creates a VHDX with the size 20MB. This VHDX is not saved. The VHDX is lost if the wintarget service is restarted or the system is restarted.

Parameters

-BlockSizeBytes

-ComputerName

-Credential

-Description

-DoNotClearData

-LogicalSectorSizeBytes

-ParentPath

-Path

-PhysicalSectorSizeBytes

-SizeBytes

-UseFixed

Inputs

None

Outputs

Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Related Links

• Checkpoint-IscsiVirtualDisk
• Convert-IscsiVirtualDisk
• Get-IscsiVirtualDisk
• Import-IscsiVirtualDisk
• Remove-IscsiVirtualDisk
• Restore-IscsiVirtualDisk
• Set-IscsiVirtualDisk