Get-CsNetworkInterface
Dernière rubrique modifiée : 2012-03-23
Renvoie des informations sur les interfaces réseau utilisées sur des ordinateurs exécutant les services ou les rôles serveur Microsoft Lync Server 2010.
Syntaxe
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
Description détaillée
Pour que les ordinateurs s’échangent des informations, ils doivent disposer d’interfaces réseau, c’est-à-dire de connexions entre l’ordinateur et le réseau. Les ordinateurs exécutant des services ou des rôles serveur Lync Server 2010 doivent comporter au moins d’une interface réseau. Sinon, ils ne pourront pas communiquer avec d’autres ordinateurs. Toutefois, ces ordinateurs peuvent également avoir plusieurs interfaces réseau. Par exemple, un serveur Edge peut inclure une interface pour la connexion au réseau interne et une autre pour la connexion à Internet. La cmdlet Get-CsNetworkInterface permet aux administrateurs de renvoyer des informations sur les interfaces réseau actuellement utilisées sur des ordinateurs exécutant les services ou les rôles serveur Lync Server.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsNetworkInterface : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterface"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
Identité d’interface réseau |
Identificateur unique de l’interface réseau à renvoyer. Une identité d’interface réseau se compose de trois parties : Le nom de domaine complet (FQDN) de l’ordinateur proprement dit (par exemple : atl-cs-001.litwareinc.com). Le « côté » interface réseau (principal, interne, externe, réseau téléphonique commuté). Le côté indique le type de trafic pour lequel le port est utilisé. Le numéro de l’interface réseau pour ce côté particulier. Par exemple : -Identity « atl-cs-001.litwareinc.com/Primary/1 ». Les paramètres Identity, ComputerFqdn et Filter doivent être utilisés séparément. Par exemple, il n’est pas possible d’exécuter une commande utilisant simultanément ComputerFqdn et Identity. Vous ne pouvez pas non plus utiliser de caractères génériques pour spécifier l’identité. Pour employer des caractères génériques, utilisez plutôt le paramètre Filter. Si vous utilisez les paramètres Identity, ComputerFqdn ou Filter, Get-CsNetworkInterface renvoie des informations sur toutes les interfaces réseau actuellement utilisées sur vos ordinateurs exécutant un service ou un rôle serveur Lync Server. |
Filter |
Facultatif |
Chaîne |
Vous permet d’utiliser des caractères génériques lors de la spécification de l’interface (ou des interfaces) réseau à renvoyer. Par exemple, la syntaxe suivante renvoie des informations sur l’interface réseau principale utilisée sur tous les ordinateurs exécutant un service ou un rôle serveur Lync Server : -Filter « */Primary/* ». |
ComputerFqdn |
Facultatif |
Chaîne |
Nom de domaine complet de l’ordinateur sur lequel des informations d’interface réseau doivent être renvoyées. Par exemple, pour renvoyer des informations sur l’interface réseau de l’ordinateur atl-cs-001.litwareinc.com (et uniquement de cet ordinateur), utilisez la syntaxe suivante : -ComputerFqdn atl-cs-001.litwareinc.com. |
Types d’entrées
Aucun. Get-CsNetworkInterface n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsNetworkInterface renvoie l’instance de l’objet Microsoft.Rtc.Management.Xds.DisplayNetworkInterface.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsNetworkInterface
La commande précédente renvoie des informations sur toutes les interfaces réseau configurées pour être utilisées dans l’organisation.
-------------------------- Exemple 2 ------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
La commande illustrée dans l’exemple 2 renvoie des informations sur une seule interface réseau : l’interface comportant l’identité atl-cs-001.litwareinc.com.com/Primary/1.
-------------------------- Exemple 3 ------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
Dans l’exemple 3, des informations sont renvoyées sur toutes les interfaces réseau dans le domaine litwareinc.com. Pour cela, on inclut le paramètre Filter, associé à la valeur de filtre « *.litwareinc.com* ». Cette valeur limite les données renvoyées aux interfaces dont l’identité inclut la valeur de chaîne « litwareinc.com ».
-------------------------- Exemple 4 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
L’exemple 4 renvoie des informations sur toutes les interfaces réseau configurées pour l’adresse IP 192.168.0.240. Pour ce faire, la commande appelle d’abord Get-CsNetworkInterface sans aucun paramètre, qui entraîne le renvoi d’un ensemble contenant toutes les interfaces réseau configurées pour être utilisées dans l’organisation. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les interfaces dont la propriété IPAddress est égale à 192.168.0.240.
-------------------------- Exemple 5 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
La commande illustrée dans l’exemple 5 est une variante de la commande décrite dans l’exemple 4. Dans ce cas cependant, les informations renvoyées concernent toutes les interfaces réseau configurées pour le sous-réseau « 192.168.0.* ». Cette opération est effectuée en extrayant un ensemble de toutes les interfaces réseau, en redirigeant cet ensemble vers Where-Object, puis en sélectionnant uniquement les interfaces dont la propriété IPAddress commence par la valeur de chaîne « 192.168.0. ».
-------------------------- Exemple 6 ------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
La commande précédente renvoie toutes les interfaces réseau qui ont été configurées pour un accès externe. Pour cela, on appelle d’abord la cmdlet Get-CsNetworkInterface sans aucun paramètre, qui renvoie un ensemble de toutes les interfaces réseau actuellement utilisées. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les éléments dont la propriété Interface est égale à Externe.