Compartir a través de

  • Artículo

Get-CsAVEdgeConfiguration

 

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

Devuelve información de configuración de los equipos que ejecutan el Servicio perimetral A/V en su organización. Las opciones de configuración de estos equipos, llamadas servidores perimetrales A/V, permiten a los usuarios internos compartir datos de audio y vídeo con usuarios externos (es decir, usuarios que no estén conectados a su red interna), así como intercambiar archivos y participar en sesiones de uso compartido de escritorio.

Sintaxis

Get-CsAVEdgeConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Descripción detallada

Los servidores perimetrales A/V permiten intercambiar tráfico de audio y vídeo a través del firewall de la organización. Entre otras posibilidades, esto permite a los usuarios utilizar Microsoft Lync Server 2010 a través de Internet y, a continuación, intercambiar datos de audio y vídeo con los usuarios que hayan iniciado sesión en el sistema desde dentro del firewall. Las opciones de configuración de Servidor perimetral se pueden asignar en el ámbito global, de sitio y de servicio. Las opciones de configuración perimetral A/V permiten a los administradores controlar, por ejemplo, durante cuánto tiempo es válida la autenticación de usuarios antes de que deba renovarse, o limitar la cantidad de ancho de banda que un único usuario o puerto puede usar.

El cmdlet Get-CsAVEdgeConfiguration permite recuperar información acerca de las opciones de configuración de servidor perimetral A/V que utiliza actualmente su organización.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Get-CsAVEdgeConfiguration localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAVEdgeConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la recopilación de configuraciones de servidor perimetral A/V que se recuperará. Para recuperar la recopilación global, use la sintaxis siguiente: -Identity global. Para recuperar una recopilación de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. Debe hacerse referencia a las opciones configuradas en el ámbito de servicio usando una sintaxis similar a ésta: -Identity service:EdgeServer:atl-cs-001.litwareinc.com. Tenga en cuenta que no puede usar caracteres comodín para especificar una identidad (Identity) de directiva.

Si no incluye este parámetro, Get-CsAVEdgeConfiguration devuelve todas las configuraciones de servidor perimetral que utiliza actualmente la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para indicar las opciones de configuración de servidor perimetral A/V que se devolverán. Por ejemplo, para devolver todas las configuraciones definidas en el ámbito de sitio, use la sintaxis: -Filter site:*. Para devolver una recopilación de todas configuraciones definidas en el servicio, use esta sintaxis: -Filter "service:*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de servidor perimetral A/V a partir de la réplica local del Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsAVEdgeConfiguration no acepta la entrada por canalización.

Tipos de valores devueltos

Get-CsAVEdgeConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Ejemplo

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

Get-CsAVEdgeConfiguration

El comando del Ejemplo 1 devuelve una recopilación de todas las configuraciones de servidor perimetral A/V en uso en la organización. Al llamar a Get-CsAVEdgeConfiguration sin parámetros adicionales, siempre se devuelve una recopilación completa de todas las opciones de configuración del servidor perimetral A/V.

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

Get-CsAVEdgeConfiguration -Identity site:Redmond

En el Ejemplo 2 se devuelve una única configuración de servidor perimetral A/V: la configuración con el valor de Identity site:Redmond.

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

Get-CsAVEdgeConfiguration -Filter "site:*"

El comando anterior devuelve una recopilación de todas las configuraciones de servidor perimetral A/V configuradas en el ámbito de sitio. Para ello, se llama a Get-CsAVEdgeConfiguration con el parámetro Filter; el valor de filtro "site:*" limita los datos que se devuelven para incluir sólo las configuraciones con un valor de Identity que comience con los caracteres "site:". Por definición, esto filtra los datos devueltos e incluye solamente las opciones configuradas en el ámbito de sitio.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}

En el Ejemplo 4 sólo se devuelven las opciones de configuración de servidor perimetral A/V cuya propiedad MaxBandwidthPerUserKB sea mayor que 10.000 kilobytes por segundo. Para ello, el comando llama primero a Get-CsAVEdgeConfiguration sin ningún parámetro, lo que devuelve una recopilación de todas las opciones de configuración de servidor perimetral A/V que se usan actualmente. A continuación, la recopilación se transfiere al cmdlet Where-Object, que selecciona sólo las configuraciones cuya propiedad MaxBandwidthPerUserKB es mayor que 10000 kilobits por segundo.

-------------------------- Ejemplo 5 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}

El Ejemplo 5 es similar al comando que se muestra en el Ejemplo 4; en el Ejemplo 5, sin embargo, las únicas configuraciones de servidor perimetral A/V que se devuelven son aquellas cuya propiedad MaxBandwidthPerUserKB es exactamente igual a 10000 kilobits por segundo.

-------------------------- Ejemplo 6 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}

El comando del Ejemplo 6 devuelve sólo las configuraciones de servidor perimetral A/V cuya propiedad MaxTokenLifetime sea menor que 8 horas (08 horas : 00 minutos : 00 segundos). Para ello, el comando llama primero a Get-CsAVEdgeConfiguration sin ningún parámetro, lo que devuelve una recopilación de todas las opciones de configuración de servidor perimetral A/V que utiliza la organización. A continuación, la recopilación se transfiere al cmdlet Where-Object, que selecciona sólo las configuraciones cuya propiedad MaxTokenLifetime sea menor que 8 horas (08:00:00).