Compartilhar via

  • Artigo

Get-CsDiagnosticConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de diagnósticos em uso na organização. As definições de configuração de diagnósticos são utilizadas para determinar se o tráfego de ou para um determinado domínio ou Identificador de recurso uniforme (URI) está registrado nos arquivos de registro do Microsoft Lync Server 2010.

Sintaxe

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

Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <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 nesses arquivos de registro. 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 registro 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 registro. O Lync Server permite criar definições de configuração de diagnósticos no escopo de site. Por sua vez, isso permite aplicar definições ao site de Redmond diferentes das aplicadas a outros sites.

O cmdlet Get-CsDiagnosticConfiguration permite retornar informações sobre as definições de configuração de diagnósticos em uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsDiagnosticConfiguration 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-CsDiagnosticConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração de diagnósticos a serem retornadas. Para retornar definições configuradas no escopo de site, utilize uma sintaxe similar a esta: -Identity "site:Redmond". Para retornar as definições globais, use essa sintaxe: -Identity global.

Se esse parâmetro não for especificado, serão retornadas todas as definições de configuração de diagnósticos em uso.

Filter

Opcional

Cadeia de caracteres

Permite que você use caracteres curinga ao especificar a coleção de definições (ou coleções) a ser retornada. Por exemplo, esta sintaxe retorna todas as definições configuradas no escopo de site: -Filter "site:*"

Observe que não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de diagnósticos na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsDiagnosticConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsDiagnosticConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemplo

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

Get-CsDiagnosticConfiguration

No Exemplo 1, retornam-se as informações correspondentes a todas as definições de configuração de diagnósticos em uso na organização. Isto é feito chamando-se Get-CsDiagnosticConfiguration sem qualquer parâmetro.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond

O comando anterior retorna informações sobre as definições de configuração de diagnósticos aplicadas ao site de Redmond (-Identity site:Redmond).

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

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

O comando apresentado no Exemplo 3 exibe as informações sobre cada filtro contido nas definições de configuração de diagnósticos do site de Redmond. Para fazer isso, o comando utiliza primeiramente Get-CsDiagnosticConfiguration, para retornar as definições do site de Redmond. Estas informações serão canalizadas para o cmdlet Select-Object, que utilizará o parâmetro ExpandProperty para "expandir" o valor da propriedade Filter. A expansão da propriedade Filter permite acessar as propriedades e os valores de propriedade de cada filtro mantido nas definições de configuração de diagnósticos.

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

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

O comando apresentado no Exemplo 4 retorna um subconjunto dos filtros encontrados nas definições globais de configuração de diagnósticos. Mais especificamente, ele retorna filtros nos quais a propriedade Uri inclui o endereço SIP sip:diagnostics@litwareinc.com. Para fazer isso, o comando utiliza inicialmente Get-CsDiagnosticConfiguration, para retornar todas as informações de filtro correspondentes à instância global das definições de configuração de diagnósticos. Estas informações serão canalizadas para o cmdlet Select-Object, que expandirá a propriedade Filter. Cada objeto de filtro será canalizado para Select-Object, que extrairá apenas os filtros nos quais a propriedade Uri incluir o endereço SIP sip:diagnostics@litwareinc.com.

-------------------------- Exemplo 5 ------------------------

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

O Exemplo 5 é uma variação do comando exibido no Exemplo 4. No entanto, no Exemplo 5, os filtros serão retornados apenas se a propriedade Uri não incluir o endereço SIP sip:diagnostics@litwareinc.com. Para realizar essa tarefa, o comando chama Get-CsDiagnosticConfiguration, para retornar todas as informações de configuração de diagnóstico da instância global das definições de configuração. Estas informações serão canalizadas para o cmdlet Select-Object, que expandirá a propriedade Filter. Esses objetos de filtro serão canalizados para Select-Object, que selecionará apenas os filtros nos quais a propriedade Uri não incluir o endereço SIP sip:diagnostics@litwareinc.com.