Compartilhar via

  • Artigo

New-CsNetworkBWPolicy

 

Tópico modificado em: 2012-03-25

Cria uma política de largura de banda que pode ser aplicada ao perfil de política de largura de banda. No Microsoft Lync Server 2010, a política se aplica à largura de banda de áudio ou vídeo.

Sintaxe

New-CsNetworkBWPolicy -BWLimit <UInt32> -BWPolicyModality <Audio | Video> -BWSessionLimit <UInt32>

Descrição Detalhada

Esse cmdlet cria uma nova política de largura de banda. Uma política de largura de banda é usada para definir as limitações de largura de banda de determinadas modalidades. (no Lync Server 2010, as limitações de largura de banda podem ser atribuídas apenas às modalidades de áudio e vídeo). A política de largura de banda é criada apenas na memória. Portanto, a saída deve ser atribuída a uma variável e, em seguida, passada como um valor para o parâmetro BWPolicy do cmdlet New-CsNetworkBandwidthPolicyProfile ou Set-CsNetworkBandwidthPolicyProfile. As políticas de largura de banda se aplicam a perfis de políticas, que podem armazenar diversas políticas de um único perfil e são parte da configuração de rede global para o CAC.

Observe que o método recomendado de atribuição de políticas de áudio e vídeo consiste em atribui-las diretamente a um perfil de política de largura de banda, chamando-se o cmdlet New-CsNetworkBandwidthPolicyProfile ou Set-CsNetworkBandwidthPolicyProfile e especificando valores para os parâmetros AudioBWLimit, AudioBWSessionLimit, VideoBWLimit e VideoBWSessionLimit.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsNetworkBWPolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkBWPolicy"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

BWLimit

Obrigatório

UInt32

A largura de banda total máxima (em kbps) de todas as sessões simultâneas do tipo especificado no parâmetro BWPolicyModality.

BWPolicyModality

Obrigatório

BWPolicyModality

Determina qual tipo de largura de banda será limitada.

Valores válidos: Áudio, vídeo

BWSessionLimit

Obrigatório

UInt32

A largura de banda máxima (em kbps), permitida a uma única sessão do tipo especificado no parâmetro BWPolicyModality.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType.

Exemplo

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

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video

Esse exemplo cria uma nova política de largura de banda e a atribui à variável $bwp. Todos os parâmetros do cmdlet New-CsNetworkBWPolicy são obrigatórios. Neste exemplo, especificamos um limite total de largura de banda (BWLimit) de 2000 kbps e um limite de sessão de largura de banda (BWSessionLimit) de 300 kbps, aplicando-os a sessões de vídeo (-BWPolicyModality video).

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

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bwp

O Exemplo 2 amplia o âmbito do Exemplo 1, atribuindo a nova política de largura de banda a um perfil de política. O comando na linha 1 é idêntico ao Exemplo 1: ele cria limitações de largura de banda de vídeo. Em seguida, a linha 2 chama New-CsNetworkBandwidthPolicyProfile, para adicionar essa política a um novo perfil. O novo perfil recebe a Identidade LowBWLimit. Em seguida, usa-se o parâmetro BWPolicy, dando a ele o valor $bwp, que é a variável que contém a nova política de largura de banda que acabamos de criar na Linha 1.