• Artigo

Remove-CsAVEdgeConfiguration

 

Tópico modificado em: 2012-03-27

Permite remover uma coleção existente de definições de configuração aplicadas a computadores que estiverem executando o Serviço de Borda de Acesso (estes computadores também são conhecidos como servidores de Borda A/V). Os Servidores de Borda A/V permitem que 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 sua rede interna).

Sintaxe

Remove-CsAVEdgeConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 o 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 Remove-CsAVEdgeConfiguration permite excluir definições de configuração de borda A/V que tiverem sido aplicadas nos escopos de site ou de serviço. O cmdlet também pode ser executado concomitantemente às definições globais; entretanto, as definições globais não serão excluídas. Em vez disso, as propriedades contidas na coleção global serão redefinidas com os seus valores padrão.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de borda A/V a ser removida. Para "remover" a coleção global, use a seguinte sintaxe: -Identity global. (conforme observado anteriormente, as definições globais não podem ser removidas; as propriedades podem apenas ser redefinidas com os seus valores padrão.) Para remover uma coleção de site, 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.

Não é possível usar curingas ao se especificar uma política Identity.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

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

Confirm

Opcional

Parâmetro de opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings. O cmdlet Remove-CsAVEdgeConfiguration aceita entradas canalizadas de objetos de definição de retransmissão de mídia. Estes objetos são recuperados executando-se o cmdlet Get-CsAVEdgeConfiguration.

Tipos de Retorno

Remove-CsAVEdgeConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Exemplo

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

Remove-CsAVEdgeConfiguration -Identity site:Redmond

O comando anterior remove as definições de configuração de borda A/V cuja identidade for site:Redmond. Depois que as definições tiverem sido removidas, os servidores de borda A/V no site de Redmond serão controlados pelas definições globais de configuração.

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

Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

No Exemplo 2, serão removidas todas as definições de configuração de borda A/V que tiverem sido aplicadas no escopo de serviço. Para isso, o comando chama primeiramente Get-CsAVEdgeConfiguration, juntamente com o parâmetro Filter. O valor de filtro "service:*" garante que sejam retornadas apenas as definições configuradas no escopo de serviço. Em seguida, essa coleção filtrada será redirecionada para Remove-CsAVEdgeConfiguration, que excluirá cada item da coleção.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

O comando apresentado no Exemplo 3 exclui todas as definições de configuração de borda A/V cujo valor da propriedade MaxBandwidthPerUserKB for menor do que 5.000 kilobits por segundo. Para realizar essa tarefa, o comando utiliza primeiramente Get-CsAVEdgeConfiguration, sem qualquer parâmetro adicional, para retornar uma coleção de todas as definições de borda A/V em uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade MaxBandwidthPerUserKB for menor do que 5.000. A coleção filtrada será então canalizada para Remove-CsAVEdgeConfiguration, que excluirá cada item na coleção.