• Artigo

Get-CsAVEdgeConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações de configuração dos computadores que estiverem executando o Serviço de Borda A/V na organização. As definições de configuração nesses computadores, também conhecidos como servidores de Borda A/V, permitem que os usuários internos compartilhem dados de áudio e vídeo com usuários externos (ou seja, usuários que não tiverem feito logon na rede interna), bem como troquem arquivos e participem de sessões de compartilhamento de área de trabalho.

Sintaxe

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

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

Descrição Detalhada

Os servidores de Borda A/V permitem que o tráfego de áudio e vídeo atravesse o firewall da organização. Entre outras coisas, isso permite que os usuários usem o Microsoft Lync Server 2010 na Internet e subsequentemente troquem dados de áudio e vídeo com usuários que tiverem feito logon no sistema de dentro do firewall. As definições de configuração do Servidor de Borda podem ser atribuídas no escopo global, de site e de serviço. As definições de configuração de Borda A/V permitem que os administradores realizem ações como gerenciar a duração da validade da autenticação do usuário até a obrigatoriedade de sua renovação e limitar a largura de banda que pode ser usada por um único usuário ou uma única porta.

O cmdlet Get-CsAVEdgeConfiguration constitui uma maneira de recuperar as informações sobre as definições de configuração de Borda A/V que estiverem em uso na sua organização.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de borda A/V a ser recuperada. Para recuperar a coleção global, utilize a seguinte sintaxe: -Identity global. Para recuperar uma coleção de sites, utilize uma sintaxe similar a esta: -Identity site:Redmond. As definições configuradas no escopo de serviço devem ser referenciadas usando-se uma sintaxe similar a esta: -Identity service:EdgeServer:atl-cs-001.litwareinc.com. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade de política.

Se esse parâmetro não for incluído, Get-CsAVEdgeConfiguration retornará uma coleção de todas as definições de configuração de Borda em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao indicar as definições de configuração de borda A/V a serem retornadas. Por exemplo, para retornar todas as definições configuradas no escopo do site, utilize esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as definições configuradas no escopo de serviço, utilize esta sintaxe: -Filter "service:*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de Borda A/V na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsAVEdgeConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsAVEdgeConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemplo

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

Get-CsAVEdgeConfiguration

O comando apresentado no Exemplo 1 retorna uma coleção de todas as definições de configuração de Borda A/V configuradas para uso na organização. O ato de chamar Get-CsAVEdgeConfiguration sem quaisquer parâmetros adicionais sempre retorna uma coleção completa de definições de configuração de Borda A/V.

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

Get-CsAVEdgeConfiguration -Identity site:Redmond

No Exemplo 2, retorna-se uma única coleção de definições de configuração de Borda A/V: a coleção com a Identidade site:Redmond.

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

Get-CsAVEdgeConfiguration -Filter "site:*"

O comando anterior retorna uma coleção de todas as definições de configuração de Borda A/V que tiverem sido configuradas no escopo de site. Para realizar isso, chama-se Get-CsAVEdgeConfiguration, juntamente com o parâmetro Filter. O valor de filtro "site:*" limita os dados retornados às definições que possuírem uma Identidade que começa com os caracteres "site:". Por definição, isso limita os dados retornados a definições configuradas no escopo de site.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -gt 10000}

No Exemplo 4, as únicas definições de configuração de Borda A/V retornadas são aquelas cuja propriedade MaxBandwidthPerUserKB for maior que 10.000 kilobits por segundo. Para realizar essa tarefa, o comando primeiramente chama Get-CsAVEdgeConfiguration, sem qualquer parâmetro. Isso retorna uma coleção de todas as definições de configuração de Borda A/V que estiverem em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade MaxBandwidthPerUserKB for maior do que 10.000 kilobits por segundo.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -eq 10000}

O Exemplo 5 é semelhante ao comando exibido no Exemplo 4. No Exemplo 5, no entanto, as únicas definições de Borda A/V retornadas apresentam a propriedade MaxBandwidthPerUserKB exatamente igual a 10.000 kilobits por segundo.

-------------------------- Exemplo 6 ------------------------

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxTokenLifetime -lt "08:00:00"}

O comando exibido no Exemplo 6 retorna apenas as definições de configuração de Borda A/V nas quais a propriedade MaxTokenLifetime for menor do que oito horas (08 horas: 00 minutos: 00 segundos). O comando chama inicialmente Get-CsAVEdgeConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as definições de configuração de Borda A/V usadas na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições em que MaxTokenLifetime for menor do que oito horas (08:00:00).