Condividi tramite

  • Articolo

Set-CsDiagnosticHeaderConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica una raccolta esistente di impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso nell'organizzazione. Tali impostazioni determinano se i messaggi SIP vengono accompagnati da informazioni di intestazione che possono essere utili nella risoluzione dei problemi e nella segnalazione degli errori.

Sintassi

Set-CsDiagnosticHeaderConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-SendToExternalNetworks <$true | $false>] [-SendToOutsideUnauthenticatedUsers <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticHeaderConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SendToExternalNetworks <$true | $false>] [-SendToOutsideUnauthenticatedUsers <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Gli amministratori hanno la possibilità di allegare un'intestazione ms-diagnostic a ogni messaggio SIP inviato nell'organizzazione. 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. Ad esempio, nell'intestazione di diagnostica potrebbe essere contenuti 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. Le intestazioni di diagnostica tuttavia contengono anche informazioni, quali i nomi di dominio completi (FQDN) dei server SIP, che si potrebbe non voler 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 (quali utenti in un dominio federato) e/o a utenti esterni, ovvero utenti che si sono connessi dall'esterno della 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 globali delle intestazioni di diagnostica in modo da includere le intestazioni per 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 Set-CsDiagnosticHeaderConfiguration consente di modificare una raccolta esistente di impostazioni di configurazione delle intestazioni di diagnostica. È possibile utilizzare il cmdlet per abilitare o disabilitare la trasmissione delle intestazioni di diagnostica a reti esterne e/o a utenti esterni.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsDiagnosticHeaderConfiguration 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 "Set-CsDiagnosticHeaderConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per le impostazioni di configurazione delle intestazioni di 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 configurate nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Per modificare le impostazioni globali, utilizzare la sintassi seguente: -Identity global.

Se questo parametro non viene specificato, Set-CsDiagnosticHeaderConfiguration modificherà automaticamente le impostazioni globali.

Instance

Facoltativo

Oggetto DiagnosticHeaderSettings

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

SendToExternalNetworks

Facoltativo

Booleano

Se questo parametro è impostato su True, le intestazioni di diagnostica verranno allegate ai messaggi inviati agli utenti su reti esterne, ad esempio agli utenti in un dominio federato. Il valore predefinito è False.

SendToOutsideUnauthenticatedUsers

Facoltativo

Booleano

Se questo parametro è impostato su True, le intestazioni di diagnostica verranno allegate ai messaggi inviati agli utenti esterni, ovvero utenti che si sono connessi dall'esterno della rete interna, ad esempio tramite un server proxy, e che non sono stati ancora autenticati.

Il valore predefinito è False.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'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.DiagnosticHeaderSettings. Set-CsDiagnosticHeaderConfiguration accetta istanze da pipeline dell'oggetto impostazioni delle intestazioni di diagnostica.

Tipi restituiti

Set-CsDiagnosticHeaderConfiguration non restituisce alcun valore né oggetto. Il cmdlet consente invece di modificare le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Esempio

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

Set-CsDiagnosticHeaderConfiguration -Identity site:Redmond -SendToOutsideUnauthenticatedUsers $True

Il comando riportato sopra consente di modificare le impostazioni di configurazione delle intestazioni di diagnostica con Identity site:Redmond. In questo esempio il valore della proprietà SendToOutsideUnauthenticatedUsers è impostato su True.

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

Get-CsDiagnosticHeaderConfiguration | Set-CsDiagnosticHeaderConfiguration -SendToOutsideUnauthenticatedUsers $True

Il comando mostrato nell'esempio 2 è una variante del comando utilizzato nell'esempio 1. In questo caso, la proprietà SendToOutsideUnauthenticatedUsers viene tuttavia modificata per tutte le impostazioni di configurazione delle intestazioni di diagnostica in uso. Per ottenere tale risultato, viene innanzitutto richiamato Get-CsDiagnosticHeaderConfiguration senza alcun parametro per restituire una raccolta di tutte le impostazioni delle intestazioni di diagnostica in uso. Questa raccolta viene quindi inviata tramite pipe a Set-CsDiagnosticHeaderConfiguration, che imposta su True la proprietà SendToOutsideUnauthenticatedUsers di ciascun elemento presente nella raccolta.

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

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

Nell'esempio 3 la proprietà SendToOutsideUnauthenticatedUsers viene di nuovo modificata, ma soltanto per le impostazioni delle intestazioni di diagnostica in cui la proprietà SendToExternalNetworks è True. Per ottenere tale risultato, con il comando viene utilizzato innanzitutto Get-CsDiagnosticHeaderConfiguration per restituire una raccolta di tutte le impostazioni di configurazione delle intestazioni di diagnostica attualmente in uso. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona soltanto le impostazioni in cui la proprietà SendToExternalNetworks è uguale a True. La raccolta filtrata viene quindi inviata tramite pipe a Set-CsDiagnosticHeaderConfiguration, che imposta su True il valore della proprietà SendToOutsideUnauthenticatedUsers per ciascun elemento presente nella raccolta.