Compartilhar via

  • Artigo

Set-CsBandwidthPolicyServiceConfiguration

 

Tópico modificado em: 2012-03-27

Modifica uma configuração existente de serviço de política de largura de banda.

Sintaxe

Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O controle de admissão de chamadas (CAC) é uma maneira de determinar se as sessões de comunicação em tempo real, como chamadas de voz ou de vídeo, devem ser estabelecidas com base nas restrições de largura de banda. Na implementação do Microsoft Lync Server 2010 do CAC, as regiões, os sites e as sub-redes são definidos em uma rede, juntamente com os relacionamentos e links entre essas entidades, para impor restrições de largura de banda entre elas. O serviço de Política de Largura de Banda é o componente que realiza a funcionalidade do CAC na implantação do Lync Server 2010, permitindo-se decidir se há largura de banda suficiente para o estabelecimento de uma chamada. Este cmdlet modifica uma configuração existente de serviço de política de largura de banda.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da configuração que se deseja alterar. Esse identificador consistirá no escopo (na configuração global) ou no escopo e no nome (em uma configuração no nível do site, como site:Redmond, por exemplo).

Instance

Opcional

BandwidthPolicyServiceConfiguration

Uma referência a um objeto de configuração de serviço da política de largura de banda. O objeto deve ser do tipo BandwidthPolicyServiceConfiguration, que pode ser recuperado chamando-se o cmdlet Get-CsBandwidthPolicyServiceConfiguration.

EnableLogging

Opcional

Booleano

Defina essa definição como True, para gerar logs de status de link e falha de CAC relacionados ao serviço de política de largura de banda.

LogCleanUpInterval

Opcional

TimeSpan

O período após o qual serão removidos os logs de status do link e falha de CAC.

Este valor deve estar no intervalo entre um e 60 dias. O valor deve ser inserido no formato dd.hh:mm:ss, em que d é dias, h é horas, m é minutos e s é segundos. Por exemplo, 20 dias seriam 20.00:00:00.

MaxLogFileSizeMb

Opcional

UInt32

O tamanho máximo até que o arquivo de log pode atingir. O valor desse parâmetro deve ser um número positivo e especifica o tamanho do arquivo, em megabytes. Por exemplo, para permitir que o arquivo de log alcance um tamanho máximo de 10 megabytes, insira o valor 10.

MaxTokenLifetime

Opcional

TimeSpan

O período máximo no qual o token emitido pelo serviço de Autenticação de Política de Largura de Banda existirá.

Este valor deve estar no intervalo entre uma e 24 horas. O valor deve ser inserido no formato dd.hh:mm:ss, em que d é dias, h é horas, m é minutos e s é segundos. Por exemplo, o valor 12 horas seria 12:00:00.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as 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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration. Aceita entrada canalizada dos objetos de configuração do serviço de política de largura de banda.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Exemplo

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

Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00

Esse exemplo modifica a configuração do serviço de política de largura de banda do site de Redmond (-Identity site:Redmond). A configuração é modificada de forma a habilitar o registro, alterar a vida útil máxima de um token para três horas e o número de dias antes da limpeza do registro para cinco dias. Isso tudo é realizado por esse único comando. Para habilitar o log, o parâmetro EnableLogging é definido como True ($true). A seguir, o parâmetro MaxTokenLifetime recebe o valor 3:00:00, que representa três horas. Finalmente, o parâmetro LogCleanUpInterval recebe o valor 5.00:00:00, que indica cinco dias.