Compartilhar via

  • Artigo

Get-CsMediaConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as configurações de mídia, inclusive o nível suportado de criptografia, se o Siren pode ser usado como um codec de voz pelo Servidor de Mediação em suas interações com os clientes do Microsoft Lync 2010 e a resolução de vídeo máxima permitida.

Sintaxe

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

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

Descrição Detalhada

Este cmdlet recupera uma ou mais coleções de configurações que definem interações de mídia.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsMediaConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsMediaConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da configuração da mídia que você deseja recuperar. Um identificador especifica o escopo no qual a configuração é aplicada (global, local ou serviço).

Filter

Opcional

Cadeia de caracteres

Este parâmetro filtra os resultados da operação Get com base no valor de caracteres curinga passado para este parâmetro.

LocalStore

Opcional

SwitchParameter

Obtém as informações de configuração de mídia a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsMediaConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemplo

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

Get-CsMediaConfiguration

O Exemplo 1 retorna todas as configurações de mídia em uso na organização; isso é feito simplesmente invocando-se o cmdlet Get-CsMediaConfiguration sem nenhum parâmetro adicional.

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

Get-CsMediaConfiguration -Identity site:Redmond1

O exemplo anterior retorna apenas a configuração de mídia com parâmetro Identity site:Redmond1. Como as identidades devem ser únicas, a especificação de uma Identity garante que você jamais recupere mais de um item.

-------------------------- Exemplo 3 --------------------------

Get-CsMediaConfiguration -Filter site:*

No Exemplo 3, o parâmetro Filter é usado para retornar todas as configurações de mídia em escopo de site. A cadeia de caracteres curinga site:* garante que o Windows PowerShell retornará apenas as configurações de mídia que tenham identidades começando com o valor da cadeia de caracteres site:.

-------------------------- Exemplo 4 --------------------------

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

Neste exemplo, Get-CsMediaConfiguration e Where-Object são usados para retornar todas as configurações de mídia que suportam (mas não exigem) criptografia. Para fazer isso, o comando usa inicialmente Get-CsMediaConfiguration para recuperar todas as configurações de mídia em uso na organização. Em seguida, essas informações são redirecionadas para o cmdlet Where-Object, que aplica um filtro que restringe os dados retornados às configurações nas quais a propriedade EncryptionLevel seja igual a (-eq) SupportEncryption.

-------------------------- Exemplo 5 --------------------------

Get-CsMediaConfiguration -Filter *:*med*

Este exemplo recupera todas as configurações de mídia definidas para os sites e serviços cujos nomes contenham a cadeia de caracteres "med". Por exemplo, este comando recuperará as definições de configuração de mídia definidas para o site medford1, o site TwoMedfordPlace e o serviço Redmond-MediationServer-1 e o serviço MediationServer:redmond.litwareinc.com.