Get-CsNetworkInterface
Última modificación del tema: 2012-03-23
Devuelve información sobre las interfaces de red en uso en los equipos que ejecutan los servicios o los roles de servidor de Microsoft Lync Server 2010.
Sintaxis
Get-CsNetworkInterface [-Identity <NetworkInterfaceIdentity>] [-ComputerFqdn <Fqdn>]
Get-CsNetworkInterface [-ComputerFqdn <Fqdn>] [-Filter <String>]
Descripción detallada
Para que la información se transmita de un equipo a otro, estos equipos deben contar con interfaces de red: conexiones entre el equipo y la red. Los equipos que ejecutan los servicios o los roles de servidor de Lync Server 2010 deben tener al menos una interfaz de red; de lo contrario, no podrán comunicarse con otros equipos. Sin embargo, estos equipos también pueden tener varias interfaces de red; por ejemplo, un Servidor perimetral puede tener una interfaz para conectarse a la red interna y una segunda interfaz para conectarse a Internet. El cmdlet Get-CsNetworkInterface les proporciona a los administradores una manera de devolver información sobre las interfaces de red que están actualmente en uso en los equipos que ejecutan los servicios o los roles de servidor de Lync Server.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsNetworkInterface en forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkInterface"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad de interfaz de red |
Identificador único de la interfaz de red sobre la que se desea devolver información. Una identidad de interfaz de red consta tres partes: El nombre de dominio completo (FQDN) del equipo (por ejemplo, atl-cs-001.litwareinc.com). El "lado" de la interfaz de red (Principal; Interna; Externa; red telefónica conmutada). El lado indica el tipo de tráfico para el que se usa el puerto. El número de la interfaz de red para ese lado específico. Por ejemplo: -Identity "atl-cs-001.litwareinc.com/Primary/1". Los parámetros Identity, ComputerFqdn y Filter deben usarse por separado; por ejemplo, no es posible ejecutar un comando que use tanto ComputerFqdn como Identity. Además, no se pueden usar caracteres comodín al especificar la identidad. Para emplear caracteres comodín, use el parámetro Filter. Si no se usan los parámetros Identity, ComputerFqdn ni Filter,Get-CsNetworkInterface devuelve información sobre todas las interfaces de red actualmente en uso en los equipos que ejecutan un servicio o un rol de servidor de Lync Server. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín al especificar la interfaz de red (o las interfaces) sobre la que se desea devolver información. Por ejemplo, esta sintaxis devuelve información sobre la interfaz de red principal usada en todos los equipos que ejecutan un servicio o un rol de servidor de Lync Server: -Filter "*/Primary/*". |
ComputerFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo del equipo para el cual se desea devolver información de la interfaz de red. Por ejemplo, a fin de devolver información de la interfaz de red para el equipo atl-cs-001.litwareinc.com (y solamente para ese equipo), use esta sintaxis: -ComputerFqdn atl-cs-001.litwareinc.com. |
Tipos de entrada
Ninguno. Get-CsNetworkInterface no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsNetworkInterface devuelve una instancia del objeto Microsoft.Rtc.Management.Xds.DisplayNetworkInterface.
Ejemplo
-------------------------- Ejemplo 1 -------------------------
Get-CsNetworkInterface
El comando anterior devuelve información sobre todas las interfaces de red configuradas para su uso en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsNetworkInterface -Identity atl-cs-001.litwareinc.com/Primary/1
El comando del ejemplo 2 devuelve información sobre una sola interfaz de red: la interfaz que tiene el parámetro Identity atl-cs-001.litwareinc.com.com/Primary/1.
-------------------------- Ejemplo 3 ------------------------
Get-CsNetworkInterface -Filter "*.litwareinc.com*"
En el ejemplo 3, se devuelve información sobre todas las interfaces de red en el dominio litwareinc.com. Para ello, se incluye el parámetro Filter junto con el valor de filtro "*.litwareinc.com*". Este valor de filtro limita los datos devueltos a las interfaces que tienen una identidad que incluye el valor de cadena "litwareinc.com".
-------------------------- Ejemplo 4 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -eq "192.168.0.240"}
El ejemplo 4 devuelve información sobre todas las interfaces de red configuradas para la dirección IP 192.168.0.240. Para realizar esta acción, el comando primero llama a Get-CsNetworkInterface sin ningún parámetro; como resultado, se devuelve una recopilación de todas las interfaces de red configuradas para su uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona solamente las interfaces en las que la propiedad IPAddress es igual a 192.168.0.240.
-------------------------- Ejemplo 5 ------------------------
Get-CsNetworkInterface | Where-Object {$_.IPAddress -like "192.168.0.*"}
El comando que se muestra en el ejemplo 5 es una variación del comando que se muestra en el ejemplo 4; sin embargo, en este caso, se devuelve información sobre todas las interfaces de red configuradas para la subred "192.168.0.*". Para llevar a cabo esta acción, se recupera una recopilación de todas las interfaces de red, se canaliza esa recopilación a Where-Object y, luego, se seleccionan solamente las interfaces en las que IPAddress comienza con el valor de cadena "192.168.0.".
-------------------------- Ejemplo 6 ------------------------
Get-CsNetworkInterface | Where-Object {$_.Interface -eq "External"}
El comando anterior devuelve todas las interfaces de red que se han configurado para el acceso externo. Para ello, primero se llama a Get-CsNetworkInterface sin ningún parámetro; como resultado, se devuelve una recopilación de todas las interfaces de red actualmente en uso. A continuación, esta recopilación se canaliza al cmdlet Where-Object que selecciona solamente los elementos en los que la propiedad Interface es igual a External.