• Artículo

Set-CsMediaConfiguration

 

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

Modifica una colección existente de configuración multimedia.

Sintaxis

Set-CsMediaConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Set-CsMediaConfiguration [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Este cmdlet modifica una colección de opciones que definen la configuración multimedia. Estas acciones están relacionadas con las llamadas de audio y vídeo entre extremos de clientes.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsMediaConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de las configuraciones de material multimedia que quiere cambiar. Este identificador especifica el ámbito al que se aplica esta configuración (global, site o service).

Instance

Opcional

MediaSettings

Instancia del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Puede recuperar este objeto llamando a Get-CsMediaConfiguration con un valor específico para la propiedad Identity. A continuación, puede asignar nuevos valores a las propiedades del objeto y guardar los cambios pasando el objeto a Set-CsMediaConfiguration.

EnableQoS

Opcional

Booleano

QoS controla la calidad de las señales de voz que se envían a través de la red.

EnableSiren

Opcional

Booleano

De forma predeterminada, el servidor de mediación no negocia Siren como un posible códec para llamadas entre sí mismo y otros clientes de Microsoft Lync 2010. Si se establece en True, Siren se incluirá como un posible códec que se usará entre el servidor de mediación y otros clientes de Lync 2010.

EncryptionLevel

Opcional

EncryptionLevel

Nivel de cifrado entre las entidades de Unified Communications.

Valores válidos:

SupportEncryption: se usará el protocolo de transporte seguro en tiempo real (SRTP) si se puede negociar.

RequireEncryption: el SRTP se debe negociar.

DoNotSupportEncryption: no se debe usar SRTP.

Este valor no distingue mayúsculas y minúsculas. (Para obtener más información, vea los ejemplos de este tema.)

Valor predeterminado: RequireEncryption

MaxVideoRateAllowed

Opcional

MaxVideoRateAllowed

La tasa máxima a la que se transferirán señales de vídeo a los puntos finales de cliente.

Valores válidos: Hd720p15M, VGA600K, CIF250K

Hd720p15M - Alta definición, con una resolución de 1280 x 720 y unas proporciones de 16:9.

VGA600K - VGA, con una resolución de 640 x 480, 25 fps y proporciones 4:3.

CIF250K - Formato de vídeo CIF (Common Intermediate Format), 15 fps y una resolución de 352 x 288.

Tenga en cuenta que estos valores no diferencian entre mayúsculas y minúsculas; los valores se convertirán en mayúsculas o minúsculas según sea apropiado al crear la configuración. (Para obtener más información, vea los ejemplos de este tema.)

Valor predeterminado: VGA600K

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerían antes de realizar cambios.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Acepta la entrada transferida de objetos de configuración multimedia.

Tipos de valores devueltos

Set-CsMediaConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Ejemplo

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

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

En el ejemplo anterior se modifica la colección de configuraciones multimedia con Identity site:Redmond1; específicamente, el comando define el valor de la propiedad MaxVideoRateAllowed en Hd720p15M. Tenga en cuenta que el valor enviado al parámetro MaxVideoRateAllowed debe ser uno de los valores especificados en la descripción del parámetro. Los valores no distinguen mayúsculas y minúsculas; las mayúsculas y minúsculas del valor especificado aquí como hd720p15m se convertirán según sea necesario (en este caso: Hd720p15M).

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

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

En este ejemplo se modifica la colección de configuraciones multimedia con Identity site:Redmond1 para establecer DoNotSupportEncryption como valor de EncryptionLevel. El valor no distingue mayúsculas y minúsculas; al especificarlo como "donotsupportencryption", el valor se aceptará como válido y se convertirá automáticamente en DoNotSupportEncryption.