Compartilhar via

  • Artigo

Set-CsQoEConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção existente de definições de QoE (Qualidade da Experiência).

Sintaxe

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

Set-CsQoEConfiguration [-Confirm [<SwitchParameter>]] [-EnableExternalConsumer <$true | $false>] [-EnablePurging <$true | $false>] [-EnableQoE <$true | $false>] [-ExternalConsumerIssuedCertId <IssuedCertId>] [-ExternalConsumerName <String>] [-ExternalConsumerURL <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-KeepQoEDataForDays <UInt32>] [-PurgeHourOfDay <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Os atributos métricos da QoE rastreiam a qualidade das chamadas de áudio e vídeo feitas na organização, inclusive o número de pacotes de rede perdidos, o ruído de fundo e a quantidade de "jitter" (diferenças no atraso de pacotes). Esses atributos métricos são armazenados em um banco de dados separado de outros dados (como registro de detalhes das chamadas), permitindo a habilitação e desabilitação do QoE, independentemente de outros registros de dados. Utiliza-se este cmdlet para modificar as definições que configuram a QoE nos níveis global e de site.

QoE é parte da função do Servidor de Monitoramento; portanto, o Servidor de Monitoramento deve ser implantado na instalação do Microsoft Lync Server 2010 antes que o registro de QoE entre em funcionamento ou que os dados de QoE possam ser coletados.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsQoEConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsQoEConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Um identificador exclusivo das definições que se deseja modificar. Os valores possíveis são global e site:<nome do site>, onde <nome do site> é o nome do site na implantação do Lync Server 2010 ao qual se deseja aplicar as alterações.

Instance

Opcional

QoESettings

Uma referência a um objeto de configuração de QoE. Este objeto deve ser do tipo QoESettings e pode ser recuperado mediante chamada de Get-CsQoEConfiguration.

EnableExternalConsumer

Opcional

Booleano

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

EnablePurging

Opcional

Booleano

Especifica se os registros serão removidos após o término do período definido na propriedade KeepQoEDataForDays.

EnableQoE

Opcional

Booleano

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

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

ExternalConsumerIssuedCertId

Opcional

IssuedCertId

O ID do certificado que libera o acesso aos serviços web de consumidor externo.

ExternalConsumerName

Opcional

Cadeia de caracteres

O nome intuitivo do consumidor externo do relatório de QoE.

ExternalConsumerURL

Opcional

Cadeia de caracteres

O URL do consumidor externo para o qual os relatórios de QoE serão enviados.

KeepQoEDataForDays

Opcional

UInt32

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

Deve ser um valor entre 1 e 2562.

PurgeHourOfDay

Opcional

UInt32

A hora do dia em que serão removidos os registros de QoE que tiverem excedido o número de dias especificado na propriedade KeepQoEDataForDays.

Deve ser um valor entre 0 e 23, representando a hora do dia. Por exemplo, 0 seria meia-noite, 13 seria uma hora da tarde.

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.QoE.QoESettings. Aceita entrada canalizada de objetos de configuração de QoE.

Tipos de Retorno

Set-CsQoEConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemplo

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

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

O comando no Exemplo 1 utiliza o cmdlet Set-CsQoEConfiguration para modificar as definições de Qualidade de Experiência do site de Redmond (-Identity site:Redmond). As novas definições desativarão a QoE, por meio da atribuição do parâmetro EnableQoE como False.

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

Set-CsQoEConfiguration -Identity site:Dublin -KeepQoEDataForDays 45 -PurgeHourOfDay 4

Este comando modifica as definições de QoE que se aplicarem ao site de Dublin. Neste exemplo, define-se o parâmetro KeepQoEDataForDays como 45, de forma que os dados de QoE sejam removidos do banco de dados após 45 dias. Além disso, definiu-se o parâmetro PurgeHourOfDay como sendo 4, o que significa que qualquer dado com mais de 45 dias, conforme definiu-se anteriormente, será removido às quatro horas da manhã.

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