Edit

Share via

Remove-IscsiVirtualDiskTargetMapping

  • Reference
Module:
IscsiTarget

Removes the assignment between the specified iSCSI virtual disk and the specified iSCSI target.

Syntax

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

Description

The Remove-IscsiVirtualDiskTargetMapping cmdlet removes the assignment between a virtual disk and an iSCSI target. The virtual disk is no longer accessible by an iSCSI initiator after the assignment is removed.

Examples

Example 1: Disassociates a virtual disk from a target

PS C:\> Remove-IscsiVirtualDiskTargetMapping -TargetName "TargetOne" -Path "E:\temp\vhd1.vhdx"

This example un-assigns, or disassociates, the virtual disk at E:\temp\vhd1.vhdx from the target named TargetOne. Use Add-IscsiVirtualDiskTargetMapping to assign the virtual disk to an iSCSI target before it can be used by an iSCSI initiator.

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
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Specifies the credentials when connecting to a remote computer.

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

-Path

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

Type:String
Aliases:DevicePath
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetName

Specifies the name of the iSCSI target.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

None

Outputs

None