Freigeben über

Get-SCVirtualNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

Ruft VMM virtual network adapter objects from a virtual machine, virtual machine template, or hardware profile.

Syntax

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>]

Beschreibung

Das Cmdlet Get-SCVirtualNetworkAdapter ruft ein oder mehrere virtuelle Netzwerkadapterobjekte aus einem virtuellen Computerobjekt, einem virtuellen Computervorlagenobjekt oder einem Hardwareprofilobjekt in einer Virtual Machine Manager -Umgebung (VMM) ab.

Beispiele

Beispiel 1: Abrufen von virtuellen Netzwerkadaptern aus einem virtuellen Computer

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

Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft alle virtuellen Netzwerkadapterobjekte auf VM01 ab und zeigt Informationen über die Adapter an den Benutzer an.

Beispiel 2: Abrufen von virtuellen Netzwerkadaptern aus einer virtuellen Computervorlage

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

Der erste Befehl ruft alle Virtuellen Computervorlagenobjekte aus der VMM-Bibliothek ab, wählt das Vorlagenobjekt namens VMTemplate01 aus, und speichert das Objekt in der $VMTemplate Variablen.

Der letzte Befehl ruft alle virtuellen Netzwerkadapterobjekte VMTemplate01 ab und zeigt Informationen zu diesen Adaptern für den Benutzer an.

Beispiel 3: Abrufen von virtuellen Netzwerkadaptern aus einem Hardwareprofil

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

Der erste Befehl ruft alle Hardwareprofilobjekte in der VMM-Bibliothek ab, wählt das Profilobjekt namens NewHWProfile01 aus, und speichert das Objekt dann in der $HWProfile Variablen.

Der zweite Befehl ruft alle virtuellen Netzwerkadapterobjekte NewHWProfile01 ab und zeigt Informationen zu diesen Adaptern für den Benutzer an.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft.

Der Befehl Get-SCVirtualDiskDrive -All ruft beispielsweise alle virtuellen Datenträgerlaufwerkobjekte unabhängig von dem virtuellen Computerobjekt oder vorlagenobjekt ab, dem jedes virtuelle Datenträgerlaufwerkobjekt zugeordnet ist.

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

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

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

-ID

Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.

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

-Name

Gibt den Namen eines Netzwerkobjekts an.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-ParentTypeVMOrHost

Gibt an, dass der übergeordnete Typ ein virtueller Computer oder ein Host ist.

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

-VM

Gibt ein Objekt virtueller Maschinen an.

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

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

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

Ausgaben

VirtualNetworkAdapter

Dieses Cmdlet gibt ein VirtualNetworkAdapter-Objekt zurück.

Hinweise

  • Erfordert ein virtuelles VMM-Computerobjekt, ein virtuelles Computervorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Cmdlets Get-SCVirtualMachine, Get-SCVMTemplate oder Get-SCHardwareProfile-Cmdlets abgerufen werden kann.