Compartir a través de

  • Artículo

Get-CsNetworkInterSitePolicy

 

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

Recupera una o varias directivas de entre sitios de red que definen limitaciones de ancho de banda entre sitios enlazados directamente dentro de una configuración de control de admisión de llamadas (CAC).

Sintaxis

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

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

Descripción detallada

Cuando los sitios de red comparten un vínculo directo, se pueden definir las limitaciones de ancho de banda de las conexiones de audio y vídeo entre ambos sitios. Este cmdlet recupera una o varias directivas de centro de red que asocian opciones de configuración de limitación de ancho de banda con sitios conectados directamente.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

XdsGlobalRelativeIdentity

Identificador único de la directiva de sitio de red que se desea recuperar. Dado que las directivas de sitios de red se crean únicamente en el ámbito global, este identificador no necesita especificar el ámbito. Por el contrario, contiene una cadena que consiste en un nombre único que identifica la directiva.

Filter

Opcional

Cadena de caracteres

Cadena de caracteres que contiene caracteres comodín para buscar directivas con valores Identidad que coincidan con la cadena comodín.

LocalStore

Opcional

Parámetro modificador

Recupera la información de la directiva de entre sitios 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 un objeto del tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.

Ejemplo

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

Get-CsNetworkInterSitePolicy

Si se llama a Get-CsNetworkInterSitePolicy sin parámetros, se obtendrán todas las directivas de sitio de red definidas entre dos sitios de red directamente vinculados.

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

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

En este ejemplo se recupera la directiva de sitio de red con Identidad Reno_Portland.

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

Get-CsNetworkInterSitePolicy -Filter *Reno*

En el Ejemplo 3 se recuperan todas las directivas de sitio de red con la cadena de caracteres Reno en cualquier lugar del valor Identity. Los caracteres comodín (*) dentro del valor, transferidos al parámetro Filter, significan “cualquier carácter o conjunto de caracteres”. Dicho de otro modo, la cadena de caracteres *Reno* coincide con los valores Identity que empiezan por cualquier carácter (uno o varios) y la cadena Reno a continuación, seguida de nuevo de uno o varios caracteres.

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

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

En este ejemplo se recuperan todas las directivas de sitio de red que no tienen asignado ningún perfil de directiva de ancho de banda. Para empezar, el comando llama a Get-CsNetworkInterSitePolicy que, como hemos visto en el Ejemplo 1, recupera una colección de todas las directivas de sitio de red. A continuación, la colección se transfiere al cmdlet Where-Object. Where-Object reduce la colección únicamente a las directivas de sitio que no tengan asignado ningún perfil de directiva de ancho de banda. Para ello, comprueba si la propiedad BWPolicyProfileID de cada directiva de sitio es igual a (-eq) Null ($null) realizando una comparación.