Compartilhar via

  • Artigo

Remove-CsBandwidthPolicyServiceConfiguration

 

Tópico modificado em: 2012-03-27

Remove uma configuração existente de serviço de política de largura de banda.

Sintaxe

Remove-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O controle de admissão de chamadas (CAC) é uma maneira de determinar se as sessões de comunicação em tempo real, como chamadas de voz ou de vídeo, devem ser estabelecidas com base nas restrições de largura de banda. Na implementação do Microsoft Lync Server 2010 do CAC, as regiões, os sites e as sub-redes são definidos em uma rede, juntamente com os relacionamentos e links entre essas entidades, para impor restrições de largura de banda entre elas. O serviço de Política de Largura de Banda é o componente que realiza a funcionalidade do CAC na implantação do Lync Server 2010, permitindo-se decidir se há largura de banda suficiente para o estabelecimento de uma chamada. Esse cmdlet remove uma configuração de serviço de política de largura de banda definida no nível de site. Também é possível usar o cmdlet para "remover" o serviço global de política de largura de banda. No entanto, o serviço global não será removido de fato. Ele simplesmente será redefinido com os seus valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsBandwidthPolicyServiceConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsBandwidthPolicyServiceConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

O identificador exclusivo da configuração que se deseja remover. Esse identificador consistirá no escopo (na configuração global) ou no escopo e no nome (em uma configuração no nível do site, como site:Redmond).

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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration. Aceita entradas canalizadas dos objetos de configuração do serviço de política de largura de banda.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Exemplo

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

Remove-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

Esse exemplo remove a configuração do serviço de política de largura de banda definida do site Redmond (-Identity site:Redmond).

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

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.EnableLogging -eq $False} | Remove-CsBandwidthPolicyServiceConfiguration

O Exemplo 2 remove todas as configurações de serviço de política de largura de banda nas quais o logon estiver desabilitado. Para realizar isso, o exemplo efetua inicialmente uma chamada a Get-CsBandwidthPolicyServiceConfiguration. Isso retornará uma coleção de todas as configurações de serviço de política de largura de banda na implantação do Lync Server 2010. Esta coleção será então canalizada para o cmdlet Where-Object, que restringirá a coleção apenas às configurações cuja propriedade EnableLogging for igual a (-eq) False ($False). Isso cria uma coleção de configurações nas quais o logon está desabilitado. Esta coleção será então canalizada para Remove-CsBandwidthPolicyServiceConfiguration, que removerá cada item na coleção.