Get-CsNetworkRegion
Última modificación del tema: 2012-03-23
Recupera una o varias regiones de red. Las regiones de red representan concentradores o redes troncales de red en una red de empresa.
Sintaxis
Get-CsNetworkRegion [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkRegion [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Una región de red interconecta diversas partes de una red a través de diversas áreas geográficas. Cada región de red debe asociarse con un sitio central. Use este cmdlet para recuperar información acerca de una o más regiones de red, incluido el sitio central asociado y las opciones que determinan si están permitidas las rutas de acceso alternativas para las conexiones de audio y vídeo, y que asocian los sitios de la región con una configuración de omisión de medios.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsNetworkRegion localmente: 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-CsNetworkRegion"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
Identificador único de la región de contacto que se quiere recuperar. La Identity será en forma de una cadena que identifica exclusivamente esa región. (Observe que la Identity es lo mismo que NetworkRegionID). |
Filter |
Opcional |
Cadena de caracteres |
Este parámetro permite realizar una búsqueda de caracteres comodín en la Identity de todas las regiones de red configuradas para la organización. Use el carácter comodín para filtrar en alguna parte de la Identity. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la información de la región de red desde una réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Recupera uno o más objetos del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsNetworkRegion
El Ejemplo 1 recupera todas las regiones de red de la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkRegion -Identity NorthAmerica
El Ejemplo 2 recupera las regiones de red con la Identity Norteamérica. Debido a que las identidades son únicas, este comando recupera al máximo una región de red.
-------------------------- Ejemplo 3 --------------------------
Get-CsNetworkRegion -Filter *America
Este ejemplo recupera todas las regiones de red con identidades que finalizan con la cadena de caracteres "America". Esto recuperaría regiones con identidades como Norteamérica, Sudamérica y América Central.
-------------------------- Ejemplo 4 --------------------------
Get-CsNetworkRegion | Where-Object {$_.CentralSite -eq "site:Redmond"}
Este ejemplo recupera todas las regiones de red asociadas con el sitio central Redmond. El comando comienza por llamar al cmdlet Get-CsNetworkRegion, sin parámetros, para recuperar una recopilación de todas las regiones de red definidas para la implementación de Microsoft Lync Server 2010. A continuación, la recopilación se transfiere al cmdlet Where-Object. Where-Object filtra esta recopilación para devolver solamente los elementos (las regiones de red) cuyo valor CentralSite es igual a (-eq) site:Redmond.