Condividi tramite

  • Articolo

New-CsDiagnosticHeaderConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Crea una nuova raccolta di impostazioni di configurazione per l'intestazione di diagnostica. Le impostazioni di configurazione delle intestazioni di diagnostica determinano se i messaggi SIP vengono accompagnati da informazioni di intestazione che possono essere utili nella risoluzione dei problemi e nella segnalazione di errori.

Sintassi

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

Descrizione dettagliata

Gli amministratori hanno la possibilità di allegare un'intestazione ms-diagnostic a ciascun messaggio SIP inviato in un'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, l'intestazione di diagnostica potrebbe contenere codici di errore che consentono all'applicazione client (ad esempio 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, le intestazioni di diagnostica contengono inoltre informazioni, quali i nomi di dominio completi (FQDN) dei server SIP, che si potrebbe non voler rendere disponibili alle persone esterne alla rete interna. Per questo motivo, le impostazioni di configurazione delle intestazioni di diagnostica consentono di decidere se si desidera inviare le intestazioni agli utenti di reti esterne (ad esempio gli utenti in un dominio federato) e/o a utenti esterni. Gli utenti esterni sono quelli connessi dall'esterno della rete aziendale e che non sono ancora stati autenticati.

Per impostazione predefinita, le intestazioni di diagnostica 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.

Le impostazioni personalizzate dell'intestazione di diagnostica vengono create tramite il cmdlet New-CsDiagnosticHeaderConfiguration. Come osservato, è possibile creare le nuove impostazioni nell'ambito del sito o del servizio (ma solo per il Edge Server e il servizio di registrazione). Occorre ricordare che è possibile disporre di una sola raccolta di tali impostazioni per sito o servizio. Ad esempio, si supponga di voler creare una nuova raccolta per il sito Redmond e che tale sito ospiti già una raccolta di impostazioni dell'intestazione di diagnostica. In tal caso, il comando avrà esito negativo. Analogamente, il comando avrà esito negativo se si tenta di creare una nuova raccolta con ambito globale.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsDiagnosticHeaderConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco per le impostazioni di configurazione dell'intestazione di diagnostica da creare. Per creare una nuova raccolta di impostazioni nell'ambito del sito, utilizzare una sintassi simile a quella riportata di seguito: -Identity "site:Redmond". Per creare una nuova raccolta di impostazioni nell'ambito del servizio, utilizzare la sintassi riportata di seguito: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com".

Non è possibile creare nuove impostazioni nell'ambito globale. Inoltre, non è possibile creare nuove impostazioni nell'ambito del sito o del servizio se il sito o il servizio specificato (ad esempio site:Redmond) ospita già una raccolta di impostazioni.

SendToExternalNetworks

Facoltativo

Booleano

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

SendToOutsideUnauthenticatedUsers

Facoltativo

Booleano

Se impostato su True, le intestazioni di diagnostica verranno allegate ai messaggi inviati a utenti esterni. Gli utenti esterni sono quelli connessi dall'esterno della rete aziendale (ad esempio attraverso un server proxy) e che non sono ancora stati autenticati.

Il valore predefinito è False.

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-CsDiagnosticHeaderConfiguration non accetta l'input da pipeline.

Tipi restituiti

New-CsDiagnosticHeaderConfiguration consente di creare nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Esempio

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

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

Con l'esempio 1 viene creata una nuova configurazione dell'intestazione di diagnostica per il sito Redmond (-Identity site:Redmond). Oltre a specificare l'identità, il comando utilizza il parametro SendToOutsideAuthenticatedUsers e il valore di parametro $True per consentire l'invio di informazioni agli utenti autenticati esterni alla rete interna.

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

$x = New-CsDiagnosticHeaderConfiguration -Identity site:Redmond
$x.SendToOutsideUnauthenticatedUsers = $True
$x.SendToExternalNetworks = $True
Set-CsDiagnosticHeaderConfiguration -Instance $x

Con i comandi mostrati nell'esempio 2 viene dimostrato come creare una raccolta di impostazioni dell'intestazione di diagnostica inizialmente esistente solo in memoria. A tal fine, il primo comando nell'esempio chiama New-CsDiagnosticHeaderConfiguration con il parametro Identity. L'oggetto risultante viene archiviato nella variabile $x.

Dopo aver creato le impostazioni virtuali, i comandi 2 e 3 consentono di modificare i valori delle proprietà SendToOutsideUnauthenticatedUsers e SendToExternalNetworks. Infine, il comando 4 consente di trasformare le impostazioni di configurazione dell'intestazione di diagnostica virtuali in una raccolta effettiva di impostazioni applicate al sito Redmond. Questo comando finale è obbligatorio. Se non viene chiamato Set-CsDiagnosticHeaderConfiguration, le impostazioni non saranno applicate al sito e le impostazioni virtuali scompariranno al termine della sessione di Windows PowerShell o a seguito dell'eliminazione della variabile $x.