COMMAND EVERYTHING.

New-IscsiVirtualDisk

Creates an iSCSI virtual disk with the specified file path and size.

PowerShell · Risk: High · Documentation Verified

Last verified: 2026-10-26

Microsoft IscsiTarget reference: Creates an iSCSI virtual disk with the specified file path and size. The syntax and selected example below are adapted from the pinned Windows Server 2025 reference. Module availability, target configuration and delegated permissions determine whether it can run in your environment. Documentation and parameter text: Microsoft, CC BY 4.0; formatting adapted by Cmdlet World. No execution testing is claimed.

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

Copied 0 times

Required permissions

Use an account with the target resource permissions documented for New-IscsiVirtualDisk. Modifying administrative cmdlets may require elevation or delegated administration. This catalog does not assert that ordinary users can execute the command.

Supported environments

Windows / IscsiTarget · Windows Server 2025 documentation; feature/module prerequisites apply

Parameters

-BlockSizeBytes: Specifies the block size, in bytes, for the VHDX. For fixed VHDX, if the value of the *SizeBytes* parameter is less than 32 MB, the default size if 2 MB. Otherwise, the default value is 32 MB. For dynamic VHDX, the default size is 2 MB. For differencing VHDX, the default size is the parent *BlockSize*.
-ComputerName: Specifies the computer name, or IP address, of the remote computer, if this cmdlet is run on a remote computer. Specifies the cluster resource group network name, or cluster node name, if this cmdlet is run on a cluster configuration. If you do not specify a value for this parameter, the cmdlet uses the local computer.
-Credential: Specifies the credentials when connecting to a remote computer.
-Description: Specifies the description for the iSCSI virtual disk.
-DoNotClearData: Indicates that the cmdlet does not clear the fixed VHDX. Because failing to clear data can reveal pre-existing data, we do not recommend this option.
-LogicalSectorSizeBytes: Specifies the logical sector size, in bytes, for the VHDX. The acceptable values for this parameter are: 512 and 4096. The default value is 512.
-ParentPath (required): Specifies the parent virtual disk path if the VHDX is a differencing disk.
-Path (required): Specifies the path of the VHDX file that is associated with the iSCSI virtual disk. If the VHDX file path does not exist, a new VHDX file is created. If the virtual hard disk file path exists, the server returns an error. Use the Import-IscsiVirtualDisk cmdlet to import existing virtual hard drives.
-PhysicalSectorSizeBytes: Specifies the physical sector size, in bytes, for the VHDX. The acceptable values for this parameter are: 512 and 4096. The default value is 4096.
-SizeBytes (required): Specifies the size, in bytes, of the iSCSI virtual disk.
-UseFixed (required): Indicates that the cmdlet creates a fixed VHDX.

Prerequisites

Windows with the IscsiTarget module and the Windows feature or management tools that provide it. Confirm target connectivity and version compatibility using the linked Microsoft reference.

Security considerations

This cmdlet changes system state. Review every target and parameter in the official reference, test outside production, and prepare an appropriate backup or rollback. Do not execute the example automatically.

Examples

Example 2: Create a differencing VHDX

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. Source: Microsoft, CC BY 4.0; transcript prompt/output removed. This example was not executed.

Sources

https://github.com/MicrosoftDocs/windows-powershell-docs/blob/b7645dd8c687139b28e845119da30ec670526507/docset/winserver2025-ps/IscsiTarget/New-IscsiVirtualDisk.md

https://learn.microsoft.com/powershell/module/iscsitarget/new-iscsivirtualdisk?view=windowsserver2025-ps

Personal collections

Explain or customize this command with AI

Related commands