Condividi tramite

  • Articolo

Set-CsDiagnosticConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare impostazioni di configurazione diagnostica esistenti. Le impostazioni di configurazione di diagnostica vengono utilizzate per stabilire se il traffico da o verso un dato dominio o URI (Uniform Resource Identifier) viene registrato nei file di registro di Microsoft Lync Server 2010.

Sintassi

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>]]

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. Ciò garantisce che nei file di registro vengano registrate più informazioni possibile.

Tuttavia, ciò può occasionalmente causare la registrazione di troppe informazioni. Ad esempio, in caso di problemi di connettività su un particolare dominio, è opportuno limitare la registrazione del traffico tra la rete e quel dominio, in quanto ciò agevola l'identificazione delle registrazioni importanti e, di conseguenza, facilita la diagnosi e la risoluzione del problema.

Le impostazioni di configurazione diagnostica rendono possibile specificare i domini o URI da registrare nei file di registro. Lync Server consente di creare impostazioni di configurazione diagnostica in ambito di sito. Ciò consente altresì di applicare impostazioni diverse, ad esempio al sito Redmond, da quelle applicate a tutti gli altri siti.

Il cmdlet Set-CsDiagnosticConfiguration può essere utilizzato anche per aggiungere o rimuovere i filtri da una determinata raccolta. I filtri vengono utilizzati per indicare i domini di cui si deve registrare il traffico.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsDiagnosticConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsDiagnosticConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco per le impostazioni di configurazione diagnostica da modificare. Per modificare le impostazioni configurate nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Per modificare le impostazioni globali, utilizzare la seguente sintassi: -Identity global.

Se questo parametro non è specificato, il cmdlet Set-CsDiagnosticConfiguration modifica automaticamente le impostazioni globali.

Instance

Facoltativo

Oggetto DiagnosticFilterSettings

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

Filter

Facoltativo

Modificatore dell'elenco PS

Raccolta di domini e URI di cui si deve registrare il traffico. La proprietà Filter consta di tre elementi separati e deve essere creata utilizzando il cmdlet New-CsDiagnosticsFilter:

Fqdn – Raccolta dei domini da includere nel filtro. Da un punto di vista più tecnico, la parte host di un indirizzo SIP. Ad esempio, un nome di dominio completo (FQDN) potrebbe essere analogo al seguente: fabrikam.com. In alternativa, è possibile utilizzare i caratteri jolly per rappresentare più domini: *.fabrikam.com. È possibile includere più di un dominio in un singolo filtro.

Uri – Raccolta degli URI da includere nel filtro. La porzione URI è la sezione user@host di un indirizzo SIP. Un URI può essere costituito da uno qualunque dei seguenti modelli: user@fabrikam.com; user@*; *@fabrikam.com. È possibile includere più di un URI in un singolo filtro.

Enabled – Indica se il filtro deve essere attivato o meno.

LoggingShare

Facoltativo

Stringa

Cartella condivisa dove possono essere caricate le registrazioni diagnostiche.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings. Set-CsDiagnosticConfiguration accetta istanze dell'oggetto impostazioni di configurazione diagnostica tramite pipeline.

Tipi restituiti

Set-CsDiagnosticConfiguration non restituisce alcun oggetto o valore. In realtà, il cmdlet consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Esempio

-------------------------- Esempio 1 ------------------------

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

I comandi riportati nell'esempio 1 prevedono l'utilizzo di New-CsDiagnosticsFilter per creare un nuovo filtro di diagnostica e quindi assegnare tale filtro alle impostazioni di configurazione diagnostica globali. Per eseguire questa operazione, il primo comando chiama New-CsDiagnosticsFilter per creare un filtro di diagnostica residente solo in memoria, che utilizza l'FQDN fabrikam.com e l'URI sip:user@fabrikam.com. Il filtro "virtuale" risultante viene quindi archiviato nella variabile $x.

Nel secondo comando viene utilizzato il cmdlet Set-CsDiagnosticConfiguration per assegnare il nuovo filtro alla raccolta globale di impostazioni di configurazione diagnostica. In questo caso, i valori esistenti della proprietà Filter verranno sostituiti dal nuovo filtro appena creato.

-------------------------- Esempio 2 ------------------------

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

Nell'esempio 2 viene illustrato come aggiungere un nuovo FQDN alla proprietà Filter delle impostazioni di configurazione diagnostica globali. A tale scopo, il primo comando nell'esempio utilizza Get-CsDiagnosticConfiguration per recuperare il valore della proprietà Filter delle impostazioni globali. Questa operazione viene eseguita racchiudendo tra parentesi la chiamata di Get-CsDiagnosticConfiguration. In questo modo, in Windows PowerShell tale comando viene eseguito prima di qualunque altra cosa. Dopo che le impostazioni globali sono state restituite, il valore della proprietà Filter viene estratto e archiviato in una variabile denominata $x.

Nel secondo comando viene utilizzato il metodo Add per aggiungere un nuovo FQDN (fabrikam.com) al filtro. Successivamente, il comando finale nell'esempio utilizza Set-CsDiagnosticConfiguration per scrivere la raccolta di diagnostica modificata. Il risultato finale è che fabrikam.com verrà aggiunto a ogni FQDN già incluso nella proprietà Filter.

-------------------------- Esempio 3 ------------------------

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

I comandi riportati nell'esempio 3 consentono di rimuovere un FQDN (fabrikam.com) dalla proprietà Filter delle impostazioni di configurazione diagnostica globali. Il primo comando nell'esempio utilizza il cmdlet Get-CsDiagnosticConfiguration per recuperare il valore corrente della proprietà Filter per le impostazioni globali. Questo valore viene archiviato in una variabile denominata $x. Una volta recuperato tale valore, viene utilizzato il metodo Remove per rimuovere l'FQDN fabrikam.com. Una volta rimosso l'FQDN, viene utilizzato il cmdlet Set-CsDiagnosticConfiguration per scrivere il filtro modificato, archiviato nella variabile $x, nelle impostazioni globali.

-------------------------- Esempio 4 ------------------------

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

Nell'Esempio 4, vengono rimossi tutti gli elementi della proprietà Filter delle impostazioni di configurazione diagnostica globali. Per ottenere questo risultato, si imposta la proprietà Filter su un valore null.