Share via

New-SCVMNetwork

  • Reference
Module:
VirtualMachineManager

Creates a virtual machine network.

Syntax

New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   -IsolationType <VMNetworkType>
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-AutoCreateSubnet]
   [-Owner <String>]
   [-NetworkManager <VirtualSwitchExtensionManager>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   -ExternalName <String>
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -LogicalNetwork <LogicalNetwork>
   [-RoutingDomainId <Guid>]
   [-PAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-CAIPAddressPoolType <VMNetworkIPAddressPoolType>]
   [-ExternalVMNetwork]
   [-Owner <String>]
   [-NetworkManager <VirtualSwitchExtensionManager>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

The New-SCVMNetwork cmdlet creates a virtual machine network. Virtual machine networks support multiple methods of isolation: No isolation, network virtualization, external, and VLAN. The type of isolation used by the VM network depends on the specified logical network. Virtual Machine Manager (VMM) uses the IP address pools that are associated with a virtual machine network to assign customer addresses to virtual machines.

The customer address is visible to the virtual machine and is used by customers to communicate with the virtual machine.

You must provide a logical network object when you create a virtual machine network. To obtain a logical network object, use the Get-SCLogicalNetwork cmdlet.

Examples

Example 1: Create a virtual machine network

PS C:\> $LogNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> New-SCVMNetwork -Name "VMNetwork01" -LogicalNetwork $LogNet

The first command gets the logical network object named LogicalNetwork01 and stores the object in the $LogNet variable.

The second command creates a VM network named VMNetwork01 with the logical network LogicalNetwork01.

Parameters

-AutoCreateSubnet

Indicates that a subnet is automatically created.

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

-CAIPAddressPoolType

Specifies an address pool type. Valid values are: IPV4, IPV6.

Type:VMNetworkIPAddressPoolType
Accepted values:IPV4, IPV6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifies a description for the virtual machine network.

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

-ExternalName

Specifies an external name for an object.

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

-ExternalVMNetwork

Indicates that the virtual machine network is external.

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

-IsolationType

Specifies an isolation type for a virtual machine network. The acceptable values for this parameter are:

  • NoIsolation
  • WindowsNetworkVirtualization
  • External
  • VLANNetwork
Type:VMNetworkType
Accepted values:NoIsolation, WindowsNetworkVirtualization, External, VLANNetwork
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

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

-LogicalNetwork

Specifies a logical network. A logical network is a named grouping of IP subnets and VLANs that is used to organize and simplify network assignments.

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

-Name

Specifies the name of a VMM object.

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

-NetworkManager

Specifies a virtual switch extension manager.

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

-OnBehalfOfUser

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

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

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

-Owner

Specifies the owner of a VMM object in the form of a valid domain user account.

  • Example format: -Owner "Contoso\PattiFuller"
  • Example format: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PAIPAddressPoolType

Specifies an address pool type. Valid values are: IPV4, IPV6.

Type:VMNetworkIPAddressPoolType
Accepted values:IPV4, IPV6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

Specifies a port ACL object.

Type:PortACL
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

-RoutingDomainId

Specifies the ID of a routing domain in the form of a GUID.

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

-UserRole

Specifies a user role object.

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

-VMMServer

Specifies a VMM server object.

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