• Artigo

Get-CsQoEConfiguration

 

Tópico modificado em: 2012-03-23

Recupera uma ou várias coleções de definições de QoE (Qualidade da experiência).

Sintaxe

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

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

Descrição Detalhada

Os atributos métricos do 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 registros de detalhes das chamadas), permitindo a habilitação e desabilitação do QoE, independentemente de outros registros de dados. Use esse cmdlet para recuperar as definições que configuram o QoE no nível global ou de site.

O 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 Get-CsQoEConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsQoEConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo das definições que se deseja recuperar. 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.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga para retornar uma coleção (ou diversas coleções) de definições de configuração do QoE. Para retornar uma coleção de todas as definições configuradas no escopo de site, utilize essa sintaxe: -Filter site:*. Para retornar uma coleção de todas as definições que possuírem o valor de cadeia de caracteres "Western" em alguma posição da Identidade (a única propriedade que se pode filtrar), utilize essa sintaxe: -Filter *Western*.

LocalStore

Opcional

SwitchParameter

Recupera as definições na réplica local do Repositório de Gerenciamento Central.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsQoEConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemplo

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

Get-CsQoEConfiguration

Esse exemplo utiliza Get-CsQoEConfiguration para retornar uma coleção de todas as definições de QoE configuradas para uso na organização.

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

Get-CsQoEConfiguration -Identity site:Redmond

O Exemplo 2 usa o parâmetro Identity para garantir que o Get-CsQoEConfiguration retorne apenas as definições de QoE cuja Identidade for site:Redmond.

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

Get-CsQoEConfiguration -Filter site:*

No Exemplo 3, utiliza-se o parâmetro Filter, para retornar todas as definições de QoE que tiverem sido configuradas no escopo de site. O caractere curinga "site:*" retorna todas as definições do QoE cuja Identidade começar com o valor de cadeia de caracteres site:. As definições que atenderem a esses critérios serão aquelas que tiverem sido configuradas no escopo de site.

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

Get-CsQoEConfiguration | Where-Object {$_.KeepQoEDataForDays -lt 30}

O exemplo anterior retorna uma coleção de todas as definições de QoE cuja propriedade KeepQoEDataForDays for menor do que 30 dias. Para fazer isso, o comando usa primeiramente Get-CsQoEConfiguration, para retornar uma coleção de todas as definições de QoE configuradas na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que aplicará um filtro que limita os dados retornados às definições que possuírem um valor de KeepQoEDataForDays inferior a 30 dias.