Compartilhar via


New-CsDiagnosticConfiguration

 

Tópico modificado em: 2012-03-23

Cria novas configurações de diagnóstico. 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

New-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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; por exemplo, é possível registrar apenas o tráfego de ou para os domínios especificados. 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, por exemplo, use configurações diferentes de seus outros sites.

Observe que não é possível criar configurações de diagnóstico em escopo global, pois esse escopo já hospeda essas configurações. Da mesma forma, não é possível criar uma nova coleção de configurações em escopo de site se o site especificado já contiver configurações de diagnóstico. Por exemplo, o comando irá falhar se você tentar criar uma nova coleção para o site Redmond, e esse site já hospedar configurações de diagnóstico.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo das definições de configuração do diagnóstico a serem criadas. Como as novas configurações só podem ser criadas no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond".

Filter

Opcional

PS List Modifier

A coleção de domínios e URIs cujo tráfego será registrado em log se a filtragem de diagnóstico for habilitada. A propriedade Filter consiste em três itens separados:

Fqdn – Coleção de domínios a serem incluídos no filtro. (mais tecnicamente, esta é 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 usuário@host de um endereço SIP). Um Uri pode consistir de qualquer 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 ser geradas pela execução do comando.

InMemory

Opcional

Parâmetros de Opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsDiagnosticConfiguration não aceita entrada em pipeline.

Tipos de Retorno

New-CsDiagnosticConfiguration cria novas instâncias do Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Exemplo

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

New-CsDiagnosticConfiguration -Identity site:Redmond

O comando anterior cria uma nova coleção de configurações de diagnóstico para o site Redmond.

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri "sip:user@fabrikam.com" -Enabled $False 

New-CsDiagnosticConfiguration -Identity site:Redmond -Filter $x

Os comandos mostrados no Exemplo 2 criam um novo filtro de diagnóstico e atribuem esse filtro a uma nova coleção de configurações de diagnóstico. Para realizar essa tarefa, o primeiro comando chama New-CsDiagnosticsFilter para criar um filtro de diagnóstico somente na memória. Esse comando adiciona o FQDN fabrikam.com e o URI sip:user@fabrikam.com ao filtro. O comando também define a propriedade Enabled como True ($True) para ativar o filtro. Em seguida, o filtro virtual resultante é armazenado na variável $x.

No comando 2, New-CsDiagnosticConfiguration é usado para criar uma nova coleção de configurações de diagnóstico para o site Redmond. Essas novas configurações usarão o filtro de diagnóstico armazenado na variável $x.

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

$x = New-CsDiagnosticConfiguration -Identity site:Redmond -InMemory
$x.LoggingShare = "\\atl-fs-001\logs"
Set-CsDiagnosticConfiguration -Instance $x

Os comandos mostrados no Exemplo 3 demonstram como criar configurações de diagnóstico que inicialmente existam apenas na memória. Para fazer isso, o primeiro comando chama New-CsDiagnosticConfiguration com dois parâmetros: Identity (que especifica a identidade das configurações) e InMemory, que indica que as novas configurações devem ser criadas apenas na memória. O objeto resultante é armazenado na variável $x.

Após a criação das configurações virtuais, o segundo comando é usado para definir a propriedade LoggingShare para o caminho UNC \\atl-fs-001\logs. O comando final é usado para transformar as configurações virtuais de diagnóstico em uma coleção de configurações reais aplicadas ao site Redmond. Observe que esse último comando é obrigatório. Se Set-CsDiagnosticConfiguration não for chamado, nenhuma configuração será aplicada ao site Redmond, e as configurações virtuais desaparecerão assim que sua sessão do Windows PowerShell for encerrada ou a variável $x for excluída.