Compartir a través de

  • Artículo

Get-CsMediaConfiguration

 

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

Devuelve información sobre opciones de medios, como el nivel de cifrado admitido, si servidor de mediación puede usar Siren como códec de voz en su interacción con clientes Microsoft Lync 2010 y la resolución de vídeo máxima permitida.

Sintaxis

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

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

Descripción detallada

Este cmdlet recupera al menos una recopilación de configuraciones que definen interacciones multimedia.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsMediaConfiguration en forma local: 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-CsMediaConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la configuración de medios que se quiere recuperar. Este identificador especifica el ámbito al que se aplica esta configuración (global, del sitio o por usuario).

Filter

Opcional

Cadena de caracteres

Este parámetro filtra los resultados de la operación Get según el valor de comodín enviado al parámetro.

LocalStore

Opcional

Parámetro modificador

Recupera la información de configuración de medios de la réplica local de Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Get-CsMediaConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Ejemplo

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

Get-CsMediaConfiguration

En el Ejemplo 1, se devuelven todas las configuraciones de medios para su uso en la organización; esto se hace simplemente al invocar al cmdlet Get-CsMediaConfiguration sin parámetros adicionales.

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

Get-CsMediaConfiguration -Identity site:Redmond1

El ejemplo anterior devuelve solo las configuraciones de medios con la propiedad Identity site:Redmond1. Debido a que las identidades deben ser únicas, al especificar una propiedad Identity se garantiza que nunca se recuperará más de un elemento.

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

Get-CsMediaConfiguration -Filter site:*

En el Ejemplo 3, se usa el parámetro Filter para devolver todas las configuraciones de medios en el ámbito del sitio. La cadena de comodines site:* garantiza que Windows PowerShell devolverá solo las configuraciones de medios que tengan identidades que comiencen con el valor de cadena site:.

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

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}

En este ejemplo, Get-CsMediaConfiguration y Where-Object se usan para devolver todas las configuraciones de medios que admitan cifrado, pero sin ser obligatorio. Para ello, el comando primero usa Get-CsMediaConfiguration para recuperar todas las configuraciones de medios que se usan en la organización. A continuación, esta información se canaliza al cmdlet Where-Object, que aplica un filtro para restringir los datos que se devuelven a las configuraciones en las que la propiedad EncryptionLevel equivale a (-eq) SupportEncryption.

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

Get-CsMediaConfiguration -Filter *:*med*

En este ejemplo, se recuperan todas las configuraciones de medios definidas para sitios y servicios cuyo nombre contenga la cadena "med". Por ejemplo, este comando recuperará las configuraciones multimedia definidas para el sitio medford1, el sitio TwoMedfordPlace y el servicio MediationServer:redmond.litwareinc.com.