Condividi tramite

  • Articolo

Get-CsDiagnosticHeaderConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso nell'organizzazione. Le impostazioni di configurazione delle intestazioni di diagnostica determinano se i messaggi SIP sono corredati da informazioni di intestazione. Queste informazioni possono essere utili per la risoluzione dei problemi e la segnalazione degli errori.

Sintassi

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

Get-CsDiagnosticHeaderConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Quando si inviano messaggi SIP (Session Initiation Protocol), si ha la possibilità di allegare un'intestazione di diagnostica ms- a ciascun messaggio. Nel messaggio (non visibile per gli utenti finali) sono contenute informazioni che potrebbero essere utili nella risoluzione dei problemi di connessione o nella segnalazione di errori. L'intestazione di diagnostica potrebbe ad esempio includere codici di errore che consentono all'applicazione client (come Microsoft Lync 2010) di eseguire azioni predeterminate nel caso in cui si verifichi una situazione specifica.

Pochi sono i motivi per non includere le intestazioni di diagnostica per i messaggi SIP inviati entro la rete interna: hanno infatti un impatto minimo sulle dimensioni del messaggio e possono essere uno strumento davvero utile per gli amministratori che devono risolvere i problemi di connessione. È tuttavia possibile che nelle intestazioni di diagnostica siano contenute anche informazioni, quali i nomi di dominio completo (FQDN) dei server SIP, che non si desidera rendere disponibili per le persone al di fuori della rete interna. Per questo motivo, le impostazioni di configurazione delle intestazioni di diagnostica consentono di decidere se inviare tali intestazioni agli utenti di reti esterne (ad esempio utenti in un dominio federato) e/o a utenti esterni. Per utenti esterni si intendono gli utenti che non effettuano la connessione dalla rete interna e che non sono stati ancora autenticati.

Per impostazione predefinita, le intestazioni non sono incluse in messaggi inviati a rete esterne o a utenti non autenticati. Tuttavia, è possibile modificare le impostazioni delle intestazioni di diagnostica globali per includere le intestazioni a reti esterne e/o utenti non autenticati. In alternativa, è possibile creare impostazioni personalizzate nell'ambito del sito o nell'ambito del servizio (per il Edge Server o il servizio di registrazione). In questo modo è possibile scegliere di includere intestazioni di diagnostica nei messaggi inviati da un sito oppure tramite un Edge Server, non consentendo invece le intestazioni nei messaggi inviati da altri siti o tramite altri server perimetrali.

Il cmdlet Get-CsDiagnosticHeaderConfiguration consente di recuperare le informazioni sulle impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsDiagnosticHeaderConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsDiagnosticHeaderConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per le impostazioni di configurazione delle intestazioni di diagnostica da restituire. Per restituire le impostazioni configurate nell'ambito del sito, utilizzare la sintassi: -Identity "site:Redmond". Per le impostazioni configurate con ambito servizio, utilizzare la sintassi: -Identity "service:EdgeServer:atl-edge-001.litwareinc.com". Per restituire le impostazioni globali, utilizzare la seguente sintassi: -Identity global.

Se il parametro non viene specificato, verranno restituite tutte le impostazioni di configurazione delle intestazioni di 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:*". La seguente sintassi restituisce tutte le impostazioni configurate nell'ambito del servizio: -Filter "service:*".

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

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati di configurazione dell'intestazione di diagnostica dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsDiagnosticHeaderConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsDiagnosticHeaderConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Esempio

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

Get-CsDiagnosticHeaderConfiguration

Il comando precedente restituisce le informazioni su tutte le impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso nell'organizzazione. Questa operazione viene eseguita, chiamando Get-CsDiagnosticHeaderConfiguration senza alcun parametro.

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

Get-CsDiagnosticHeaderConfiguration -Identity site:Redmond

Nell'esempio 2 viene restituita un'unica raccolta di impostazioni di configurazione delle intestazioni di diagnostica: la raccolta con Identity site:Redmond.

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

Get-CsDiagnosticHeaderConfiguration -Filter "service:*"

Il comando mostrato nell'esempio 3 restituisce tutte impostazioni delle intestazioni di diagnostica configurate nell'ambito del servizio. Questa operazione viene eseguita chiamando Get-CsDiagnosticHeaderConfiguration con il parametro Filter; il valore di filtro "service:*" assicura che solo le impostazioni restituite abbiano un'identità che inizia con i caratteri "service:".

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True}

Nell'esempio 4 vengono restituite tutte le impostazioni di configurazione delle intestazioni di diagnostica che consentono l'invio delle intestazioni alle reti esterne. A tale scopo, il comando chiama per prima cosa Get-CsDiagnosticHeaderConfiguration senza alcun parametro; questa operazione restituisce una raccolta di tutte le impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso nell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente le impostazioni con proprietà SendToExternalNetworks uguale a True.

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True -or $_.SendToOutsideUnauthenticatedUsers -eq $True}

Il comando mostrato nell'esempio 5 restituisce informazioni sulle impostazioni di configurazione delle intestazioni di diagnostica che soddisfano almeno uno dei criteri seguenti: 1) la proprietà SendToExternalNetworks è uguale a True e/o 2) la proprietà SendToOutsideUnauthenticatedUsers è uguale a True. A tale scopo, il comando chiama per prima cosa Get-CsDiagnosticHeaderConfiguration per restituire una raccolta di tutte le impostazioni delle intestazioni di diagnostica attualmente in uso. La raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona le impostazioni con proprietà SendToExternalNetworks e/o SendToOutsideUnauthenticatedUsers uguali a True.

L'operatore -or indica che per essere restituite le impostazioni devono soddisfare solo uno dei criteri specificati. Se si desidera che le impostazioni soddisfino entrambi i criteri specificati, utilizzare piuttosto l'operatore -and:

Where-Object {$_.SendToExternalNetworks -eq $True -and $_.SendToOutsideUnauthenticatedUsers -eq $True}