Set-VMSan

Reference

Module:: Hyper-V

Configures a virtual storage area network (SAN) on one or more Hyper-V hosts.

Syntax

Set-VMSan
   [-Name] <String>
   [-HostBusAdapter <CimInstance[]>]
   [-Note <String>]
   [-Passthru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-VMSan
   [-CimSession <CimSession[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential[]>]
   [-Name] <String>
   -WorldWideNodeName <String[]>
   -WorldWidePortName <String[]>
   [-Note <String>]
   [-Passthru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-VMSan cmdlet configures a virtual storage area network (SAN) on one or more Hyper-V hosts.

Examples

Example 1

PS C:\> Set-VMSan -Name Production -WorldWideNodeName C003FF0000FFFF22 -WorldWidePortName C003FF5778E50024

Configures a virtual storage area network (SAN) named Production with the specified WorldWideNodeName and WorldWidePortName values.

Parameters

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:	CimSession[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Specifies one or more Hyper-V hosts on which the virtual storage area network (SAN) is to be configured. 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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

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

-HostBusAdapter

Specifies the host bus adapter (HBA) to associate with the virtual storage area network (SAN). You can use the Get-InitiatorPort cmdlet to get this object.

Type:	CimInstance[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies the name of the virtual storage area network (SAN) to be configured.

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

-Note

Specifies the note to be associated with the virtual storage area network (SAN).

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

-Passthru

Specifies that an object is to be passed through to the pipeline representing the configured virtual storage area network (SAN).

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorldWideNodeName

The World Wide Node name of the Fibre Channel host bus adapter to be associated with this virtual storage area network (SAN).

Type:	String[]
Aliases:	Wwnn, NodeName, Wwnns, NodeNames, WorldWideNodeNames, NodeAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WorldWidePortName

The World Wide Port name of the Fibre Channel host bus adapter to be associated with this virtual storage area network (SAN).

Type:	String[]
Aliases:	Wwpn, PortName, Wwpns, PortNames, WorldWidePortNames, PortAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Outputs

None

Default

Microsoft.HyperV.PowerShell.SAN

If -PassThru is specified.

Share via