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