Partilhar via


New-CsMediaConfiguration

 

Tópico modificado em: 2012-03-26

Cria uma nova coleção de configurações de mídia Estas configurações podem ser usadas para especificar coisas como o nível de criptografia suportado e a resolução máxima de vídeo permitida.

Sintaxe

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

Descrição Detalhada

Este cmdlet cria uma nova coleção de configurações que define comportamentos para ações de mídia específicas.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsMediaConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um único identificador especificando o escopo no qual esta configuração é aplicado (site ou serviço). A configuração no escopo do site seria inserida como site:<site name>, assim como site:Redmond. Um serviço seria inserido como <função de servidor>:<fqdn>, assim como MediationServer:pool0.litwareinc.com. Uma configuração de mídia em escopo global sempre vai existir e não pode ser removida, portanto uma nova configuração global não pode ser criada.

As configurações de mídia criadas em escopo de serviço podem ser criadas apenas para o serviço de Conferência A/V, para o Servidor de Mediação e para o Servidor de Aplicativos.

EnableQoS

Opcional

Booleano

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

Padrão: Falso

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.

Padrão: Falso

EncryptionLevel

Opcional

EncryptionLevel

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

Valores válidos:

SupportEncryption — o protocolo SRTP vai ser usado se puder ser negociado.

RequireEncryption - SRTP precisa ser negociado.

DoNotSupportEncryption - SRTP não deve ser usado.

Padrão: RequireEncryption

MaxVideoRateAllowed

Opcional

MaxVideoRateAllowed

A taxa máxima na qual sinais de vídeo vão ser transferidos nos pontos de extremidade dos clientes.

Valores válidos: Hd720p15M, VGA600K, CIF250K

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

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

CIF250K - formato de vídeo Common Intermediate Format (CIF), 15 fps com uma resolução de 352 x 288.

Observe que estes valores não diferenciam maiúsculas e minúsculas; os valores serão convertidos para a capitalização apropriada quando a configuração for criada.

Padrão: VGA600K

Force

Opcional

SwitchParameter

Suprimi qualquer aviso de confirmação que seria de outra forma exibido antes de fazer as alterações.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemplo

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

O Exemplo 1 usa New-CsMediaConfiguration para criar uma nova configuração de mídia com Identidade site:Redmond1. Esta nova configuração requer que ambas as partes envolvidas em uma conversação multimídia usem criptografia. Este requisito é aplicado adicionando o parâmetro EncryptionLevel e definindo o valor do parâmetro para RequireEncryption.

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

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

Este exemplo usa New-CsMediaConfiguration para criar uma nova configuração de mídia com Identidade MediationServer:pool0.litwareinc.com. Esta nova configuração vai ter um valor EnableSiren igual a True, o que significa que Siren será habilitado para chamadas envolvendo este Servidor de Mediação.