Share via


New-SCVirtualFibreChannelAdapter

Creates a Virtual Fibre Channel adapter in a hardware profile, virtual machine template, or virtual machine instance.

Syntax

VMDynamicAddress (Default)

New-SCVirtualFibreChannelAdapter
    -VM <VM>
    [-VirtualFibreChannelSAN <HostFibreChannelVirtualSAN>]
    [-DynamicWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

JobGroupDynamic

New-SCVirtualFibreChannelAdapter
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-VirtualFibreChannelSAN <HostFibreChannelVirtualSAN>]
    [-DynamicWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

JobGroupStatic

New-SCVirtualFibreChannelAdapter
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-PrimaryWorldWideNodeName <String>]
    [-PrimaryWorldWidePortName <String>]
    [-SecondaryWorldWideNodeName <String>]
    [-SecondaryWorldWidePortName <String>]
    [-VirtualFibreChannelSAN <HostFibreChannelVirtualSAN>]
    [-StaticWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VMStaticAddress

New-SCVirtualFibreChannelAdapter
    -VM <VM>
    -PrimaryWorldWideNodeName <String>
    -PrimaryWorldWidePortName <String>
    -SecondaryWorldWideNodeName <String>
    -SecondaryWorldWidePortName <String>
    [-VirtualFibreChannelSAN <HostFibreChannelVirtualSAN>]
    [-StaticWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

TemplateStaticAddress

New-SCVirtualFibreChannelAdapter
    -VMTemplate <Template>
    [-StaticWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

TemplateDynamicAddress

New-SCVirtualFibreChannelAdapter
    -VMTemplate <Template>
    [-DynamicWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HardwareProfileDynamicAddress

New-SCVirtualFibreChannelAdapter
    -HardwareProfile <HardwareProfile>
    [-DynamicWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HardwareProfileStaticAddress

New-SCVirtualFibreChannelAdapter
    -HardwareProfile <HardwareProfile>
    [-StaticWorldWideName]
    [-StorageFabricClassification <StorageFabricClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

The New-SCVirtualFibreChannelAdapter cmdlet creates a Virtual Fibre Channel adapter in a hardware profile, virtual machine template, or virtual machine instance.

Parameters

-DynamicWorldWideName

Indicates that the cmdlet uses the dynamic world-wide name provided by Hyper-V.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

VMDynamicAddress
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
JobGroupDynamic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TemplateDynamicAddress
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
HardwareProfileDynamicAddress
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HardwareProfile

Specifies a hardware profile object.

Parameter properties

Type:HardwareProfile
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

HardwareProfileDynamicAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
HardwareProfileStaticAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-JobGroup

Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupDynamic
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
JobGroupStatic
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

Specifies that job progress is tracked and stored in the variable named by this parameter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OnBehalfOfUser

Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OnBehalfOfUserRole

Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.

Parameter properties

Type:UserRole
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PrimaryWorldWideNodeName

Specifies the primary world-wide node name for a virtual machine Virtual Fibre Channel adapter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PrimaryWorldWidePortName

Specifies the primary world-wide port name for a virtual machine Virtual Fibre Channel adapter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SecondaryWorldWideNodeName

Specifies the secondary world-wide node name for a virtual machine virtual Fibre Channel adapter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SecondaryWorldWidePortName

Specifies the secondary world-wide port name for a virtual machine Virtual Fibre Channel adapter.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StaticWorldWideName

Indicates that the cmdlet uses the static world-wide name provided by the administrator.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupStatic
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMStaticAddress
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
TemplateStaticAddress
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
HardwareProfileStaticAddress
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageFabricClassification

Specifies a classification for storage Fibre Channel fabric.

Parameter properties

Type:StorageFabricClassification
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VirtualFibreChannelSAN

Specifies a host Fibre Channel virtual SAN object.

Parameter properties

Type:HostFibreChannelVirtualSAN
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

VMDynamicAddress
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
JobGroupDynamic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
VMStaticAddress
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VM

Specifies a virtual machine object.

Parameter properties

Type:VM
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

VMDynamicAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
VMStaticAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-VMMServer

Specifies a Virtual Machine Manager (VMM) server object.

Parameter properties

Type:ServerConnection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

JobGroupDynamic
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
JobGroupStatic
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-VMTemplate

Specifies a VMM template object used to create virtual machines.

Parameter properties

Type:Template
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Template

Parameter sets

TemplateStaticAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False
TemplateDynamicAddress
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Outputs

VirtualFibreChannelAdapter

This cmdlet returns a VirtualFibreChannelAdapter object.