New-CsDiagnosticsFilter
Ultima modifica dell'argomento: 2012-03-23
Crea un nuovo filtro di diagnostica da utilizzare con le impostazioni di configurazione della diagnostica. Tali impostazioni consentono di determinare se il traffico proveniente o diretto verso un particolare dominio o URI (Uniform Resource Identifier) viene registrato nei file di registro di Microsoft Lync Server 2010.
Sintassi
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
Descrizione dettagliata
Se la registrazione di Lync Server 2010 è abilitata, il traffico da un qualsiasi dominio o URI e verso gli stessi è incluso nei file di registro per impostazione predefinita. In questo modo, nei file di registro viene inclusa la maggior quantità di informazioni possibile.
D'altro canto, ciò può anche comportare una quantità eccessiva di informazioni. Se ad esempio si verificano problemi di connettività con un determinato dominio, è possibile limitare la registrazione al traffico tra la rete e il dominio in questione. In questo modo risulterà più semplice identificare i record pertinenti e potrebbero pertanto essere agevolate la diagnosi e la risoluzione del problema.
Le impostazioni di configurazione della diagnostica consentono di specificare i domini o gli URI che verranno registrati nei file di registro. Ad esempio, è possibile decidere di registrare solo il traffico diretto o proveniente da determinati domini. Oltre alle impostazioni globali, Lync Server consente di creare impostazioni di diagnostica nell'ambito del sito o del servizio per il Edge Server o il servizio di registrazione. In questo modo, è possibile applicare al sito Redmond impostazioni diverse da quelle degli altri siti.
Il cmdlet New-CsDiagnosticsFilter consente di aggiungere un filtro a una raccolta di impostazioni di diagnostica. Questa raccolta contiene i domini e gli URI il cui traffico sarà incluso nei file di registro. Quando si aggiunge un filtro, verranno registrate solo le informazioni relative ai domini e agli URI nel filtro. Ai fini della registrazione, il traffico proveniente da altri domini e URI verrà ignorato.
Il cmdlet New-CsDiagnosticsFilter consente di creare istanze di un filtro diagnostico solo nella memoria. Una volta creato uno di tali filtri virtuali, sarà necessario utilizzare New-CsDiagnosticConfiguration o Set-CsDiagnosticConfiguration per aggiungere il filtro a una raccolta.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsDiagnosticsFilter i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDiagnosticsFilter"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Enabled |
Obbligatorio |
Booleano |
Indica se il filtro deve essere utilizzato o meno. Il valore predefinito è True ($True). |
ExcludeConferenceMessages |
Facoltativo |
Booleano |
Se impostato su True, le informazioni relative ai messaggi di conferenza, ovvero ai messaggi con un URI conferenza nell'intestazione A o Da, non verranno registrate nei file di registro. Il valore predefinito è False. |
ExcludePresenceNotifications |
Facoltativo |
Booleano |
Se impostato su True, le informazioni relative alle notifiche di presenza, ovvero ai messaggi per cui viene utilizzato il metodo NOTIFY o BENOTIFY, non verranno registrate nei file di registro. Il valore predefinito è False. |
ExcludeRegisterMessages |
Facoltativo |
Booleano |
Se impostato su True, le informazioni relative alle registrazioni client, ovvero ai messaggi per cui viene utilizzato il metodo REGISTER, non verranno registrate nei file di registro. Il valore predefinito è False. |
ExcludeSubscribeMessages |
Facoltativo |
Booleano |
Se il parametro è impostato su True, le informazioni relative alle sottoscrizioni client, ovvero i messaggi per cui viene utilizzato il metodo SUBSCRIBE, non verranno registrate nei file di registro. Il valore predefinito è False. |
Fqdn |
Facoltativo |
Modificatore elenco PS |
Raccolta di domini da includere nel filtro (da un punto di vista più tecnico, tali domini rappresentano la parte host di un indirizzo SIP). Per la proprietà FQDN, è possibile utilizzare un nome di dominio completo (FQDN) come il seguente: fabrikam.com. In alternativa, è possibile utilizzare i caratteri jolly per rappresentare più domini: *.fabrikam.com. È possibile includere più domini in un singolo filtro. |
Uri |
Facoltativo |
Modificatore elenco PS |
Raccolta di URI da includere nel filtro (l'URI è la parte user@host di un indirizzo SIP). Un URI può essere costituito da uno dei seguenti formati: user@fabrikam.com user@* *@fabrikam.com È possibile includere più URI in un singolo filtro. |
Tipi di input
Nessuno. New-CsDiagnosticsFilter non accetta l'input da pipeline.
Tipi restituiti
New-CsDiagnosticsFilter consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter.
Esempio
-------------------------- Esempio 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Nei comandi mostrati nell'esempio 1 viene utilizzato New-CsDiagnosticsFilter per creare un nuovo filtro di diagnostica e assegnare tale filtro alle impostazioni globali di configurazione della diagnostica. Per eseguire tale attività, il primo comando chiama New-CsDiagnosticsFilter per creare un filtro diagnostico solo in memoria. Questo filtro aggiunge il nome di dominio completo (FQDN) fabrikam.com e l'URI user@fabrikam.com al filtro. Questo comando inoltre imposta la proprietà Enabled su True ($True) per attivare il filtro. Il filtro virtuale risultante viene quindi memorizzato nella variabile $x.
Nel secondo comando viene utilizzato Set-CsDiagnosticConfiguration per assegnare il nuovo filtro alle impostazioni globali di configurazione della diagnostica. In questo caso, i valori esistenti nella proprietà Filter verranno sostituiti dal nuovo filtro memorizzato in $x.
-------------------------- Esempio 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
I comandi mostrati nell'esempio 2 rappresentano una variante dei comandi mostrati nell'esempio 1. Nell'esempio 2, tuttavia, i due nomi di dominio completo (fabrikam.com e contoso.com) vengono aggiunti alla proprietà Fqdn del filtro. A tal fine, entrambi i nomi (delimitati da una virgola) vengono utilizzati come valori di parametro del parametro Fqdn.