Share via

Add-SCNetworkConnection

  • Reference
Module:
VirtualMachineManager

Adds a network service connection.

Syntax

Add-SCNetworkConnection
   [-VMMServer <ServerConnection>]
   [-Service] <NetworkService>
   -LogicalNetworkDefinition <LogicalNetworkDefinition>
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-Description <String>]
   -Name <String>
   [-ConnectionType <NetworkConnectionType>]
   [-NetworkAdapter <NetworkServiceAdapterInfo>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCNetworkConnection
   [-VMMServer <ServerConnection>]
   [-Service] <NetworkService>
   -VMSubnet <VMSubnet>
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-Description <String>]
   -Name <String>
   [-ConnectionType <NetworkConnectionType>]
   [-NetworkAdapter <NetworkServiceAdapterInfo>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

The Add-SCNetworkConnection cmdlet adds a network service connection.

Parameters

-ConnectionType

Specifies a network connection type. The acceptable values for this parameter are:

  • Unknown
  • FrontEnd
  • BackEnd
Type:NetworkConnectionType
Accepted values:Unknown, FrontEnd, BackEnd
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifies a description for the network connection.

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

-IPv4Address

Specifies an IPv4 address.

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

-IPv6Address

Specifies an IPv6 address.

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

-JobVariable

Specifies a variable in which job progress is tracked and stored.

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

-LogicalNetworkDefinition

Specifies a logical network definition (also called a network site) that contains the subnet that the IP address pool serves. The subnet is specified by the VMSubnet parameter.

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

-Name

Specifies the name of a network object.

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

-NetworkAdapter

Specifies a network service adapter information object.

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

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

-RunAsynchronously

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

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

-Service

Specifies a network service object.

Type:NetworkService
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifies a Virtual Machine Manager (VMM) server object.

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

-VMSubnet

Specifies a virtual machine subnet object.

To obtain a VMSubnet object, use the Get-SCVMSubnet cmdlet.

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