Compartilhar via

  • Artigo

Get-CsBandwidthPolicyServiceConfiguration

 

Tópico modificado em: 2012-03-23

Recupera uma ou mais configurações de serviço de diretiva de largura de banda.

Sintaxe

Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Descrição Detalhada

O CAC (controle de admissão de chamadas) é uma forma de determinar se será permitido que sessões de comunicação em tempo real, como chamadas de voz ou vídeo, sejam estabelecidas com base em restrições de largura de banda. Dentro da implementação do CAC do Microsoft Lync Server 2010, regiões, sites e sub-redes são definidos em uma rede, com as relações e os links entre essas entidades para impor restrições de largura de banda entre elas. O serviço de diretiva de largura de banda é o componente que realiza a funcionalidade do CAC na implantação do Lync Server 2010, permitindo decidir se existe ou não largura de banda suficiente para que uma chamada seja estabelecida. O cmdlet Get-CsBandwidthPolicyServiceConfiguration recupera as configurações de um ou mais serviços de diretiva de largura de banda.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

O identificador único da configuração que você deseja recuperar. Este identificador consistirá do escopo (para a configuração global) ou do escopo e do nome (para uma configuração em nível de site, como site:Redmond).

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres contendo um ou mais caracteres curinga que serão usados para pesquisar a propriedade Identity de todas as configurações de serviço de diretiva de largura de banda para localizar todas as configurações nas quais Identity corresponda ao padrão do curinga. Por exemplo, o valor de filtro site:* irá recuperar todas as configurações nas quais os valores de Identity comecem com a cadeia de caracteres site: e terminem com qualquer conjunto de caracteres.

LocalStore

Opcional

SwitchParamter

Obtém a configuração de serviço de diretiva de largura de banda a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Retorna um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Exemplo

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

Get-CsBandwidthPolicyServiceConfiguration

O Exemplo 1 recupera todas as configurações de serviço de diretiva de largura de banda definidas na implementação do Microsoft Lync Server 2010.

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

Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

Este exemplo recupera a configuração de serviço de diretiva de largura de banda definida para o site Redmond (-Identity site:Redmond).

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

Get-CsBandwidthPolicyServiceConfiguration -Filter site:*

Neste exemplo, usamos o parâmetro Filter para recuperar todas as configurações de serviço de diretiva de largura de banda definidas em nível de site. Fazemos isso passando o valor site:* ao parâmetro Filter. Isso irá pesquisar a propriedade Identity de todas as configurações de serviço de diretiva de largura de banda em busca de valores que comecem com site: e sejam seguidos por quaisquer outros caracteres. Como todas as configurações em nível de site possuem valores de identidade começando com site: e seguidos pelo nome do site, o filtro irá localizar todas as configurações de todos os sites.

-------------------------- Exemplo 4 --------------------------

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}

O Exemplo 4 recupera todas as configurações de serviço de diretiva de largura de banda que permitam que arquivos de log sejam maiores do que quatro megabytes. O exemplo começa com uma chamada ao cmdlet Get-CsBandwidthPolicyServiceConfiguration. Como no Exemplo 1, este cmdlet recupera uma coleção de todas as configurações definidas na implementação do Lync Server. Esta coleção é então canalizada para o cmdlet Where-Object. O cmdlet Where-Object percorre a coleção, um item de cada vez. Para cada item na coleção, Where-Object verifica se o valor da propriedade MaxLogFileSizeMb é maior do que (-gt) 4. Se for, o item continua sendo parte da coleção, e será parte da saída do comando. Se o valor de MaxLogFileSizeMb não for maior do que 4, o item será ignorado e não será retornado.