Compartilhar via

  • Artigo

Remove-CsNetworkBandwidthPolicyProfile

 

Tópico modificado em: 2012-03-26

Remove um perfil de diretiva de largura de banda de rede.

Sintaxe

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Como parte de um controle de admissão de chamadas (CAC), uma diretiva de largura de banda é utilizada para definir limites para certas modalidades. (no Microsoft Lync Server 2010, somente as modalidades de áudio e vídeo podem receber a atribuição de limites de largura de banda). Este cmdlet remove um perfil que atua como contêiner para essas diretivas.

IMPORTANTE: Se um perfil tiver sido atribuído a um site (usando o cmdlet New-CsNetworkSite ou Set-CsNetworkSite), a uma diretiva entre sites (usando o cmdlet New-CsNetworkInterSitePolicy ou Set-CsNetworkInterSitePolicy) ou a um link de região de rede (usando o cmdlet New-CsNetworkRegionLink ou Set-CsNetworkRegionLink), ele não poderá ser removido. Você receberá um erro se tentar remover o perfil chamando Remove-CsNetworkBandwidthPolicyProfile. É preciso primeiro remover o perfil de todos os sites, diretivas entre sites e links de região de rede, para depois removê-lo.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Um valor do tipo cadeia de caracteres que identifica exclusivamente o perfil de diretiva de largura de banda que você deseja remover. Quando você especifica uma Identity, vai remover no máximo um único perfil.

Force

Opcional

SwitchParameter

Suprime a exibição de qualquer prompt de confirmação que de outra forma seria exibido antes de se efetuar 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.NetworkConfiguration.BWPolicyProfileType. Aceita entrada em pipeline de objetos de perfil de diretiva 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.NetworkConfiguration.BWPolicyProfileType.

Exemplo

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

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

Este exemplo remove o perfil de diretiva de largura de banda com identidade igual a LowBWProfile. Uma vez que as identidades precisam ser exclusivas, isso removerá no máximo um único perfil.

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

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

O Exemplo 2 remove todas as referências ao perfil de diretiva de largura de banda com Identidade igual a LowBWProfile de todos os sites aos quais ele tenha sido atribuído e, em seguida, remove o perfil. A primeira linha deste exemplo começa com uma chamada a Get-CsNetworkSite para recuperar todos os sites configurados para o CAC (controle de admissão de chamadas). Essa coleção de sites é então canalizada para o Where-Object, que procura apenas os sites nos quais BWPolicyProfileID seja igual a (-eq) LowBWProfile. Essa coleção refinada, contendo apenas os sites com valor de BWPolicyProfileID igual a LowBWProfile, é canalizada para Set-CSNetworkSite, que modifica cada um desses sites para alterar o BWPolicyProfileID para Null ($null). O que acabamos de fazer é encontrar todos os sites com BWPolicyProfileID igual a LowBWProfile e definir esse valor com Null. Nesse momento, não há mais sites usando o perfil LowBWProfile. Agora chamamos Remove-CsNetworkBandwidthPolicyProfile no perfil LowBWProfile para removê-lo, sabendo que ele não está sendo usado em nenhum site.

Para garantir que o perfil não esteja em uso em nenhum outro lugar da configuração de rede, realize as mesmas etapas da Linha 1 nas diretivas entre sites e nos links de região de rede.