Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Remove-IscsiVirtualDisk

Last Updated: 3/8/2017

SYNOPSIS

Deletes a virtual disk object, without deleting the virtual hard disk (VHD) file.

SYNTAX

DevicePath (Default)

Remove-IscsiVirtualDisk [-Path] <String> [-ComputerName <String>] [-Credential <PSCredential>]
 [<CommonParameters>]

InputObject

Remove-IscsiVirtualDisk -InputObject <IscsiVirtualDisk> [-ComputerName <String>] [-Credential <PSCredential>]
 [<CommonParameters>]

DESCRIPTION

The Remove-IscsiVirtualDisk cmdlet deletes the iSCSI virtual disk object. The virtual hard disk (VHD) file is not deleted.

EXAMPLES

Example 1: Delete a virtual disk

PS C:\> Remove-IscsiVirtualDisk -Path "E:\temp\vhd1.vhdx"

This example deletes a virtual disk that has the path E:\temp\vhd1.vhdx.

PARAMETERS

-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.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Credential

Specifies the credentials when connecting to a remote computer.

Type: PSCredential
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-InputObject

Accepts an iSCSI virtual disk object from the input pipeline.

Type: IscsiVirtualDisk
Parameter Sets: InputObject
Aliases: 

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Path

Specifies the path of the VHD file that is associated with the iSCSI virtual disk. Filter the iSCSI virtual disk object by using this parameter.

Type: String
Parameter Sets: DevicePath
Aliases: DevicePath

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

OUTPUTS

None

NOTES

Checkpoint-IscsiVirtualDisk

Convert-IscsiVirtualDisk

Get-IscsiVirtualDisk

Import-IscsiVirtualDisk

New-IscsiVirtualDisk

Restore-IscsiVirtualDisk

Set-IscsiVirtualDisk

© 2017 Microsoft