New-CsDiagnosticsFilter
Tópico modificado em: 2012-03-23
Cria um novo filtro de diagnósticos, a ser usado com as definições de configuração de diagnósticos. 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
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
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.
Por outro lado, isso também pode resultar em casos de informações demasiadas. 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ósticos permitem especificar os domínios ou URIs que serão registrados nos arquivos de registro. Por exemplo: é possível registrar apenas o tráfego de ou para domínios especificados. Além das definições globais, o Lync Server permite a criação de definições de diagnósticos no escopo de site ou de serviço (para o Servidor de Borda ou para o serviço Registrador). Por sua vez, isso permite aplicar definições ao site de Redmond diferentes das aplicadas a outros sites.
New-CsDiagnosticsFilter permite adicionar um filtro a uma coleção de definições de diagnósticos. Essa coleção contém os domínios e URIs cujos tráfegos serão registrados nos arquivos de log. Quando se adiciona um filtro, serão registradas apenas as informações relacionadas aos domínios e URIs no filtro. Para fins de registro, será ignorado o tráfego de outros domínios e URIs.
Observe que o cmdlet New-CsDiagnosticsFilter cria instâncias de um filtro de diagnóstico apenas na memória. Depois de se criar um desses filtros virtuais, será necessário utilizar New-CsDiagnosticConfiguration ou Set-CsDiagnosticConfiguration, para adicionar o filtro a uma coleção.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsDiagnosticsFilter localmente: 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 "New-CsDiagnosticsFilter"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Enabled |
Obrigatório |
Booleano |
Indica se o filtro será empregado ou não. O valor padrão é True ($True). |
ExcludeConferenceMessages |
Opcional |
Booleano |
Se for definido como True, as informações sobre mensagens de conferências (ou seja, qualquer mensagem com um URI de conferência no seu cabeçalho De ou Para) não serão registradas nos arquivos de registro. O valor padrão é False. |
ExcludePresenceNotifications |
Opcional |
Booleano |
Se for definido como True, as notificações de presença (ou seja, qualquer mensagem que use o método NOTIFY ou BENOTIFY) não serão registradas nos arquivos de registro. O valor padrão é False. |
ExcludeRegisterMessages |
Opcional |
Booleano |
Se for definido como True, as informações sobre os registros de clientes (ou seja, qualquer mensagem que use o método REGISTER) não serão registradas nos arquivos de registro. O valor padrão é False. |
ExcludeSubscribeMessages |
Opcional |
Booliano |
Se for definido como True, as informações sobre as assinaturas de clientes (ou seja, qualquer mensagem que use o método SUBSCRIBE) não serão registradas nos arquivos de registro. O valor padrão é False. |
Fqdn |
Opcional |
Modificador de Lista PS |
Coleção de domínios a serem incluídos no filtro. Mais tecnicamente, esses domínios representam a parte que diz respeito à hospedagem de um endereço SIP. Quanto à propriedade FQDN, é possível usar um nome de domínio totalmente qualificado (FQDN) como este: fabrikam.com. Como alternativa, é possível usar caracteres curingas para representar diversos domínios: *.fabrikam.com. Um único filtro pode conter mais de um domínio. |
Uri |
Opcional |
Modificador de Lista PS |
Coleção de URIs a serem incluídos no filtro. O URI é a parte correspondente a user@host de um endereço SIP. Um URI pode consistir em qualquer um dos seguintes padrões: user@fabrikam.com user@* *@fabrikam.com É possível incluir diversos URIs em um único filtro. |
Tipos de Entrada
Nenhuma. New-CsDiagnosticsFilter não aceita a entrada canalizada.
Tipos de Retorno
New-CsDiagnosticsFilter cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Os comandos exibidos no Exemplo 1 utilizam New-CsDiagnosticsFilter para criar um novo filtro de diagnóstico e, em seguida, atribuem esse filtro às definições globais de configuração de diagnósticos. Para realizar essa tarefa, o primeiro comando chama New-CsDiagnosticsFilter, para criar um filtro de diagnóstico apenas na memória. Esse filtro adiciona o FQDN fabrikam.com e o URI user@fabrikam.com ao filtro. O comando também define a propriedade Enabled como True ($True) para ativar o filtro. O filtro virtual resultante será armazenado na variável $x.
No segundo comando, utiliza-se Set-CsDiagnosticConfiguration para atribuir o novo filtro às definições globais de configuração de diagnósticos. Nesse caso, qualquer valor existente na propriedade Filter será substituído pelo filtro recém-criado, armazenado em $x.
-------------------------- Exemplo 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Os comandos exibidos no Exemplo 2 são uma variação dos comandos exibidos no Exemplo 1. No entanto, no Exemplo 2, são adicionados dois FQDNs (fabrikam.com e contoso.com) à propriedade FQDN do filtro. Para isso, os dois nomes (separados por uma vírgula) são utilizados como valores do parâmetro Fqdn.