Compartir a través de

  • Artículo

New-CsMediaConfiguration

 

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

Crea una nueva recopilación de configuraciones de los medios. Estas configuraciones pueden usarse para especificar factores, como el nivel soportado de cifrado y la máxima resolución de vídeo permitida.

Sintaxis

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

Descripción detallada

Este cmdlet crea una nueva recopilación de configuraciones que definen comportamientos para acciones de medios específicas.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Un identificador único que especifique el ámbito en el que se aplica esta configuración (sitio o servicio). Una configuración en el ámbito del sitio se escribiría como site:<nombre de sitio>, como site:Redmond. Un servicio se ingresa como <rol del servidor>:<fqdn>, por ejemplo, MediationServer:pool0.litwareinc.com. Una configuración de medios en el ámbito global existirá siempre y no puede eliminarse, por lo tanto, no puede crearse una nueva configuración global.

Las opciones de configuración de medios creadas en el ámbito de servicio pueden crearse solo para el servicio de conferencias A/V, servidor de mediación y el servidor de aplicaciones.

EnableQoS

Opcional

Booleano

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

Valor predeterminado: False

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 el valor True, Siren se incluirá como un posible códec que se usará entre el servidor de mediación y otros clientes de Lync 2010.

Valor predeterminado: False

EncryptionLevel

Opcional

EncryptionLevel

El 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 - SRTP deben negociarse.

DoNotSupportEncryption - SRTP no deben usarse.

Valor predeterminado: RequireEncryption

MaxVideoRateAllowed

Opcional

MaxVideoRateAllowed

La velocidad máxima con la que se transferirán señales de vídeo en los extremos de cliente.

Valores válidos: Hd720p15M, VGA600K, CIF250K

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

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

CIF250K - formato de vídeo CIF (Common Intermediate Format), 15 fps con 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 corresponda al crearse la configuración.

Valor predeterminado: VGA600K

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno.

Tipos de valores devueltos

Crea un objeto tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Ejemplo

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

El Ejemplo 1 usa New-CsMediaConfiguration para crear una nueva configuración de medios con el parámetro Identity site:Redmond1. Esta nueva configuración requiere que ambas partes involucradas en una conversación multimedia usen el cifrado. Ese requisito se aplica agregando el parámetro EncryptionLevel y estableciendo el valor del parámetro en RequireEncryption.

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

New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True

Este ejemplo usa New-CsMediaConfiguration para crear una nueva configuración de medios con el parámetro Identity MediationServer:pool0.litwareinc.com. Esta nueva configuración tendrá un valor EnableSiren establecido en True, lo que significa que Siren está habilitado para llamadas relacionadas con este servidor de mediación.