Compartilhar via

  • Artigo

Get-CsNetworkBandwidthPolicyProfile

 

Tópico modificado em: 2012-03-23

Recupera um ou mais perfis de política de largura de banda de rede.

Sintaxe

Get-CsNetworkBandwidthPolicyProfile [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkBandwidthPolicyProfile [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

As políticas de largura de banda, que integram o controle de admissão de chamadas (CAC), são usadas 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 recupera um ou vários perfis de contêiner correspondentes a essas políticas.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

Um valor de cadeia de caracteres que identifica exclusivamente o perfil de política de largura de banda a ser recuperado. A especificação de uma Identidade irá recuperar, no máximo, um perfil.

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que contém curingas, usada para recuperar perfis de política de largura de banda que possuem valores de Identidade correspondentes ao padrão de curinga.

LocalStore

Opcional

SwitchParameter

Recupera o perfil da política de largura de banda da rede na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

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

Exemplo

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

Get-CsNetworkBandwidthPolicyProfile

A chamada de Get-CsNetworkBandwidthPolicyProfile sem parâmetros irá recuperar todos os perfis de política de largura de banda definidos na implantação do Lync Server 2010.

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

Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

Esse exemplo recupera o perfil de política de largura de banda com a Identidade LowBWProfile. Pelo fato de as identidades serem exclusivas, isso retornará, no máximo, um perfil.

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

Get-CsNetworkBandwidthPolicyProfile -Filter *50MB*

Nesse exemplo, usamos o parâmetro Filtro para especificar um ou vários perfis a serem recuperados, com base em uma cadeia de caracteres curinga. Usamos a cadeia de caracteres *50MB*, que indica que queremos recuperar todos os perfis de política de largura de banda com valores de Identidade que contenham a cadeia de caracteres 50MB em qualquer posição do valor. Por exemplo, isso recupera perfis com identidades como “BW profile for 50MB links”, “50MB audio limit”, e “video limits of 50MB”.