Get-CsNetworkInterface
Letztes Änderungsdatum des Themas: 2012-03-23
Gibt Informationen zu den Netzwerkschnittstellen zurück, die auf Computern mit Microsoft Lync Server 2010-Diensten oder -Serverrollen verwendet werden.
Syntax
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
Detaillierte Beschreibung
Damit Informationen von einem Computer an einen anderen übertragen werden können, benötigen die Computer Netzwerkschnittstellen, d. h. Verbindungen zwischen dem Computer und dem Netzwerk. Computer mit Lync Server 2010-Diensten oder -Serverrollen müssen mindestens eine Netzwerkschnittstelle aufweisen. Andernfalls können sie nicht mit anderen Computern kommunizieren. Diese Computer können allerdings auch mehrere Netzwerkschnittstellen aufweisen. Ein Edgeserver kann beispielsweise über eine Schnittstelle zum Herstellen einer Verbindung mit dem internen Netzwerk und über eine zweite Schnittstellen zum Herstellen einer Verbindung mit dem Internet verfügen. Das Cmdlet Get-CsNetworkInterface ermöglicht es Administratoren, Informationen zu den derzeit auf Computern mit Lync Server-Diensten oder -Serverrollen verwendeten Netzwerkschnittstellen zurückzugeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsNetworkInterface lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterface"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
Netzwerkschnittstellen-ID |
Eindeutige ID für die zurückzugebende Netzwerkschnittstelle. Eine Netzwerkschnittstellen-ID besteht aus drei Teilen: Vollqualifizierter Domänenname (FQDN) des Computers (z. B. "atl-cs-001.litwareinc.com"). Netzwerkschnittstellenbereich ("Primary", "Internal", "External", "PSTN"). Der Bereich gibt an, für welche Art von Datenverkehr der Port verwendet wird. Netzwerkschnittstellennummer für diesen spezifischen Bereich. Beispiel: -Identity "atl-cs-001.litwareinc.com/Primary/1". Die Parameter "Identity", "ComputerFqdn" und "Filter" müssen separat verwendet werden. Es ist beispielsweise nicht möglich, einen Befehl auszuführen, der sowohl "ComputerFqdn" als auch "Identity" verwendet. Darüber hinaus können Sie beim Angeben des Identitätswerts keine Platzhalterzeichen verwenden. Verwenden Sie hierzu den Parameter "Filter". Wenn weder "Identity", "ComputerFqdn" noch "Filter" verwendet werden, gibt Get-CsNetworkInterface Informationen zu allen Netzwerkschnittstellen zurück, die derzeit auf den Computern verwendet werden, auf denen ein Lync Server-Dienst oder eine -Serverrolle ausgeführt wird. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhaltern beim Angeben der zurückzugebenden Netzwerkschnittstellen. Diese Syntax gibt beispielsweise Informationen zur Netzwerkschnittstelle "Primary" zurück, die auf allen Computern mit einem Lync Server-Dienst oder einer -Serverrolle verwendet wird. -Filter "*/Primary/*". |
ComputerFqdn |
Optional |
Zeichenfolge |
FQDN des Computers, von dem Netzwerkschnittstelleninformationen zurückgegeben werden sollen. Verwenden Sie folgende Syntax, um Netzwerkschnittstelleninformationen ausschließlich für den Computer "atl-cs-001.litwareinc.com" zurückzugeben: -ComputerFqdn atl-cs-001.litwareinc.com. |
Eingabetypen
Keine. Get-CsNetworkInterface akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsNetworkInterface wird eine Instanz des Objekts "Microsoft.Rtc.Management.Xds.DisplayNetworkInterface" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsNetworkInterface
Der vorstehende Befehl gibt Informationen zu allen für die Verwendung in der Organisation konfigurierten Netzwerkschnittstellen zurück.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
Der Befehl in Beispiel 2 gibt Informationen zu einer einzelnen Netzwerkschnittstelle zurück: diese hat den Identitätswert "atl-cs-001.litwareinc.com.com/Primary/1"
-------------------------- Beispiel 3 --------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
In Beispiel 3 werden Informationen zu allen Netzwerkschnittstellen in der Domäne "litwareinc.com" zurückgegeben. Hierzu wird der Parameter "Filter" zusammen mit dem Filterwert "*.litwareinc.com*" verwendet. Dieser Filterwert beschränkt die zurückgegebenen Daten auf Schnittstellen, deren Identitätswert den Zeichenfolgenwert "litwareinc.com" enthält.
-------------------------- Beispiel 4 --------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
In Beispiel 4 werden Informationen zu allen für die IP-Adresse 192.168.0.240 konfigurierten Netzwerkschnittstellen zurückgegeben. Hierzu ruft der Befehl zunächst Get-CsNetworkInterface ohne Parameter auf. Damit wird eine Auflistung aller derzeit für die Verwendung in der Organisation konfigurierten Netzwerkschnittstellen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Schnittstellen herausfiltert, bei denen die Eigenschaft "IPAddress" den Wert 192.168.0.240 aufweist.
-------------------------- Beispiel 5 --------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
Der Befehl in Beispiel 5 ist eine Variante des Befehls aus Beispiel 4. In diesem Fall werden allerdings Informationen zu allen für das Subnetz "192.168.0.*" konfigurierten Netzwerkschnittstellen zurückgegeben. Hierzu wird eine Auflistung aller Netzwerkschnittstellen abgerufen und diese Auflistung an das Cmdlet Where-Object weitergeleitet. Anschließend werden nur die Schnittstellen herausgefiltert, deren Eigenschaft "IPAddress" mit dem Zeichenfolgenwert 192.168.0. beginnt.
-------------------------- Beispiel 6 -------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
Der vorstehende Befehl gibt alle Netzwerkschnittstellen zurück, die für den externen Zugriff konfiguriert wurden. Dazu wird Get-CsNetworkInterface zunächst ohne Parameter aufgerufen. Anschließend wird eine Auflistung aller derzeit verwendeten Netzwerkschnittstellen zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Elemente auswählt, bei denen die Eigenschaft "Interface" den Wert "External" aufweist.