Condividi tramite

  • Articolo

Get-CsDiagnosticConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle impostazioni di configurazione diagnostica attualmente in uso nell'organizzazione. Le impostazioni di configurazione diagnostica vengono utilizzate per determinare se il traffico da un determinato dominio o URI (Uniform Resource Identifier) e verso gli stessi viene registrato nei file di registro di Microsoft Lync Server 2010.

Sintassi

Get-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <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. In questo modo, nei file di registro viene inclusa la maggior quantità di informazioni possibile.

Tuttavia, è possibile che una tale quantità di informazioni risulti addirittura eccessiva. Ad esempio, se si verificano dei problemi di connettività in un determinato dominio, è possibile limitare la registrazione al traffico fra la rete e tale dominio. In questo modo risulta più semplice identificare i relativi record e, a sua volta, potrebbero essere agevolate la diagnosi e la risoluzione del problema.

Le impostazioni di configurazione diagnostica consentono di specificare i domini o URI che verranno inclusi nei file di registro. Lync Server consente di creare impostazioni di configurazione diagnostica nell'ambito del sito. Ciò consente a sua volta di applicare diverse impostazioni al sito Redmond indipendentemente dagli altri siti.

Il cmdlet Get-CsDiagnosticConfiguration consente di restituire le informazioni sulle impostazioni di configurazione diagnostica attualmente in uso nell'organizzazione.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi seguenti sono autorizzati a eseguire il cmdlet Get-CsDiagnosticConfiguration in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli del controllo di accesso basato sui ruoli (RBAC) ai quali è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati creati dall'utente), eseguire il comando seguente dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco delle impostazioni di configurazione diagnostica da ottenere. Per restituire le impostazioni configurate nell'ambito del sito, utilizzare la sintassi: -Identity "site:Redmond". Per restituire le impostazioni globali, utilizzare la seguente sintassi: -Identity global.

Se il parametro non viene specificato, verranno restituite tutte le impostazioni di configurazione diagnostica attualmente in uso nell'organizzazione.

Filter

Facoltativo

Stringa

Consente l'utilizzo di caratteri jolly per specificare la raccolta, o le raccolte, di impostazioni che si desidera vengano restituite. Ad esempio, la sintassi che segue restituisce tutte le informazioni configurate nell'ambito del sito: -Filter "site:*".

Si noti che non è possibile utilizzare entrambi i parametri Filter e Identity nello stesso comando.

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione diagnostica dalla replica locale del archivio di gestione centrale anziché dallo stesso archivio di gestione centrale.

Tipi di input

Nessuno. Get-CsDiagnosticConfiguration non accetta input inviato tramite pipe.

Tipi restituiti

Get-CsDiagnosticConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Esempio

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

Get-CsDiagnosticConfiguration

Nell'esempio 1 vengono restituite tutte le impostazioni di configurazione diagnostica attualmente in uso nell'organizzazione. Questa operazione viene eseguita, chiamando Get-CsDiagnosticConfiguration senza alcun parametro.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond

Con il comando precedente vengono restituite informazioni per le impostazioni di configurazione diagnostica applicate al sito Redmond (-Identity site:Redmond).

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

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

Il comando mostrato nell'esempio 3 consente di visualizzare le informazioni sui singoli filtri contenuti all'interno delle impostazioni di configurazione diagnostica relative al sito Redmond. A tale scopo, il comando utilizza per prima cosa Get-CsDiagnosticConfiguration per restituire le impostazioni di filtro del sito Redmond. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object, che utilizza il parametro ExpandProperty per "espandere" il valore della proprietà Filter. L'espansione della proprietà Filter consente di accedere alle proprietà e ai valori proprietà dei singoli filtro gestiti nelle impostazioni di configurazione diagnostica.

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

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

Il comando mostrato nell'esempio 4 restituisce un sottoinsieme di filtri presenti nelle impostazioni di configurazione per il filtro di diagnostica globali; in particolare, restituisce i filtri in cui la proprietà Uri include l'indirizzo SIP sip:diagnostics@litwareinc.com. A tale scopo, il comando utilizza per prima cosa il cmdlet Get-CsDiagnosticConfiguration per restituire tutte le informazioni di filtro per l'istanza globale delle impostazioni di configurazione diagnostica. Le informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object, che espande la proprietà Filter. I singoli oggetti filtro vengono quindi inviati tramite pipe a Select-Object, che estrae solo quei filtri in cui la proprietà Uri contiene l'indirizzo SIP sip:diagnostics@litwareinc.com.

-------------------------- Esempio 5 ------------------------

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

Nell'esempio 5 è riportata una variazione del comando mostrato nell'esempio 4; tuttavia, i filtri vengono restituiti solo se le relative proprietà Uri non includono l'indirizzo SIP sip:diagnostics@litwareinc.com. A tale scopo, il comando chiama Get-CsDiagnosticConfiguration per restituire tutte le informazioni di configurazione per l'istanza globale delle impostazioni di configurazione. Le informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object, che espande la proprietà Filter. Tali oggetti filtro vengono quindi inviati tramite pipe a Select-Object, che seleziona solo quei filtri in cui la proprietà Uri non include l'indirizzo SIP sip:diagnostics@litwareinc.com.