Condividi tramite

  • Articolo

New-CsDiagnosticConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare nuove impostazioni di configurazione diagnostica. 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

New-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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; ad esempio, è possibile registrare solo il traffico da e per domini specificati. 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.

Si noti che non è possibile creare le impostazioni di configurazione diagnostica in ambito globale, poiché l'ambito globale ospita già queste impostazioni. Allo stesso modo, non è possibile creare nuove raccolte di impostazioni in ambito di sito se quel sito già contiene impostazioni di configurazione diagnostica. Ad esempio, il comando avrà esito negativo se si tenta di creare una nuova raccolta per il sito Redmond e quel sito ospita già una raccolta di impostazioni di configurazione diagnostica.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-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 "New-CsDiagnosticConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco delle impostazioni di configurazione diagnostica da creare. Poiché le nuove impostazioni possono essere create solo in ambito di sito si dovrà utilizzare una sintassi simile alla seguente: -Identity "site:Redmond".

Filter

Facoltativo

Modificatore dell'elenco PS

Raccolta di domini e URI il cui traffico sarà registrato, quando viene abilitato il filtro di diagnostica. La proprietà Filter consta di tre elementi separati:

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 simile 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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno. New-CsDiagnosticConfiguration non accetta input tramite pipeline.

Tipi restituiti

New-CsDiagnosticConfiguration consente di creare nuove di Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Esempio

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

New-CsDiagnosticConfiguration -Identity site:Redmond

Il comando precedente crea una nuova raccolta di impostazioni di configurazione diagnostica per il sito Redmond.

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

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

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

I comandi illustrati nell'esempio 2 consentono di creare un nuovo filtro di diagnostica e assegnare tale filtro a una nuova raccolta di impostazioni di diagnostica. A tale scopo, nel primo comando viene chiamato New-CsDiagnosticsFilter per creare un filtro di diagnostica residente solo in memoria. Tramite questo comando vengono aggiunti al filtro il nome di dominio completo fabrikam.com e l'URI sip:user@fabrikam.com. Questo comando consente inoltre di impostare la proprietà Enabled su True ($True) per attivare il filtro. Il filtro virtuale risultante viene quindi archiviato nella variabile $x.

Nel comando 2, New-CsDiagnosticConfiguration viene usato per creare una nuova raccolta di impostazioni per il sito Redmond. Queste nuove impostazioni utilizzeranno il filtro di diagnostica memorizzato nella variabile $x.

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

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

I comandi mostrati nell'Esempio 3 dimostrano come creare una raccolta di impostazioni di configurazione diagnostica che inizialmente esiste solo in memoria. Per ottenere questo risultato, il primo comando utilizza il cmdlet New-CsDiagnosticConfiguration insieme a due parametri: Identity (che specifica l'identità per le impostazioni) e InMemory (che indica che le nuove impostazioni devono essere create solo in memoria). L'oggetto risultante viene archiviato nella variabile $x.

Dopo che le impostazioni virtuali sono state create, il secondo comando viene utilizzato per configurare la proprietà LoggingShare per il percorso UNC \\atl-fs-001\logs. Il comando finale viene poi utilizzato per trasformare le virtuali impostazioni di configurazione diagnostica in una raccolta di impostazioni reale applicata al sito Redmond. Si noti che il comando finale è obbligatorio. Se non si utilizza il cmdlet Set-CsDiagnosticConfiguration, al sito Redmond non verranno applicate nuove impostazioni e le impostazioni virtuali scompariranno non appena si chiude la sessione di Windows PowerShell o si elimina la variabile $x.