Get-CsNetworkSubnet
Última modificación del tema: 2012-03-23
Recupera información sobre una o varias subredes de red.
Sintaxis
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Cada subred debe asociarse a un sitio de red para poder determinar la ubicación geográfica del host que pertenece a esta subred. Use este cmdlet para recuperar información sobre la subred, incluida la identidad (el Id. de la subred), el número de bits de la máscara, el sitio de red asociado y la descripción de la subred.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsNetworkSubnet de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
Identificador de subred único de la subred que se desea recuperar. Este valor será una dirección IP (por ejemplo, 174.11.12.0). |
Filter |
Opcional |
Cadena de caracteres |
Use este parámetro para realizar una búsqueda con caracteres comodín de todas las subredes basadas en el parámetro Identity. Por ejemplo, el valor 172.11.* de Filter recuperará todas las subredes que tengan una identidad que comience con 172.11. (tales como 172.11.10.0, 172.11.25.0, etc.). |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la información de la subred de red de la réplica local de Almacén de administración central, en lugar de recuperarla de Almacén de administración central. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Recupera uno o más objetos del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsNetworkSubnet
En este ejemplo se recuperan todas las subredes incluidas en la instalación de Microsoft Lync Server 2010.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
En este ejemplo se recupera toda la información sobre la subred cuyo valor de Identity (id. de la subred) es 172.11.15.0.
-------------------------- Ejemplo 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
En este ejemplo se recuperan todas las subredes con identidades que empiecen con 172.11.
-------------------------- Ejemplo 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
En el Ejemplo 4 se recuperan todas las subredes asociadas al sitio de Vancouver. Primero se llama al cmdlet Get-CsNetworkSubnet sin parámetros. Este comando, tal como se ha visto en el Ejemplo 2, recupera todas las subredes definidas. A continuación se transfiere esta colección de subredes al cmdlet Where-Object. Where-Object filtra la colección para obtener únicamente las subredes con NetworkSiteID igual a (-eq) Vancouver.