Compartilhar via

  • Artigo

New-CsBandwidthPolicyServiceConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova configuração do serviço de diretiva de largura de banda.

Sintaxe

New-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<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. Esse cmdlet configura um novo serviço de diretiva de largura de banda em nível de site.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Um identificador exclusivo que contém o escopo e o nome da configuração. Como essa configuração só pode ser criada no escopo do site, o parâmetro Identity se apresentará no seguinte formato: site:<nome do site>, onde <nome do site> é o nome do site ao qual as configurações se aplicam.

EnableLogging

Opcional

Booleano

Define o parâmetro como True para gerar logs de falha do CAC e de status do link relacionados ao serviço de diretiva de largura de banda.

Padrão: Falso

LogCleanUpInterval

Opcional

TimeSpan

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

Esse valor deve estar no intervalo de 1 a 60 dias. O valor deve ser inserido no formato dd.hh:mm:ss, em que d são dias, h são horas, m são minutos e s são segundos.

Padrão: 10 dias (10.00:00:00)

MaxLogFileSizeMb

Opcional

UInt32

O tamanho máximo que o arquivo de log pode alcançar. O valor desse parâmetro deve ser um número positivo; ele especifica o tamanho do arquivo em megabytes.

Padrão: 3 (MB)

MaxTokenLifetime

Opcional

TimeSpan

O valor de tempo máximo durante o qual o token emitido pelo serviço de Autenticação de Diretiva de Largura de Banda existirá.

Esse valor deve estar no intervalo de 1 a 24 horas. O valor deve ser inserido no formato dd.hh:mm:ss, em que d são dias, h são horas, m são minutos e s são segundos.

Padrão: 8 horas (08:00:00)

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Exemplo

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

Este exemplo cria uma nova configuração do serviço de diretiva de largura de banda no site Redmond (-Identity site:Redmond). Como nenhum outro parâmetro é especificado, os padrões são usados para todos os valores de configuração.

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00

Neste exemplo, criamos, mais uma vez, uma nova configuração do serviço de diretiva de largura de banda, desta vez para o site de Dublin (-Identity site:Dublin). Para esse site, em vez de aceitar os valores padrão, queremos habilitar o registro em log e definir o número de dias decorridos antes dos logs serem limpos em até 30 dias. Fazemos isso passando um valor True ($True) para o parâmetro EnableLogging e, em seguida, passando um valor de 30.00:00:00 para o parâmetro LogCleanupInterval. O valor LogCleanupInterval é um objeto TimeSpan, no formato dd.hh:mm:ss, em que d são dias, h são horas, m são minutos e s são segundos.