New-CsDiagnosticConfiguration

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

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.

Consulte Também

Outros Recursos

Get-CsDiagnosticConfiguration
New-CsDiagnosticsFilter
Remove-CsDiagnosticConfiguration
Set-CsDiagnosticConfiguration