Get-SCVirtualNetwork

Gets virtual network objects configured on a VMM host.

Description

The Get-SCVirtualNetwork cmdlet gets one or more virtual network objects configured on a host managed by System Center Virtual Machine Manager (VMM). 

For information about virtual networks in VMM, type: "Get-Help New-SCVirtualNetwork -detailed".

For more information about Get-SCVirtualNetwork, type: "Get-Help Get-SCVirtualNetwork -online".

Parameters

Name

Required? false
Accept Pipeline Input? false
Position? 0 
Specifies the name of a VMM object.

VMHostCluster

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM host cluster object.

Name

Required? false
Accept Pipeline Input? false
Position? 0 
Specifies the name of a VMM object.

VMHost

Required? true
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a virtual machine host object. VMM supports Hyper-V hosts, VMware ESX hosts, and Citrix XenServer hosts. 

For more information about each type of host, type: "Get-Help Add-SCVMHost -detailed". See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.

Name

Required? false
Accept Pipeline Input? false
Position? 0 
Specifies the name of a VMM object.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

Examples

1: Get all virtual networks in the VMM database. 
PS C:\> $VirtualNetworks = Get-SCVirtualNetwork 
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters

The first command gets all virtual network objects on all hosts managed by VMM and stores the virtual network objects in $VirtualNetworks.

The second command displays a subset of information about each virtual network object in $VirtualNetworks: the name of each virtual network, the physical host on which each virtual network is configured, and the physical network adapters configured on the host for each virtual network.
2: Get all virtual networks on a specific host. 
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCVirtualNetwork -VMHost $VMHost

The first command gets the host object named VMHost01 and stores the object in the $VMHost variable.

The second command all virtual network objects on VMHost01 and displays information about each virtual network.
3: Get a virtual network by name from a specific host. 
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN

The first command gets the host object named VMHost02 and stores the object in the $VMHost variable.

The second command gets the virtual network object named InternalVNet01 from VMHost02 and stores the object in the $VN variable.

The last command displays information about the virtual network stored in $VN to the user.

See Also