Compartilhar via

  • Artigo

Set-CsMediaConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção existente de definições de mídia.

Sintaxe

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>]]

Descrição Detalhada

Este cmdlet modifica uma coleção de definições que estabelecem configurações de mídia. Essas ações são relacionadas às chamadas de áudio e vídeo entre pontos de extremidade do cliente.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsMediaConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo das definições de configuração de mídia que se deseja alterar. Um identificador especifica o escopo ao qual esta configuração é aplicada (global, de site ou de serviço).

Instance

Opcional

MediaSettings

Uma instância do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. É possível recuperar este objeto chamando-se Get-CsMediaConfiguration com uma identidade específica. É possível atribuir novos valores às propriedades desse objeto e salvar as modificações passando-se o objeto para Set-CsMediaConfiguration.

EnableQoS

Opcional

Booleano

QoS monitora os sinais de qualidade de voz através de uma rede.

EnableSiren

Opcional

Booleano

Por padrão, o Servidor de Mediação não negocia o Siren como um codec possível para chamadas entre ele mesmo e outros clientes do Microsoft Lync 2010. Se esta definição for True, o Siren será incluído como um possível codec para uso entre o Servidor de Mediação e outros clientes do Lync 2010.

EncryptionLevel

Opcional

EncryptionLevel

O nível de criptografia entre entidades de Comunicações Unificadas.

Valores válidos:

SupportEncryption - o protoco de transporte em tempo real seguro (SRTP) será utilizado se ele puder ser negociado.

RequireEncryption - o SRTP deve ser negociado.

DoNotSupportEncryption - não deve se utilizar o SRTP.

Este valor não diferencia maiúsculas de minúsculas. Para obter detalhes, consulte Exemplos, neste tópico:

Padrão: RequireEncryption

MaxVideoRateAllowed

Opcional

MaxVideoRateAllowed

A taxa máxima com a qual os sinais de vídeo serão transferidos nos pontos de extremidade do cliente.

Valores válidos: Hd720p15M, VGA600K, CIF250K

Hd720p15M - alta definição, com uma resolução de 1280 x 720 e taxa de aspecto 16:9.

VGA600K - VGA, com uma resolução de 640 x 480, 25 fps e taxa de aspecto 4:3.

CIF250K - formato de vídeo CIF (Formato Intermediário Comum), 15 fps e uma resolução de 352 x 288.

Observe que esses valores não diferenciam maiúsculas de minúsculas; os valores serão convertidos no formato apropriado quando a configuração for criada (para obter detalhes, consulte Exemplos neste tópico).

Padrão: VGA600K

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Aceita entradas canalizadas de objetos de configuração de mídia.

Tipos de Retorno

Set-CsMediaConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemplo

-------------------------- Exemplo 1 --------------------------

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

O exemplo exibido acima modifica o conjunto de configurações de mídia com a Identidade site:Redmond1. Mais especificamente, o comando define como Hd720p15M o valor da propriedade MaxVideoRateAllowed. Observe que o valor passado ao parâmetro MaxVideoRateAllowed deve ser um dos valores especificados na descrição do parâmetro. Observe também que os valores não diferenciam maiúsculas de minúsculas; o valor introduzido como hd720p15m será automaticamente convertido na cobertura apropriada (neste exemplo, Hd720p15M).

-------------------------- Exemplo 2 --------------------------

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

Este exemplo modifica a coleção de configurações de mídia cuja Identidade for site:Redmond1, para que assuma o valor DoNotSupportEncryption em EncryptionLevel. Observe que este valor não diferencia maiúsculas de minúsculas; o valor foi inserido como donotsupportencryption, mas ele será aceito como um valor válido e alterado automaticamente para uma entrada que inclui maiúsculas e maiúsculas (DoNotSupportEncryption).