Compartir a través de

  • Artículo

Get-CsNetworkRegionLink

 

Última modificación del tema: 2012-03-23

Recupera uno o más vínculos entre las regiones de red configuradas para el control de admisión de llamadas (CAC).

Sintaxis

Get-CsNetworkRegionLink [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkRegionLink [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Las regiones de una red se vinculan a través de conectividad WAN física. Este cmdlet recupera uno o más vínculos de región definidos en las opciones de configuración de red para una implementación de Microsoft Lync Server 2010.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsNetworkRegionLink: 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-CsNetworkRegionLink"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

XdsGlobalRelativeIdentity

Identificador único del vínculo de región de red que se quiere recuperar. Los vínculos de región de red se crean sólo en el ámbito global, de modo que este identificador no necesita especificar ningún ámbito. En lugar de ello, contiene una cadena que es un nombre único que identifica el vínculo. (Tenga en cuenta que este valor es el mismo que NetworkRegionLinkID.)

Filter

Opcional

Cadena de caracteres

Acepta una cadena de caracteres comodín que se usa para recuperar vínculos de red basados en la coincidencia del valor de Identity con la cadena de caracteres comodín.

LocalStore

Opcional

Parámetro modificador

Recupera la información del vínculo de región de red de la réplica local del Almacén de administración central, en lugar de recuperarla del propio 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.NetworkRegionLinkType.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsNetworkRegionLink

En el Ejemplo 1 se recuperan todos los vínculos de región de red definidos en una implementación de Lync Server 2010.

-------------------------- Ejemplo 2 --------------------------

Get-CsNetworkRegionLink -Identity NA_EMEA

En el Ejemplo 2 se recupera información sobre un vínculo de región de red (como máximo), el vínculo con la identidad NA_EMEA.

-------------------------- Ejemplo 3 --------------------------

Get-CsNetworkRegionLink -Filter *EMEA*

En este ejemplo se usa el parámetro Filter para recuperar todos los vínculos de región de red cuyo nombre (identidad) de vínculo contenga la cadena EMEA. Observe los caracteres *, uno delante de la cadena EMEA y otro detrás. Esto significa que la cadena puede estar precedida o seguida de uno o varios caracteres; la cadena EMEA simplemente debe incluirse en alguna parte de Identity. Se recuperarán los vínculos con nombres como NA_EMEA, EMEA_APAC y EMEA2_SA.

-------------------------- Ejemplo 4 --------------------------

Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}

En este ejemplo se recuperan todos los vínculos de región de red que incluyen EMEA como una de las dos regiones que se vinculan. El ejemplo empieza con una llamada a Get-CsNetworkRegionLink sin parámetros, con lo cual se recuperan todos los vínculos de región. Esta colección de vínculos se transfiere al cmdlet Where-Object. Where-Object examina cada miembro de la colección de forma individual y comprueba los valores de las propiedades NetworkRegionID1 y NetworkRegionID2. Si alguna de estas propiedades es igual a EMEA, o, lo que es lo mismo, si NetworkRegionID1 es igual a (-eq) EMEA o (-or) NetworkRegionID2 es igual a (-eq) EMEA, se conserva el elemento en la colección y se muestra.