Compartilhar via

  • Artigo

Remove-CsQoEConfiguration

 

Tópico modificado em: 2012-03-27

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

Sintaxe

Remove-CsQoEConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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, 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 remover definições que configurem o QoE ao nível do site. Chamando este cmdlet na configuração QoE global vai redefinir todas as propriedades como os padrões.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O identificador único das configurações que você quer remover. Valores possíveis são global e site:<nome do site>, onde <nome do site> é o nome do site na sua Microsoft Lync Server 2010 implantação com as configurações a serem removidas.

Force

Opcional

SwitchParameter

Suprimi qualquer aviso de confirmação que seria de outra forma exibido antes de fazer 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 em pipeline de objetos de configuração de QoE.

Tipos de Retorno

Este cmdlet não retorna um valor ou objeto. Em vez disso, ele remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.QoE.QoESettings.

Exemplo

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

Remove-CsQoEConfiguration -Identity site:Redmond

O comando anterior usa Remove-CsQoEConfiguration para remover as configurações de QoE atribuídas ao site Redmond. O uso do parâmetro Identity garante que somente as configurações atribuídas ao site especificado vão ser removidas.

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

Get-CsQoEConfiguration -Filter site:* | Remove-CsQoEConfiguration

O comando mostrado no Exemplo 2 remove todas as configurações de QoE que foram atribuídas no escopo do site. Para fazer isto, o comando primeiro usa Get-CsQoEConfiguration e o parâmetro Filter para recuperar as configurações de QoE apropriadas; a cadeia de caracteres curinga "site:*" garante que somente aquelas configurações com identidade começando com o valor da cadeia de caracteres site: sejam retornadas. A coleção filtrada é então passada a Remove-CsQoEConfiguration, que exclui todos os itens na coleção.

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

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

No Exemplo 3, quaisquer configurações de QoE em que a propriedade KeepQoEDataForDays é menos do que 30 dias são excluídas. Para executar esta tarefa, o comando chama Get-CsQoEConfiguration, sem nenhum parâmetro, para retornar uma coleção de todas as configurações de QoE atualmente em uso na organização. Essa coleção é então encaminhada para o cmdlet Where-Object, que seleciona somente as configurações cuja propriedade KeepQoEDataForDays seja menor do que (-lt) 30 dias. Em seguida, a coleção filtrada é encaminhada para Remove-CsQoEConfiguration, que exclui cada item naquela coleção.