Delen via

Get-SCVirtualNetwork

  • Referentie
Module:
VirtualMachineManager

Hiermee worden virtuele netwerkobjecten opgehaald die zijn geconfigureerd op een VMM-host.

Syntax

Get-SCVirtualNetwork
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHostCluster <HostCluster>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -ID <Guid>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

Description

Met de cmdlet Get-SCVirtualNetwork worden een of meer virtuele netwerkobjecten geconfigureerd op een host die wordt beheerd door Virtual Machine Manager (VMM).

Typ voor informatie over virtuele netwerken in VMM Get-Help New-SCVirtualNetwork -Detailed.

Voorbeelden

Voorbeeld 1: Alle virtuele netwerken ophalen in de VMM-database

PS C:\> $VirtualNetworks = Get-SCVirtualNetwork 
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters

Met de eerste opdracht worden alle virtuele netwerkobjecten opgehaald op alle hosts die worden beheerd door VMM en worden de virtuele netwerkobjecten opgeslagen in $VirtualNetworks.

Met de tweede opdracht wordt een subset met informatie weergegeven over elk virtueel netwerkobject in $VirtualNetworks: de naam van elk virtueel netwerk, de fysieke host waarop elk virtueel netwerk is geconfigureerd en de fysieke netwerkadapters die op de host zijn geconfigureerd voor elk virtueel netwerk.

Voorbeeld 2: Alle virtuele netwerken op een specifieke host ophalen

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCVirtualNetwork -VMHost $VMHost

Met de eerste opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht worden alle virtuele netwerkobjecten op VMHost01 opgehaald en wordt informatie over elk virtueel netwerk weergegeven.

Voorbeeld 3: Een virtueel netwerk ophalen op naam van een specifieke host

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN

Met de eerste opdracht wordt het hostobject MET de naam VMHost02 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht wordt het virtuele netwerkobject met de naam InternalVNet01 opgehaald uit VMHost02 en wordt het object opgeslagen in de $VN variabele.

Met de laatste opdracht wordt informatie weergegeven over het virtuele netwerk dat is opgeslagen in $VN aan de gebruiker.

Parameters

-ID

Hiermee geeft u de numerieke id op als een globaal unieke id of GUID voor een specifiek object.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-VMHost

Hiermee geeft u een hostobject voor virtuele machines op. VMM ondersteunt Hyper-V-hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

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

-VMHostCluster

Hiermee geeft u een VMM-hostclusterobject op.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

VirtualNetwork

Met deze cmdlet wordt een VirtualNetwork-object geretourneerd.