Compartilhar via

  • Artigo

Remove-CsDiagnosticConfiguration

 

Tópico modificado em: 2012-03-25

Remove uma ou mais coleções de definições de configuração de diagnóstico em uso na organização. As definições de configuração de diagnóstico são utilizadas para determinar se o tráfego de ou para um determinado domínio ou Identificador de Recurso Uniforme (URI) está sendo registrado nos arquivos de registro do Microsoft Lync Server 2010.

Sintaxe

Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Se você habilitar o registro em log no Lync Server 2010, o tráfego de e para qualquer domínio ou URI será, por padrão, incluído naqueles arquivos de log. Isto garante o registro da máxima quantidade possível de informações nos arquivos de log.

Entretanto, isto pode ocasionalmente resultar em demasiadas informações. Por exemplo, se houver problemas de conectividade com um domínio em especial, limite o log ao tráfego entre a rede e esse domínio. Isso facilitará a identificação dos registros relevantes que, por sua vez, poderá facilitar o diagnóstico e a correção do problema.

As definições de configuração de diagnóstico permitem especificar os domínios ou URIs que serão registrados nos arquivos de log; se a filtragem de diagnóstico for habilitada, apenas o tráfego de/para os domínios específicos será registrado em log. O Lync Server permite criar definições de configuração de diagnóstico e aplicar os filtros de diagnóstico no escopo de site. Por sua vez, isto permite aplicar o filtro ao site Redmond, por exemplo, enquanto se deixa a filtragem desabilitada nos outros sites.

É possível usar o cmdlet Remove-CsDiagnosticConfiguration para remover qualquer uma das definições de configuração de diagnóstico que tiverem sido criadas no escopo do site. O cmdlet Remove-CsDiagnosticConfiguration também pode ser executado nas definições globais da configuração de diagnóstico. Neste caso, no entanto, a coleção não vai ser excluída; isto porque Lync Server não permite que você exclua coleções globais. Em vez disso, a remoção de uma coleção global redefine as propriedades nesta coleção para os seus valores padrão. Isso significa que todos os filtros adicionados a essa coleção serão removidos.

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

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDiagnosticConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo das definições de configuração de diagnóstico a serem removidas. Para remover definições configuradas no escopo do site, utilize uma sintaxe similar a esta: -Identity "site:Redmond".

Remove-CsDiagnosticConfiguration também pode ser executado nas definições de configuração globais; neste caso, use essa sintaxe: –Identity global. No entanto, as configurações globais não vão ser removidas de fato. Em vez disso, as propriedades encontradas nas configurações globais serão redefinidas para seus valores padrão.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings. Remove-CsDiagnosticConfiguration aceita instâncias canalizadas do objeto de definições de filtro de diagnóstico.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsDiagnosticConfiguration exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemplo

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

Remove-CsDiagnosticConfiguration -Identity site:Redmond

O comando anterior exclui as definições de configuração de diagnóstico que tiverem a Identidade site:Redmond.

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

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

O comando mostrado no Exemplo 2 exclui todas as definições de configuração de diagnóstico configuradas no escopo de site. Para isso, o comando chama inicialmente Get-CsDiagnosticConfiguration, juntamente com o parâmetro Filter. O valor de filtro "site:*" limita os dados retornados a configurações cuja Identity comece com os caracteres "site:". A coleção filtrada será então passada a Remove-CsDiagnosticConfiguration, que removerá cada item nesta coleção.

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

Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration

No Exemplo 3, o comando exclui todas as definições de configuração de diagnóstico em uso na organização. Para executar esta tarefa, Get-CsDiagnosticConfiguration é chamado primeiramente, sem nenhum parâmetro, a fim de retornar uma coleção de todas as definições de configuração de diagnóstico em uso na organização. Esses itens serão então canalizados para Remove-CsDiagnosticConfiguration, que removerá cada item na coleção.