Get-SCVirtualNetwork
Ruft virtuelle Netzwerkobjekte ab, die auf einem VMM-Host konfiguriert sind.
Syntax
NoFilter (Standardwert)
Get-SCVirtualNetwork
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[<CommonParameters>]
Cluster
Get-SCVirtualNetwork
[[-Name] <String>]
-VMHostCluster <HostCluster>
[<CommonParameters>]
ByID
Get-SCVirtualNetwork
[[-Name] <String>]
-ID <Guid>
[<CommonParameters>]
FilterByVMHost
Get-SCVirtualNetwork
[[-Name] <String>]
-VMHost <Host>
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Get-SCVirtualNetwork werden ein oder mehrere virtuelle Netzwerkobjekte abgerufen, die auf einem Host konfiguriert sind, der von Virtual Machine Manager (VMM) verwaltet wird.
Um Informationen zu virtuellen Netzwerken in VMM zu erhalten, geben Sie Get-Help New-SCVirtualNetwork -Detailed.
Beispiele
Beispiel 1: Abrufen aller virtuellen Netzwerke in der VMM-Datenbank
PS C:\> $VirtualNetworks = Get-SCVirtualNetwork
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters
Mit dem ersten Befehl werden alle virtuellen Netzwerkobjekte auf allen von VMM verwalteten Hosts abgerufen und die virtuellen Netzwerkobjekte in $VirtualNetworks gespeichert.
Mit dem zweiten Befehl wird eine Teilmenge der Informationen zu den einzelnen virtuellen Netzwerkobjekten in $VirtualNetworks angezeigt: der Name jedes virtuellen Netzwerks, der physische Host, auf dem jedes virtuelle Netzwerk konfiguriert ist, und die physischen Netzwerkadapter, die auf dem Host für jedes virtuelle Netzwerk konfiguriert sind.
Beispiel 2: Abrufen aller virtuellen Netzwerke auf einem bestimmten Host
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> Get-SCVirtualNetwork -VMHost $VMHost
Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost01 ab und speichert das Objekt in der Variablen $VMHost.
Mit dem zweiten Befehl werden alle virtuellen Netzwerkobjekte auf VMHost01 abgerufen und Informationen zu den einzelnen virtuellen Netzwerken angezeigt.
Beispiel 3: Abrufen eines virtuellen Netzwerks anhand des Namens von einem bestimmten Host
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com"
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN
Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost02 ab und speichert das Objekt in der Variablen $VMHost.
Mit dem zweiten Befehl wird das virtuelle Netzwerkobjekt mit dem Namen InternalVNet01 von VMHost02 abgerufen und in der Variablen $VN gespeichert.
Mit dem letzten Befehl werden dem Benutzer Informationen über das virtuelle Netzwerk angezeigt, die in $VN gespeichert sind.
Parameter
-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
ByID
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| 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
FilterByVMHost
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMHostCluster
Gibt ein VMM-Hostclusterobjekt an.
Parametereigenschaften
| Typ: | HostCluster |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Cluster
| 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
NoFilter
| Position: | Named |
| Obligatorisch.: | False |
| 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
VirtualNetwork
Dieses Cmdlet gibt ein VirtualNetwork-Objekt zurück.