Delen via

Get-SCVirtualNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u virtuele VMM-netwerkadapterobjecten op van een virtuele machine, virtuele-machinesjabloon of hardwareprofiel.

Syntaxis

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-All]
   [-ParentTypeVMOrHost]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMHost <Host>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De Get-SCVirtualNetworkAdapter cmdlet haalt een of meer virtuele netwerkadapterobjecten op van een virtuele-machineobject, een sjabloonobject voor virtuele machines of een hardwareprofielobject in een VMM-omgeving (Virtual Machine Manager).

Voorbeelden

Voorbeeld 1: Virtuele netwerkadapters ophalen van een virtuele machine

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht worden alle virtuele netwerkadapterobjecten op VM01 opgehaald en wordt informatie over de adapters voor de gebruiker weergegeven.

Voorbeeld 2: Virtuele netwerkadapters ophalen uit een virtuele-machinesjabloon

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate

Met de eerste opdracht worden alle virtuele-machinesjabloonobjecten opgehaald uit de VMM-bibliotheek, wordt het sjabloonobject met de naam VMTemplate01 geselecteerd en wordt het object opgeslagen in de $VMTemplate variabele.

Met de laatste opdracht worden alle virtuele netwerkadapterobjecten VMTemplate01 opgehaald en wordt informatie over deze adapters weergegeven aan de gebruiker.

Voorbeeld 3: Virtuele netwerkadapters ophalen uit een hardwareprofiel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile

De eerste opdracht haalt alle hardwareprofielobjecten op in de VMM-bibliotheek, selecteert het profielobject met de naam NewHWProfile01 en slaat vervolgens het object op in de variabele $HWProfile.

De tweede opdracht haalt alle virtuele netwerkadapterobjecten NewHWProfile01 op en geeft informatie weer over deze adapters aan de gebruiker.

Parameters

-All

Geeft aan dat met deze cmdlet alle onderliggende objecten onafhankelijk van het bovenliggende object worden opgehaald.

Met de opdracht Get-SCVirtualDiskDrive -All bijvoorbeeld alle virtuele-schijfstationobjecten ophaalt, ongeacht het virtuele-machineobject of sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HardwareProfile

Hiermee geeft u een hardwareprofielobject.

Type:HardwareProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ID

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

Type:Guid
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een netwerkobject.

Type:String
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ParentTypeVMOrHost

Geeft aan dat het bovenliggende type een virtuele machine of een host is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele-machineobject.

Type:VM
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine. 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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMTemplate

Hiermee geeft u een VMM-sjabloonobject op dat wordt gebruikt om virtuele machines te maken.

Type:Template
Aliassen:Template
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualNetworkAdapter

Met deze cmdlet wordt een VirtualNetworkAdapter--object geretourneerd.

Notities

  • Hiervoor is een VMM-object, sjabloonobject voor virtuele machines of hardwareprofielobjecten vereist, dat kan worden opgehaald met behulp van de Get-SCVirtualMachine, Get-SCVMTemplateof Get-SCHardwareProfile cmdlets.