Get-SCLogicalNetworkDefinition

Gets a logical network definition.

Syntax

Get-SCLogicalNetworkDefinition [[-Name] <String>] -Cloud <Cloud> [-LogicalNetwork <LogicalNetwork>]
 [-ReturnAllTypes] [-Subnet <String>] [-VLanID <Int32>] [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCLogicalNetworkDefinition [[-Name] <String>] -ID <Guid> [-LogicalNetwork <LogicalNetwork>]
 [-ReturnAllTypes] [-Subnet <String>] [-VLanID <Int32>] [-VMMServer <ServerConnection>] [<CommonParameters>]
Get-SCLogicalNetworkDefinition [[-Name] <String>] [-LogicalNetwork <LogicalNetwork>] [-ReturnAllTypes]
 [-Subnet <String>] [-VLanID <Int32>] -VMHostGroup <HostGroup> [-VMMServer <ServerConnection>]
 [<CommonParameters>]

Description

The Get-SCLogicalNetworkDefinition cmdlet gets one or more logical network definitions. A logical network definition (also called a network site) can be associated with one or more logical networks.

Examples

Example 1: Retrieve the logical network definition for a logical network

PS C:\> $LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup01" }
PS C:\> Get-SCLogicalNetworkDefinition -LogicalNetwork $LogicalNetwork -VMHostGroup $HostGroup

The first command gets the logical network named "LogicalNetwork01" and stores it in the $LogicalNetwork variable.

The second command gets the host group named "HostGroup01" and stores it in the $HostGroup variable.

The third command gets the logical network definition for the logical network stored in $LogicalNetwork and the host group stored in the $HostGroup variable (including its parent host group if inheritance is enabled).

Parameters

-Cloud

Specifies a private cloud object.

Type:Cloud
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ID

Specifies the numerical identifier as a globally unique identifier, or GUID, for a specific object.

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

Specifies a logical network. A logical network is a named grouping of IP subnets and virtual local area networks (VLANs) that is used to organize and simplify network assignments.

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

Specifies the name of a Virtual Machine Manager (VMM) object.

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

Indicates that this cmdlet returns the logical network definitions of any isolation type.

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

Specifies an IP subnet (IPv4 or IPv6) in Classless Inter-Domain Routing (CIDR) notation.

Example format for an IPv4 subnet: 192.168.0.1/24

Example format for an IPv6 subnet: FD4A:29CD:184F:3A2C::/64

Note that an IP subnet cannot overlap with any other subnet in a host group or child host groups.

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

Specifies a numerical identifier in the range 1-4094 for a virtual network adapter on a virtual machine or for a physical network adapter on a virtual machine host.

Configure a VLanID on a Hyper-V, VMware ESX, or Citrix XenServer host on an externally bound physical network adapter when the VLan mode is Access.

Configure a VLanID on a virtual network adapter of a virtual machine if it is either of the following:

-- Bound to a physical network adapter on the host.

  • Bound to an internal virtual network on the host.

Type:Int32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMHostGroup

Specifies a virtual machine host group object.

Type:HostGroup
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a Virtual Machine Manager (VMM) server object.

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

Outputs

LogicalNetworkDefiniton

This cmdlet returns a **LogicalNetworkDefiniton** object.