Compartilhar via

  • Artigo

New-CsQoEConfiguration

 

Tópico modificado em: 2012-03-25

Cria uma nova coleção de configurações da QoE (Qualidade da Experiência).

Sintaxe

New-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Métricas de QoE monitoram a qualidade de chamadas de áudio e vídeo feitas na sua organização, incluindo coisas como o número de pacotes de rede perdidos, ruído de fundo e a quantidade de "tremulação" (diferenças em atraso de pacote). Estas métricas são armazenadas em um banco de dados separadas de outros dados (tais como registros de detalhes das chamadas), o que permite que você habilite e desabilite QoE, independente da gravação de outros dados. Use este cmdlet para criar configurações que configurem o QoE ao nível do site. (Configurações ao nível global existem por padrão e não podem ser removidas.)

QoE é parte da função Servidor de Monitoramento; portanto, Servidor de Monitoramento tem que ser implantado na sua instalação do Microsoft Lync Server 2010 para que a gravação do QoE tenha efeito ou dados do QoE possam ser coletados.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O site para o qual as novas configurações se aplicam. Isso precisa ser inserido no formato site:<nome do site>, em que <nome do site> é o nome do site na sua implantação do Lync Server 2010.

EnableExternalConsumer

Opcional

Booleano

Especifica se um consumidor externo é capaz de receber relatórios de QoE.

Padrão: Falso

EnablePurging

Opcional

Booleano

Especifica se os registros vão ser removidos depois que a duração definida na propriedade KeepQoEDataForDays tiver expirado.

Padrão: Verdadeiro

EnableQoE

Opcional

Booleano

Especifica se os registros de QoE vão ser coletados e salvos no banco de dados de monitoramento.

Observe que mesmo se EnableQoE estiver definido como True, os dados do QoE não serão coletados sem que um Servidor de Monitoramento tenha sido implantado e associado a um pool de Registrador.

Padrão: Verdadeiro

ExternalConsumerIssuedCertId

Opcional

IssuedCertId

O ID do certificado que permite acesso ao serviço da web do consumidor externo.

ExternalConsumerName

Opcional

Cadeia de caracteres

O nome amigável do consumidor externo do relatório de QoE.

ExternalConsumerURL

Opcional

Cadeia de caracteres

A URL do consumidor externo para a qual os relatórios de QoE vão ser postados.

KeepQoEDataForDays

Opcional

UInt32

O número de dias que os dados de QoE vão ser armazenados antes de serem removidos do banco de dados. Este valor será ignorado se EnablePurging for definido como False.

Deve ser um valor de 1 a 2562.

Padrão: 60

PurgeHourOfDay

Opcional

UInt32

A hora do dia em que os registros de QoE que excederam o número de dias especificados na propriedade KeepQoEDataForDays será apagada.

Deve ser um valor 0 a 23, representando a hora do dia. Por exemplo, 0 seria meia-noite, 13 seria 1:00 da noite. Padrão: 1

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.QoE.QoESettings.

Exemplo

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

New-CsQoEConfiguration -Identity site:Redmond -EnableQoE $False

O comando no Exemplo 1 usa o cmdlet New-CsQoEConfiguration para criar um novo conjunto de configurações da Qualidade de Experiência com Identity site:Redmond. Além de Identity site:Redmond, as novas configurações também têm a propriedade EnableQoE definida como False. Como as configurações de site têm precedência sobre configurações globais, isso significa que QoE vai ser desabilitada para o site Redmond, independente de a QoE ter sido habilitada no escopo global.

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

New-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 30 -PurgeHourOfDay 4

Este comando cria novas configurações QoE que se aplicam ao site Dublin. Neste exemplo, definimos o parâmetro KeepQoEDataForDays como 30, então os dados de QoE vão ser removidos do banco de dados após 30 dias, em vez dos 60 dias padrão. Além disso, definimos o parâmetro PurgeHourOfDay para 4, o que significa que quaisquer dados mais antigos do que os 30 dias que acabamos de especificar vão ser removidos às 4:00 da manhã.

Nota: Se você tiver habilitado QoE e CDR (registro de detalhes das chamadas), é uma boa ideia garantir que a configuração PurgeHourOfDay seja diferente para QoE do que é para CDR, por motivos de desempenho.