New-VMSan

Creates a new virtual storage area network (SAN) on a Hyper-V host.

Syntax

New-VMSan
   [-ComputerName <String>]
   [-Name] <String>
   [-Note <String>]
   [-HostBusAdapter <CimInstance[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-VMSan
   [-ComputerName <String>]
   [-Name] <String>
   [-Note <String>]
   -WorldWideNodeName <String[]>
   -WorldWidePortName <String[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-VMSan cmdlet creates a new virtual storage area network (SAN) on a Hyper-V host.

Examples

Example 1

PS C:\>New-VMSan -Name Production -Note "Production SAN" -WorldWideNodeName C003FF0000FFFF00 -WorldWidePortName C003FF5778E50002

Creates a new virtual storage area network (SAN) with the specified Name, Note, WorldWideNodeName, and WorldWidePortName.

Required Parameters

-Name

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

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

Specifies the world wide node name (WWNN) of the host bus adapters to be associated with the virtual storage area network (SAN) to be created.

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

Specifies the world wide port name (WWPN) of the host bus adapters to be associated with the virtual storage area network (SAN) to be created.

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

Optional Parameters

-ComputerName

Specifies the friendly name of a Hyper-V host on which the new virtual storage area network (SAN) is to be created. 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:.
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
Accept pipeline input:False
Accept wildcard characters:False
-HostBusAdapter

Specifies the host bus adapter (HBA) to be associated with the virtual storage area network (SAN) to be created. This can be retrieved by running the Get-InitiatorPort cmdlet.

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

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

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

Outputs

Microsoft.HyperV.PowerShell.VMSan