New-CsNetworkBandwidthPolicyProfile

 

Tópico modificado em: 2012-03-24

Cria um novo perfil de política de largura de banda de rede. Esse cmdlet também pode ser usado para definir as políticas de largura de banda dentro do perfil.

Sintaxe

New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Como parte do controle de admissão de chamadas (CAC), utiliza-se uma política de largura de banda para definir as limitações de largura de banda para determinadas modalidades (no Microsoft Lync Server 2010, as limitações de largura de banda podem ser atribuídas apenas às modalidades de áudio e vídeo). Esse cmdlet cria um perfil de contêiner para essas políticas. Ao chamar esse cmdlet, defina as políticas individuais dentro do contêiner, especificando as limitações de largura de banda de áudio e vídeo.

Os perfis de política de largura de banda são aplicados a sites de rede chamando-se o cmdlet New-CsNetworkSite ou Set-CsNetworkSite.

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

Parâmetros

Parâmetro	Obrigatório	Digite	Descrição
Identity	Obrigatório	XdsGlobalRelativeIdentity	Um valor de cadeia de caracteres que identifica de forma exclusiva a política. Todos os perfis de política de largura de banda são criados no escopo global. Portanto, o escopo é implícito e apenas um nome exclusivo precisa ser especificado ao se criar um novo perfil de política de largura de banda. Observe que esse valor também preenche a propriedade BWPolicyProfileID do perfil.
AudioBWLimit	Opcional	Cadeia de caracteres	A largura máxima de banda a se alocar para todas as conexões de áudio. Se uma única sessão de áudio exceder o limite de largura de banda de áudio, essa sessão não será iniciada. Expresso em kbps. Por exemplo, o valor 1000 significa 1000 kbps. Se você fornecer um valor para esse parâmetro, não será possível fornecer um valor para o parâmetro BWPolicy. Padrão: Se você fornecer um valor para o parâmetro AudioBWSessionLimit, mas não para AudioBWLimit, este será definido como 0.
AudioBWSessionLimit	Opcional	Cadeia de caracteres	A largura máxima de banda a se alocar por sessão de áudio. Expresso em kbps. O valor deve ser 40 ou superior. Se você fornecer um valor para esse parâmetro, não será possível fornecer um valor para o parâmetro BWPolicy. Padrão: Se você fornecer um valor para o parâmetro AudioBWLimit, mas não para AudioBWSessionLimit, este será definido como 175.
BWPolicy	Opcional	PSListModifier	Uma lista de objetos contendo perfis de política de largura de banda. Cada objeto na lista consiste em uma modalidade de largura de banda (áudio ou vídeo), uma limitação de largura de banda e uma limitação de sessão de largura de banda. Se você fornecer um valor para esse parâmetro, não será possível fornecer um valor para os parâmetros AudioBWLimit, AudioBWSessionLimit, VideoBWLimit, ou VideoBWSessionLimit. É possível criar objetos na lista chamando-se o cmdlet New-CsNetworkBWPolicy.
Description	Opcional	Cadeia de caracteres	Uma descrição do perfil de política de largura de banda. Por exemplo, é possível usar esse parâmetro para esclarecer o uso esperado do perfil.
VideoBWLimit	Opcional	Cadeia de caracteres	A largura máxima de banda a se alocar para todas as conexões de vídeo. Se uma única sessão de vídeo exceder o limite de largura de banda de vídeo, essa sessão não será iniciada. Expresso em kbps. Por exemplo, o valor 1000 significa 1000 kbps. Se você fornecer um valor para esse parâmetro, não será possível fornecer um valor para o parâmetro BWPolicy. Padrão: Se você fornecer um valor para o parâmetro VideoBWSessionLimit, mas não para VideoBWLimit, este será definido como 0.
VideoBWSessionLimit	Opcional	Cadeia de caracteres	A largura máxima de banda a se alocar por sessão de vídeo. Expresso em kbps. O valor deve ser 100 ou superior. Se você fornecer um valor para esse parâmetro, não será possível fornecer um valor para o parâmetro BWPolicy. Padrão: Se você fornecer um valor para o parâmetro VideoBWLimit, mas não para VideoBWSessionLimit, este será definido como 700.
Force	Opcional	SwitchParameter	Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.
InMemory	Opcional	SwitchParameter	Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.
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

Nenhuma.

Tipos de Retorno

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

Exemplo

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

New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500

O Exemplo 1 cria um novo perfil de política de largura de banda, denominado LowBWLimits. Esse novo perfil terá duas políticas atribuídas, uma política de áudio e uma de vídeo (as duas únicas políticas possíveis no Lync Server 2010). A política de áudio é adicionada ao perfil usando-se o parâmetro AudioBWLimit, para atribuir um limite, nesse caso, de 2000 kbps a conexões de áudio geral e o parâmetro AudioBWSessionLimit, para atribuir 200 kbps como o limite a sessões de áudio individuais. O mesmo é realizado para criar limites de sessão de vídeo, mas usando-se os parâmetros VideoBWLimit e VideoBWSessionLimit.

Consulte Também

Outros Recursos

Remove-CsNetworkBandwidthPolicyProfile
Set-CsNetworkBandwidthPolicyProfile
Get-CsNetworkBandwidthPolicyProfile
New-CsNetworkBWPolicy