New-SCVMNetwork
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 $LogNetThe 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 |