Compartilhar via

  • Artigo

Set-CsDiagnosticConfiguration

 

Tópico modificado em: 2012-03-26

Modifica configurações de diagnóstico existentes. Configurações de diagnóstico são usadas para determinar se tráfego de ou para um determinado domínio ou URI é registrado nos arquivos de log do Microsoft Lync Server 2010.

Sintaxe

Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Se você habilitar o registro em log para o Lync Server 2010, então, por padrão, tráfego de ou para qualquer domínio ou URI será incluído nestes arquivos de log. Isto garante que o máximo de informação possível seja gravado nos arquivos de log.

No entanto, isto pode ocasionalmente resultar em informação demais. Por exemplo, se houver problemas de conectividade com um domínio específico, limite o registro em log ao tráfego entre sua rede e esse domínio; assim fica mais fácil identificar os registros relevantes e diagnosticar e corrigir o problema.

Com as configurações de diagnóstico, é possível especificar os domínios ou URIs que serão registrados nos arquivos de log. O Lync Server permite a criação de configurações de diagnóstico em escopo de site. Em consequência, isto permite que o site Redmond use configurações diferentes de seus outros sites.

O cmdlet Set-CsDiagnosticConfiguration pode ser usado para adicionar ou remover filtros de uma determinada coleção. Os filtros são usados para indicar os domínios cujos tráfegos devem ser registrados em log.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo das definições de configuração do diagnóstico a serem modificadas. Para modificar definições configuradas no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para modificar as configurações globais, use esta sintaxe: -Identity global.

Se o parâmetro não for especificado, Set-CsDiagnosticConfiguration modificará automaticamente as configurações globais.

Instance

Opcional

Objeto DiagnosticFilterSettings

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Filter

Opcional

PS List Modifier

A coleção de domínios e URIs cujo tráfego será registrado em log. A propriedade Filter consiste em três itens separados, e deve ser criada com o cmdlet New-CsDiagnosticsFilter.

Fqdn – Coleção de domínios a serem incluídos no filtro. (mais tecnicamente, a parte de host de um endereço SIP). Por exemplo, um FQDN (nome de domínio totalmente qualificado) pode ser semelhante a este: fabrikam.com. Também é possível usar curingas para representar vários domínios: *.fabrikam.com. Também é possível incluir mais de um domínio em um único filtro.

Uri – Coleção de Uris a serem incluídos no filtro (o Uri representa a parte user@host de um endereço SIP). Um URI pode consistir em qualquer um dos seguintes padrões: user@fabrikam.com; user@*; *@fabrikam.com. Você pode incluir vários URIs em um único filtro.

Enabled – Indica se o filtro deve ou não ser ativado.

LoggingShare

Opcional

Cadeia de caracteres

Pasta compartilhada para a qual os logs de diagnóstico podem ser carregados.

Force

Opcional

Parâmetros de Opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Opcional

Parâmetros de Opção

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

Confirm

Opcional

Parâmetros de Opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings. Set-CsDiagnosticConfiguration aceita instâncias em pipeline do objeto de configurações de diagnóstico.

Tipos de Retorno

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

Exemplo

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com 
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Os comandos mostrados no Exemplo 1 usam o New-CsDiagnosticsFilter para criar um novo filtro de diagnóstico e atribuem esse filtro às configurações de diagnóstico global. Para realizar essa tarefa, o primeiro comando chama New-CsDiagnosticsFilter para criar um filtro de diagnóstico somente na memória; esse filtro usa o FQDN fabrikam.com e o URI sip:user@fabrikam.com. O filtro "virtual" é armazenado na variável $x.

No comando 2, Set-CsDiagnosticConfiguration atribui um novo filtro às configurações globais de diagnóstico. Nesse caso, todos os valores existentes na propriedade Filter serão substituídos pelo filtro recém-criado.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

O Exemplo 2 mostra como é possível adicionar um novo FQDN à propriedade Filter das configurações globais de diagnóstico. Para isso, o primeiro comando no exemplo usa o Get-CsDiagnosticConfiguration para recuperar o valor da propriedade Filter para as configurações globais. Isso é feito colocando a chamada no comando Get-CsDiagnosticConfiguration entre parênteses, fazendo com que o Windows PowerShell execute esse comando antes de fazer qualquer coisa. Depois que as configurações globais forem retornadas, o valor da propriedade Filter será extraído e armazenado em uma variável chamada $x.

No segundo comando, o método Add é usado para adicionar um novo FQDN (fabrikam.com) ao filtro. Depois disso, o comando final no exemplo usará Set-CsDiagnosticConfiguration para gravar o conjunto de diagnósticos modificado. O resultado líquido é que fabrikam.com será adicionado a qualquer FQDN já incluído na propriedade Filter.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Os comandos mostrados no Exemplo 3 removem um FQDN (fabrikam.com) das configurações globais de diagnóstico da propriedade Filter. O primeiro comando no exemplo usa Get-CsDiagnosticConfiguration para recuperar o valor atual da propriedade Filter para as configurações globais; esse valor é armazenado em uma variável chamada $x. Depois que o valor tiver sido recuperado, o método Remove será usado para remover o FQDN fabrikam.com. Depois que o FQDN tiver sido removido, Set-CsDiagnosticConfiguration será usado para gravar o filtro modificado (armazenado na variável $x) para as configurações globais.

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

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

No Exemplo 4, todos os itens são removidos da propriedade Filter das configurações globais de diagnóstico. Isso é feito definindo-se a propriedade Filter como um valor nulo.