Disconnect-VMSan

Disconnect-VMSan

Removes a host bus adapter from a virtual storage area network (SAN).

Syntax

Parameter Set: HbaObject
Disconnect-VMSan [-Name] <String> -HostBusAdapter <CimInstance[]> [-Passthru] [ <CommonParameters>]

Parameter Set: StringWwn
Disconnect-VMSan [-Name] <String> -WorldWideNodeName <String[]> -WorldWidePortName <String[]> [-ComputerName <String[]> ] [-Passthru] [ <CommonParameters>]

Detailed Description

The Disconnect-VMSan cmdlet removes a host bus adapter from a virtual storage area network (SAN).

Parameters

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which a host bus adapter is to be removed from a virtual storage area network (SAN). NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.

Aliases	none
Required?	false
Position?	named
Default Value	.
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-HostBusAdapter<CimInstance[]>

Specifies the host bus adapter to be removed from the virtual storage area network (SAN).

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Name<String>

Specifies the name of the virtual storage area network (SAN) from which the host bus adapter is to be removed.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Passthru

Specifies that an object is to be passed through to the pipeline representing the virtual storage area network (SAN) from which the host bus adapter is to be removed.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WorldWideNodeName<String[]>

The world wide node name of the host bus adapter to be removed from the virtual storage area network (SAN).

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WorldWidePortName<String[]>

The world wide port name of the host bus adapter to be removed from the virtual storage area network (SAN).

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

• None by default; VMSan if –PassThru is specified.

Examples

Example 1

Removes the host bus adapter having the specified world wide node name and world wide port name from the virtual machine named Production on the local Hyper-V host.

PS C:\> Disconnect-VMSan –Name Production -WorldWideNodeName C003FF0000FFFF00 –WorldWidePortName C003FF5778E50002