New-SCLogicalNetwork
Creates a logical network object.
Syntax
New-SCLogicalNetwork
[-NetworkController <VirtualSwitchExtensionManager>]
[-VMMServer <ServerConnection>]
[-Name] <String>
[[-Description] <String>]
[-EnableNetworkVirtualization <Boolean>]
[-UseGRE <Boolean>]
[-IsPVLAN <Boolean>]
[-LogicalNetworkDefinitionIsolation <Boolean>]
[-PublicIPNetwork]
[-AllowDynamicVlanOnVnic <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCLogicalNetwork cmdlet creates a logical network object for a Virtual Machine Manager (VMM). Each logical network must have a unique name within a VMM installation.
Logical networks enable network administrators to model a network by grouping subnets and virtual local area networks (VLANs) based on categories that align to business needs. To assign IP subnets and VLANs to a logical network, create a logical network definition by using the New-SCLogicalNetworkDefinition cmdlet.
Examples
Example 1: Create a logical network
PS C:\> New-SCLogicalNetwork -Name "LogicalNetwork01"This command creates a logical network named LogicalNetwork01.
Example 2: Create a network virtualization-enabled logical network
PS C:\> New-SCLogicalNetwork -Name "LogicalNetwork02" -EnableNetworkVirtualization $True -UseGRE $TrueThis command creates a logical network named LogicalNetwork02 that is enabled for network virtualization and implements Generic Routing Encapsulation (GRE).
Parameters
-AllowDynamicVlanOnVnic
Specifies that this vNIC is configured for Dynamic VLAN. VMM does not expect a VLAN for this network adapter.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specifies a description for the logical network object.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableNetworkVirtualization
Indicates whether network virtualization is enabled. The default value is $False.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsPVLAN
Indicates whether the logical network is a Private Virtual LAN (PVLAN).
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies the name of 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 |
-LogicalNetworkDefinitionIsolation
Indicates whether to enable network isolation for the logical network definition.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-NetworkController
Specifies a network controller.
| Type: | VirtualSwitchExtensionManager |
| 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 |
-PublicIPNetwork
Specifies if a Network Controller managed network is meant for Public IPs.
| Type: | SwitchParameter |
| 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 |
-UseGRE
Indicates whether to use network virtualization with Generic Routing Encapsulation (GRE). The default value is $False.
| Type: | Boolean |
| 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 |
Outputs
LogicalNetwork
This cmdlet returns a LogicalNetwork object.