Get-SCVirtualNetworkAdapter
Ruft VMM-Adapterobjekte aus einer virtuellen Maschine, einer VM-Vorlage oder einem Hardwareprofil ab.
Syntax
All
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
Get-SCVirtualNetworkAdapter
-HardwareProfile <HardwareProfile>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
Get-SCVirtualNetworkAdapter
-VM <VM>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
Get-SCVirtualNetworkAdapter
-VMTemplate <Template>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VMHost
Get-SCVirtualNetworkAdapter
-VMHost <Host>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualNetworkAdapter
[-ID] <Guid>
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-SCVirtualNetworkAdapter ruft ein oder mehrere Objekte des virtuellen Netzwerkadapters aus einem VM-Objekt, einem VM-Vorlagenobjekt oder einem Hardwareprofilobjekt in einer Virtual Machine Manager-Umgebung (Virtual Machine Manager, VMM) ab.
Beispiele
Beispiel 1: Abrufen von virtuellen Netzwerkadaptern von einem virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM
Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft alle Objekte virtueller Netzwerkadapter auf VM01 ab und zeigt dem Benutzer Informationen zu den Adaptern an.
Beispiel 2: Abrufen von virtuellen Netzwerkadaptern aus einer Vorlage für virtuelle Computer
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate
Der erste Befehl ruft alle Vorlagenobjekte für virtuelle Maschinen aus der VMM-Bibliothek ab, wählt das Vorlagenobjekt mit dem Namen VMTemplate01 aus und speichert das Objekt in der Variablen $VMTemplate.
Mit dem letzten Befehl werden alle virtuellen Netzwerkadapterobjekte VMTemplate01 abgerufen und dem Benutzer Informationen zu diesen Adaptern angezeigt.
Beispiel 3: Abrufen von virtuellen Netzwerkadaptern aus einem Hardwareprofil
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
Mit dem ersten Befehl werden alle Hardwareprofilobjekte in der VMM-Bibliothek abgerufen, das Profilobjekt mit dem Namen NewHWProfile01 ausgewählt und dann in der Variablen $HWProfile gespeichert.
Der zweite Befehl ruft alle virtuellen Netzwerkadapterobjekte NewHWProfile01 ab und zeigt dem Benutzer Informationen zu diesen Adaptern an.
Parameter
-All
Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft.
Der Befehl Get-SCVirtualDiskDrive -All ruft z. B. alle Objekte des virtuellen Laufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes Objekt des virtuellen Laufwerks zugeordnet ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-HardwareProfile
Gibt ein Hardwareprofilobjekt an.
Parametereigenschaften
| Typ: | HardwareProfile |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
HardwareProfile
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ID
Gibt den numerischen Bezeichner als GUID (Globally Unique Identifier) für ein bestimmtes Objekt an.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ID
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen eines Netzwerkobjekts an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ID
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.
Parametereigenschaften
| Typ: | UserRole |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ParentTypeVMOrHost
Gibt an, dass es sich bei dem übergeordneten Typ um einen virtuellen Computer oder einen Host handelt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VM
Gibt ein Objekt eines virtuellen Computers an.
Parametereigenschaften
| Typ: | VM |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
VM
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMHost
Gibt ein Hostobjekt für eine virtuelle Maschine an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.
Weitere Informationen zu den einzelnen Hosttypen finden Sie unter dem Cmdlet Add-SCVMHost .
Parametereigenschaften
| Typ: | Host |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
VMHost
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
Parametereigenschaften
| Typ: | ServerConnection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMTemplate
Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.
Parametereigenschaften
| Typ: | Template |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Schablone |
Parametersätze
Template
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
VirtualNetworkAdapter
Dieses Cmdlet gibt ein VirtualNetworkAdapter-Objekt zurück.
Hinweise
- Erfordert ein VMM-Objekt, ein Vm-Vorlagenobjekt oder ein Hardwareprofilobjekt, das mithilfe der Get-SCVirtualMachine, Get-SCVMTemplate-oder Get-SCHardwareProfile Cmdlets abgerufen werden kann.